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 de 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 sécurité et une conformité accrues pour votre offre SaaS.

Nous allons nous appuyer sur le scénario du guide de démarrage rapide "Déployer une instance MySQL 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 multiprojet.

À la fin de ce guide de démarrage rapide, vous aurez créé les bases d'une offre SaaS avec plusieurs locataires, qui vous permettra de définir des configurations et des règles 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. 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.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

  2. Déployer une instance MySQL avec App Lifecycle Manager, y compris créer une configuration Terraform, un dépôt Artifact Registry, une offre SaaS, un type d'unité, une unité et des 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 service-PROJECT-NUMBER@gcp-sa-saasservicemgmt. sur 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 locataires. 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 console Google Cloud , 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 la zone Offre SaaS, sélectionnez vm-quickstart-saas-offering.

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

  6. Cliquez sur Ajouter un bloc. La 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 consoleGoogle Cloud , ce qui vous aide à identifier les unités qui appartiennent à chaque locataire.

Créer une version de locataire

  1. Dans la console Google Cloud , accédez à App Lifecycle Manager > Releases (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 plan, cliquez sur le bouton Sélectionner une image existante dans Artifact Registry.

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

  7. Cliquez sur Créer. Vous avez bien 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 instance MySQL 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 allez provisionner les ressources dans le projet locataire au lieu du projet producteur.

Vous devrez transmettre des variables tenant_project_id et tenant_project_number modifiées 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 console Google Cloud  :

  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 si ce n'est pas déjà fait.

    Rôles requis pour activer les API

    Pour activer des API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). 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 console Google Cloud , 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 console Google Cloud , 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'identifiant associé à un utilisateur dans un pool d'identités de personnel. Pour en savoir plus, consultez Représenter les utilisateurs de pools de personnel dans les stratégies IAM ou contactez votre administrateur.

    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. Accédez à App Lifecycle Manager > Unités dans la console Google Cloud .

    Accéder à la page "Unités"

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

  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.

Effectuer un nettoyage

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

  1. Dans la console Google Cloud , 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.

Étapes suivantes