Configurer des projets et des ressources locataires

Aperçu

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres pré-DG" de la section "Conditions d'utilisation générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce guide explique comment utiliser les locataires App Lifecycle Manager pour organiser les unités déployées et comment déployer des ressources dans des projets locataires distincts afin d'isoler et de gérer vos ressources.

Pour obtenir une présentation des locataires et des projets locataires, consultez Locataires et projets locataires.

Avant de commencer

Avant de créer des projets ou des ressources locataires :

1. Créez une configuration Terraform, un dépôt Artifact Registry et un artefact contenant votre application SaaS dans votre projet producteur. Consultez Déployer une instance de service avec App Lifecycle Manager pour découvrir comment configurer une offre SaaS.

2. Activez les API requises par App Lifecycle Manager.

   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 les API

3. Vérifiez que les comptes de service et les rôles Identity and Access Management nécessaires sont accordés 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.

Configurer un projet locataire

Lorsque vous provisionnez les ressources de votre locataire dans des projets distincts, vos ressources, vos stratégies IAM, vos quotas et vos configurations réseau sont séparés pour chacun de vos locataires. Il est donc moins probable que des failles ou des erreurs de configuration affectent vos autres locataires.

Vous aurez besoin des éléments suivants :

• un projet producteur ;

• un projet locataire pour chacun de vos locataires.

Console

Pour configurer des projets locataires et producteurs à l'aide de la Google Cloud console :

1. Créez un projet producteur et un projet locataire pour chacun de vos locataires.
2. Activez la facturation dans vos projets locataires et producteurs.

3. Activez les API requises par App Lifecycle Manager dans vos projets locataires.

   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 les API

4. Vérifiez que vos projets locataires disposent de comptes de service d'activation avec les autorisations requises.

   Pour en savoir plus, consultez Comptes de service App Lifecycle Manager.

Vous avez bien configuré vos projets locataires et producteurs. Une fois que vous avez créé et activé la facturation pour vos projets producteurs et locataires, vous pouvez créer des ressources locataires et associer des unités à des locataires.

gcloud

Pour configurer des projets producteurs et locataires à l'aide de Google Cloud CLI :

1. Créez votre projet producteur et un projet locataire pour chacun de vos locataires :

   gcloud projects create PRODUCER_PROJECT_ID --name="SaaS producer project" [--folder=folder-id]
   gcloud projects create TENANT_PROJECT_ID --name="SaaS tenant A project" [--folder=folder-id]
   

   Remplacez :

   • PRODUCER_PROJECT_ID: identifiant de chaîne représentant l'ID du projet producteur.
   • TENANT_PROJECT_ID : identifiant de chaîne représentant l'ID du projet locataire.

2. Activez la facturation pour vos projets locataires et producteurs :

    gcloud beta billing projects link PRODUCER_PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
    gcloud beta billing projects link TENANT_PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
   

   Remplacez :

   • PRODUCER_PROJECT_ID: identifiant de chaîne représentant l'ID du projet producteur.
   • TENANT_PROJECT_ID : identifiant de chaîne représentant l'ID du projet locataire.
   • BILLING_ACCOUNT_ID: ID du compte de facturation que vous souhaitez associer au projet spécifié.
   Remarque : Vous devez associer chaque projet locataire à une commande gcloud beta billing projects link.

3. Accordez au compte de service d'activation les rôles Identity and Access Management nécessaires pour chaque projet locataire :

    gcloud projects add-iam-policy-binding TENANT_PROJECT_ID \
    --member='serviceAccount:SERVICE_ACCOUNT@PRODUCER_PROJECT_ID.iam.gserviceaccount.com' \
    --role=ROLE
   

   Remplacez :

   • TENANT_PROJECT_ID : identifiant de chaîne représentant l'ID du projet locataire.
   • PRODUCER_PROJECT_ID: identifiant de chaîne représentant l'ID du projet producteur.
   • SERVICE_ACCOUNT: compte de service auquel vous souhaitez accorder des rôles dans le projet spécifié.

   • ROLE : rôle Identity and Access Management à accorder.

     Vous devez exécuter gcloud projects add-iam-policy-binding pour chaque rôle que vous souhaitez accorder au compte de service spécifié (--role='roles/compute.admin', par exemple).

