Associer des unités à des locataires

Associer des unités à des locataires

Dans ce guide de démarrage rapide, vous allez modifier votre offre SaaS pour associer l'unité de VM déployée à une ressource de locataire et provisionner la VM dans un projet locataire dédié appartenant à votre locataire.

Cette approche améliore l'isolation des ressources, ce qui vous permet de gérer les ressources de chaque locataire séparément et d'offrir une meilleure sécurité et conformité pour votre offre SaaS.

Nous allons nous appuyer sur le scénario du guide de démarrage rapide Déployer une VM avec App Lifecycle Manager, en le modifiant pour associer l'unité de VM déployée à une ressource de locataire et provisionner la VM dans un projet dédié appartenant au locataire :

1. Créez une ressource de locataire dans App Lifecycle Manager.
2. Associez une VM à la ressource de locataire.
3. Configurez App Lifecycle Manager et votre configuration Terraform pour déployer des ressources dans un projet locataire distinct.
4. Résolvez les problèmes courants d'autorisation et d'activation d'API lors du déploiement inter-projets.

À la fin de ce guide de démarrage rapide, vous aurez créé les bases d'une offre SaaS avec plusieurs locataires qui vous permet de définir des configurations et des stratégies au niveau du locataire en créant des locataires et en les associant à des unités.

Avant de commencer

Avant de créer des locataires ou de les associer à des unités, vous devez connaître les principes de base de l'écosystème App Lifecycle Manager et créer une offre SaaS.

1. Connectez-vous à votre Google Cloud compte. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

   In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

   Verify that billing is enabled for your Google Cloud project.

   In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

   Verify that billing is enabled for your Google Cloud project.

2. Déployez une VM avec App Lifecycle Manager, y compris la création d'une configuration Terraform, d'un dépôt Artifact Registry, d'une offre SaaS, d'un type d'unité, d'une unité et de composants (y compris terraform-files.zip).

   • Vérifiez que les API listées dans la section Avant de commencer du guide de démarrage rapide sont activées dans votre projet producteur.
   • Vérifiez que vous disposez des comptes de service et des rôles IAM nécessaires dans le projet producteur. Cela inclut le compte de service créé par l'utilisateur et les autorisations accordées au compte [e-mail] dans le projet producteur.

3. Votre projet producteur et tous les projets locataires doivent être créés avant que vous ne créiez et n'associiez vos ressources de locataire. Pour en savoir plus, consultez Configurer un projet locataire.

Créer et associer une ressource de locataire

Vous pouvez utiliser des locataires pour regrouper des ressources d'unité. Créez une ressource locataire dans l'offre SaaS de votre projet producteur pour représenter votre client :

1. Dans la Google Cloud console, accédez à App Lifecycle Manager > Locataires.

   Accéder à la page "Locataires"

2. Cliquez sur Créer.

3. Sur la page Créer un locataire, saisissez vm-quickstart-tenant dans le champ Nom du locataire.

4. Dans le champ Offre SaaS, sélectionnez vm-quickstart-saas-offering.

5. Dans la liste déroulante Région, sélectionnez us-central1.

6. Cliquez sur Ajouter une unité. Une section Nouvelle unité s'affiche.

7. Dans la liste déroulante Unité, sélectionnez l'unité projects/YOUR-PROJECT-NAME/locations/us-central1/units/vm-quickstart-unit.

8. Cliquez sur OK pour associer votre ressource vm-quickstart-unit à votre ressource vm-quickstart-tenant.

9. Cliquez sur Créer pour créer votre ressource de locataire. Vous avez créé la ressource vm-quickstart-tenant et l'avez associée à la ressource vm-quickstart-unit. Cette association sert principalement de tag d'organisation dans la Google Cloud console, ce qui vous permet d'identifier les unités appartenant à chaque locataire.

Créer une version de locataire

1. Dans la Google Cloud console, accédez à App Lifecycle Manager > Versions.

   Accéder à la page "Versions"

2. Sur la page Versions, cliquez sur Créer.

3. Sur la page Créer une version, saisissez vm-quickstart-tenant-release dans le champ Nom de la version.

4. Dans le champ Type d'unité, sélectionnez vm-quickstart-unit-kind. Cliquez sur Next (Suivant).

5. À l'étape Sélectionner un blueprint, cliquez sur le bouton Sélectionner une image existante dans Artifact Registry.

6. À l'étape Stocker le blueprint, cliquez sur Parcourir et sélectionnez l'artefact associé à vm-quickstart-tenant-blueprint. Cliquez sur Next (Suivant).

7. Cliquez sur Créer. Vous avez créé la ressource vm-quickstart-tenant-release.

Créer un projet locataire et déployer une unité

