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 :
- Créez une ressource de locataire dans App Lifecycle Manager.
- Associez une VM à la ressource de locataire.
- Configurez App Lifecycle Manager et votre configuration Terraform pour déployer des ressources dans un projet locataire distinct.
- 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.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
Verify that billing is enabled for your Google Cloud project.
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.
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 :
Dans la console Google Cloud , accédez à App Lifecycle Manager > Locataires.
Cliquez sur Créer.
Sur la page Créer un locataire, saisissez
vm-quickstart-tenantdans le champ Nom du locataire.Dans la zone Offre SaaS, sélectionnez
vm-quickstart-saas-offering.Dans la liste déroulante Région, sélectionnez
us-central1.Cliquez sur Ajouter un bloc. La section Nouvelle unité s'affiche.
Dans la liste déroulante Unité, sélectionnez l'unité
projects/YOUR-PROJECT-NAME/locations/us-central1/units/vm-quickstart-unit.Cliquez sur OK pour associer votre ressource
vm-quickstart-unità votre ressourcevm-quickstart-tenant.Cliquez sur Créer pour créer votre ressource de locataire. Vous avez créé la ressource
vm-quickstart-tenantet l'avez associée à la ressourcevm-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
Dans la console Google Cloud , accédez à App Lifecycle Manager > Releases (Versions).
Sur la page Versions, cliquez sur Créer.
Sur la page Créer une version, saisissez
vm-quickstart-tenant-releasedans le champ Nom de la version.Dans le champ Type d'unité, sélectionnez
vm-quickstart-unit-kind. Cliquez sur Next (Suivant).À l'étape Sélectionner un plan, cliquez sur le bouton Sélectionner une image existante dans Artifact Registry.
À l'étape Stocker le plan, cliquez sur Parcourir et sélectionnez l'artefact associé à
vm-quickstart-tenant-blueprint. Cliquez sur Suivant.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é.
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"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 :
Accédez au sélecteur de projet.
Cliquez sur Sélectionner un projet.
Sélectionnez
quickstart-tenant-project.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.Assurez-vous de disposer des rôles suivants sur le projet : roles/compute.admin
Vérifier les rôles
-
Dans la console Google Cloud , accédez à la page IAM.
Accéder à IAM - Sélectionnez le projet.
-
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.
- 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
-
Dans la console Google Cloud , accédez à la page IAM.
Accéder à IAM - Sélectionnez le projet.
- Cliquez sur Accorder l'accès.
-
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.
- Cliquez sur Sélectionner un rôle, puis recherchez le rôle.
- Pour attribuer des rôles supplémentaires, cliquez sur Ajouter un autre rôle et ajoutez tous les rôles supplémentaires.
- 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 :
Accédez au sélecteur de projet.
Cliquez sur Sélectionner un projet.
Sélectionnez votre projet producteur.
Accédez à App Lifecycle Manager > Unités dans la console Google Cloud .
Sélectionnez
vm-quickstart-unitressource.Cliquez sur Provisionner.
Sélectionnez la ressource
vm-quickstart-tenant-release.Sélectionnez le compte de service d'activation auquel vous avez accordé des autorisations dans le projet locataire.
Dans la section Variables d'entrée :
- La variable
tenant_project_idest listée telle que vous l'avez définie dansvariables.tf. - Dans le champ ID du projet locataire, saisissez
quickstart-tenant-project.
- La variable
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 :
- Dans la console Google Cloud , accédez à la page Gérer les ressources.
- Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
- Lorsque vous y êtes invité, saisissez l'ID du projet, puis cliquez sur Arrêter.
Étapes suivantes
- Découvrez comment configurer des projets et des ressources locataires.
- Utilisez des variables et le mappage de variables pour orchestrer des offres SaaS sophistiquées (y compris le provisionnement automatisé des ressources).