Vous avez bien configuré vos projets locataires et producteurs. Une fois que vous avez créé et activé la facturation pour vos projets producteurs et locataires, vous pouvez créer des ressources locataires et associer des unités à des locataires.

Créer une ressource locataire

Créez une ressource locataire dans votre offre SaaS pour représenter votre client :

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

   Accéder aux locataires

2. Cliquez sur Créer.

3. Dans le champ Nom du locataire, saisissez un nom pour votre ressource locataire.

4. Facultatif : Dans le champ Ressource client, fournissez une ressource consommateur avec des paramètres définis par le consommateur pour l'intégration.

5. Dans le champ Offre SaaS, sélectionnez l'offre SaaS à laquelle vous souhaitez associer votre locataire.

6. Dans la liste déroulante Région, sélectionnez une région dans laquelle les métadonnées du locataire seront stockées.

7. Facultatif : Cliquez sur Ajouter une étiquette pour ajouter une étiquette de paire clé/valeur à votre locataire.

8. Cliquez sur Créer pour créer votre ressource locataire.

Vous avez bien créé une ressource locataire.

Associer une unité à un locataire

Une fois que vous avez créé un locataire et déployé une unité, vous pouvez les associer. Cette association sert principalement de tag organisationnel qui vous aide à organiser les unités appartenant à chaque locataire.

Pour en savoir plus sur le déploiement d'unités, consultez Déployer une VM avec App Lifecycle Manager.

Pour associer une unité à un locataire :

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

   Accéder aux locataires

2. Cliquez sur le nom du locataire que vous souhaitez associer à une unité.

3. Cliquez sur Modifier.

4. Dans la section Unités associées, cliquez sur Ajouter une unité.

5. Sélectionnez les unités que vous souhaitez associer à ce locataire.

6. Cliquez sur OK.

7. Cliquez sur Enregistrer.

Les unités sélectionnées sont associées au locataire indiqué.

Provisionner une nouvelle unité avec des variables de projet locataire

Lorsque vous provisionnez une unité associée à un locataire, vous devez fournir la variable tenant_project_id.

1. Accédez à App Lifecycle Manager > Unités dans la Google Cloud console.

   Accéder aux unités

2. Créez une unité associée à votre type d'unité.

3. Cliquez sur Provisionner.

4. Sélectionnez la version à provisionner pour votre unité locataire.

5. Sélectionnez le compte de service d'activation auquel vous avez accordé des autorisations dans votre projet locataire. Nous vous conseillons d'appliquer le principe du moindre privilège et de n'accorder que les rôles nécessaires pour les ressources gérées.

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

   1. Vérifiez que la variable tenant_project_id est répertoriée telle que vous l'avez définie dans votre fichier variables.tf de configuration Terraform.
   2. Dans le champ ID du projet locataire, indiquez le nom de votre projet locataire.
   3. Fournissez les variables d'entrée définies dans votre configuration Terraform. Si vous n'avez pas défini d'autres variables dans votre configuration Terraform, ignorez cette étape.

7. 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.

Reprovisionner une unité avec une nouvelle version

Lorsque vous reprovisionnez une unité existante avec une nouvelle version, vous devez fournir la variable tenant_project_id.

1. Accédez à App Lifecycle Manager > Unités dans la Google Cloud console.

   Accéder aux unités

2. Sélectionnez l'unité associée à votre type d'unité.

3. Cliquez sur Modifier le provisionnement.

4. Sélectionnez la version que vous avez créée avec la configuration Terraform mise à jour.

5. Sélectionnez le compte de service d'activation auquel vous avez accordé des autorisations dans votre projet locataire. Nous vous conseillons d'appliquer le principe du moindre privilège et de n'accorder que les rôles nécessaires pour les ressources gérées.

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

   1. Vérifiez que la variable tenant_project_id est répertoriée telle que vous l'avez définie dans votre fichier variables.tf de configuration Terraform.
   2. Dans le champ ID du projet locataire, indiquez le nom de votre projet locataire.
   3. Fournissez les variables d'entrée définies dans votre configuration Terraform. Si vous n'avez pas défini d'autres variables dans votre configuration Terraform, ignorez cette étape.

7. Cliquez sur Mettre à jour.

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.

Étape suivante

• Découvrez comment gérer les dépendances entre les unités.
• En savoir plus sur l'utilisation des variables et du mappage des variables.
• Consultez les autorisations requises pour les comptes de service.