Dans le guide de démarrage rapide Déployer une VM avec App Lifecycle Manager, vous provisionnez des ressources App Lifecycle Manager dans le même projet que celui qui contient la configuration de votre offre SaaS.

Dans ce guide de démarrage rapide, vous dirigez le provisionnement des ressources vers le projet locataire au lieu du projet producteur.

Vous devrez transmettre des variables modifiées tenant_project_id et tenant_project_number lors du provisionnement de l'unité.

1. Créez un projet locataire dans lequel vous allez déployer les fichiers terraform-vm.zip :

   gcloud projects create quickstart-tenant-project --name="SaaS Tenant A Project"
   

2. Activez les API et accordez des rôles IAM sur le projet locataire. Pour déployer des unités dans votre projet locataire, vous devez activer l'API Compute Engine et accorder des rôles IAM sur votre projet locataire.

Activer les API dans votre projet locataire

Activez l'API Compute Engine dans le projet locataire à l'aide de la Google Cloud console :

1. Accédez au sélecteur de projet.

   Accéder au sélecteur de projet

2. Cliquez sur Sélectionner un projet.

3. Sélectionnez quickstart-tenant-project.

4. Activez l'API Compute Engine.

   Rôles requis pour activer les API

   Pour activer les API, vous avez besoin du rôle IAM Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

   Activer l'API

5. Assurez-vous de disposer des rôles suivants sur le projet : roles/compute.admin

   Vérifier les rôles

   1. Dans la Google Cloud console, accédez à la page IAM.

      Accéder à IAM
   2. Sélectionnez le projet.

   3. Dans la colonne Compte principal, recherchez toutes les lignes qui vous identifient ou identifient un groupe dont vous faites partie. Pour savoir à quels groupes vous appartenez, contactez votre administrateur.

   4. Pour toutes les lignes qui vous spécifient ou vous incluent, consultez la colonne Rôle pour vous assurer que la liste inclut les rôles requis.

   Attribuer les rôles

   1. Dans la Google Cloud console, accédez à la page IAM.

      Accéder à IAM
   2. Sélectionnez le projet.
   3. Cliquez sur Accorder l'accès.

   4. Dans le champ Nouveaux comptes principaux, saisissez votre identifiant utilisateur. Il s'agit généralement de l'adresse e-mail d'un compte Google.

   5. Cliquez sur Sélectionner un rôle, puis recherchez le rôle.
   6. Pour attribuer des rôles supplémentaires, cliquez sur Ajouter un autre rôle et ajoutez tous les rôles supplémentaires.
   7. Cliquez sur Enregistrer.

Provisionner une unité avec des variables de projet locataire

À partir de votre projet producteur, provisionnez une nouvelle unité avec les variables d'entrée de votre projet locataire :

1. Accédez au sélecteur de projet.

   Accéder au sélecteur de projet

2. Cliquez sur Sélectionner un projet.

3. Sélectionnez votre projet producteur.

4. Dans la Google Cloud console, accédez à App Lifecycle Manager > Unités.

   Accéder à la page "Unités"

5. Sélectionnez la ressource vm-quickstart-unit.

6. Cliquez sur Provisionner.

7. Sélectionnez la ressource vm-quickstart-tenant-release.

8. Sélectionnez le compte de service d'activation auquel vous avez accordé des autorisations dans le projet locataire.

9. Dans la section Variables d'entrée :

   • La variable tenant_project_id est listée telle que vous l'avez définie dans variables.tf.
   • Dans le champ ID du projet locataire, saisissez quickstart-tenant-project.

10. Cliquez sur Provisionner.

App Lifecycle Manager déclenche Infrastructure Manager à l'aide du compte de service d'activation spécifié. Infrastructure Manager lit la variable tenant_project_id et crée la VM dans ce projet locataire.

Remarque : Si le provisionnement échoue, vérifiez que les API requises sont activées et que vos autorisations sont correctement configurées.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre Google Cloud compte pour les ressources utilisées sur cette page, procédez comme suit :

Attention : Si vous supprimez un projet, toutes ses ressources sont définitivement supprimées. Ne supprimez les projets de démarrage rapide que si vous avez déployé votre offre SaaS dans un nouveau Google Cloud projet et que vous n'avez plus besoin du projet ni de ses ressources.

1. Dans la Google Cloud console, accédez à la page Gérer les ressources.

   Accéder à la page "Gérer les ressources"

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Lorsque vous y êtes invité, saisissez l'ID du projet, puis cliquez sur Arrêter.

Étape suivante

• Découvrez comment configurer des projets et des ressources de locataire.
• Utilisez des variables et le mappage de variables pour une orchestration sophistiquée des offres SaaS (y compris le provisionnement automatisé des ressources provisioning).