Configurer des projets et des ressources locataires

Preview

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités de pré-DG sont proposés "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 SaaS Runtime pour organiser vos 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 et un dépôt Artifact Registry, puis créez un artefact contenant votre application SaaS dans votre projet de producteur. Pour savoir comment configurer une offre SaaS, consultez Déployer une instance de service avec l'environnement d'exécution SaaS.

2. Activez les API requises par SaaS Runtime.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

3. Vérifiez que vous disposez des comptes de service et des rôles Identity and Access Management 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] sur le projet producteur.

Configurer un projet locataire

Lorsque vous provisionnez les ressources de votre locataire dans des projets distincts, vos ressources, vos règles 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 chez un locataire affectent les autres.

Vous aurez besoin des documents suivants :

• un projet de producteur ;

• un projet locataire pour chacun de vos locataires.

Console

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

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

3. Activez les API requises par SaaS Runtime dans vos projets de locataire.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

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

   Pour en savoir plus, consultez Comptes de service de l'environnement d'exécution SaaS.

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

gcloud

Pour configurer des projets de producteur et de locataire à l'aide de Google Cloud CLI :

1. Créez votre projet de 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 : chaîne d'identifiant représentant l'ID du projet du producteur.
   • TENANT_PROJECT_ID : chaîne d'identifiant représentant l'ID du projet locataire.

2. Activez la facturation pour vos projets locataire et producteur :

    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 : chaîne d'identifiant représentant l'ID du projet du producteur.
   • TENANT_PROJECT_ID : chaîne d'identifiant 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. Attribuez au compte de service d'actionnement les rôles Identity and Access Management nécessaires pour chaque projet de 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 : chaîne d'identifiant représentant l'ID du projet locataire.
   • PRODUCER_PROJECT_ID : chaîne d'identifiant représentant l'ID du projet du producteur.
   • SERVICE_ACCOUNT : compte de service auquel vous souhaitez attribuer des rôles dans le projet spécifié.

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

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

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

Créer une ressource de locataire

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

1. Dans la console Google Cloud , accédez à SaaS Runtime > Tenants.

   Accéder à la page "Locataires"

2. Cliquez sur Créer.

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

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

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

6. Dans le menu déroulant Région, sélectionnez la région dans laquelle les métadonnées du locataire seront stockées.

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

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

Vous avez créé une ressource de 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 l'environnement d'exécution SaaS.

Pour associer une unité à un locataire :

1. Dans la console Google Cloud , accédez à SaaS Runtime > Tenants.

   Accéder à la page "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 à 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. Dans la console Google Cloud , accédez à SaaS Runtime > Unités.

   Accéder aux unités

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

3. Cliquez sur Provisionner.

4. Sélectionnez Release (Version) pour provisionner l'unité de votre locataire.

5. Sélectionnez le compte de service d'actionnement auquel vous avez accordé des autorisations dans votre projet de 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 listée telle que vous l'avez définie dans votre fichier de configuration Terraform variables.tf.
   2. Dans la zone 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.

L'environnement d'exécution SaaS 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 provisionnez à nouveau une unité existante avec une nouvelle version, vous devez fournir la variable tenant_project_id.

1. Dans la console Google Cloud , accédez à SaaS Runtime > Unités.

   Accéder aux unités

2. Sélectionnez l'unité associée à votre genre 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'actionnement auquel vous avez accordé des autorisations dans votre projet de 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 listée telle que vous l'avez définie dans votre fichier de configuration Terraform variables.tf.
   2. Dans la zone 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.

L'environnement d'exécution SaaS 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.

Étapes suivantes

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