Déployer un VPC avec Terraform
Vous pouvez déployer un réseau cloud privé virtuel (VPC) à l'aide d'Infrastructure Manager et de la consoleGoogle Cloud . Ce guide de démarrage rapide s'adresse aux administrateurs cloud, aux ingénieurs de plate-forme et aux développeurs qui souhaitent gérer l'infrastructure Google Cloud en tant que code. Un réseau VPC fournit une mise en réseau isolée pour les ressources telles que les instances de machines virtuelles (VM), les bases de données et les applications.
Avec Infra Manager, vous définissez le réseau dans une configuration Terraform au lieu de le créer manuellement. Infra Manager exécute Terraform pour vous et stocke l'état Terraform. Vous pouvez ainsi reproduire, mettre à jour et supprimer votre infrastructure de manière cohérente. Pour en savoir plus, consultez Présentation de Terraform sur Google Cloud.
Dans ce guide de démarrage rapide, vous allez prévisualiser et créer un déploiement à partir d'une configuration Terraform dans un dépôt GitHub public.
Avant de commencer
-
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.
-
If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Infrastructure Manager and Compute Engine APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
Rôles requis
Pour obtenir les autorisations nécessaires pour suivre ce guide de démarrage rapide, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :
- Administrateur Cloud Infrastructure Manager (
roles/config.admin) - Administrateur de compte de service (
roles/iam.serviceAccountAdmin) -
Utilisateur du compte de service (
roles/iam.serviceAccountUser) - Administrateur de projet IAM (
roles/resourcemanager.projectIamAdmin) - Lecteur de réseau Compute (
roles/compute.networkViewer) - Lecteur Cloud Build (
roles/cloudbuild.builds.viewer) - Lecteur des objets Storage (
roles/storage.objectViewer)
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
Prévisualiser et créer un déploiement
Lorsque vous créez un déploiement, Infra Manager provisionne les ressources définies dans la configuration Terraform. Avant de créer le déploiement, vous créez un aperçu pour vérifier les ressources qu'Infra Manager prévoit de provisionner.
Pour prévisualiser et créer un déploiement qui provisionne un réseau VPC, procédez comme suit :
Dans la console Google Cloud , accédez à la page Infrastructure Manager.
Cliquez sur Créer un déploiement.
Sur la page Créer un déploiement Terraform, dans la section Détails du déploiement, saisissez les valeurs suivantes :
- ID de déploiement :
quickstart-preview - Région :
us-central1 - Version de Terraform :
1.5.7 Compte de service : créez un compte de service nommé
im-quickstart-sa. Pour créer le compte de service et lui attribuer les rôles requis, procédez comme suit :- Dans la liste Compte de service, cliquez sur Nouveau compte de service. La page Créer un compte de service s'ouvre dans un nouvel onglet.
- Dans le champ Nom du compte de service, saisissez
im-quickstart-sa, puis cliquez sur Créer et continuer. Dans la section Autoriser ce compte de service à accéder au projet, utilisez la liste Sélectionner un rôle pour accorder les rôles suivants. Pour ajouter le deuxième rôle, cliquez sur Ajouter un autre rôle.
- Agent Cloud Infrastructure Manager (
roles/config.agent) : permet à Infrastructure Manager d'exécuter Terraform et de stocker l'état et les journaux du déploiement. - Administrateur de réseaux Compute (
roles/compute.networkAdmin) : permet à Infra Manager de créer et de gérer le réseau VPC.
Pour en savoir plus sur les rôles Infra Manager, consultez Contrôle des accès avec IAM.
- Agent Cloud Infrastructure Manager (
Cliquez sur Continue (Continuer), puis sur Done (OK).
Fermez l'onglet et revenez à la page Créer un déploiement Terraform.
Dans la liste Compte de service, cliquez sur Actualiser la liste, puis sélectionnez
im-quickstart-sa.
Source de la configuration Terraform : Git
Dépôt Git :
https://github.com/terraform-google-modules/terraform-google-networkRépertoire Git :
modules/vpc
- ID de déploiement :
Cliquez sur Continuer.
Dans la section Détails Terraform, sous Valeurs d'entrée, saisissez les valeurs suivantes pour les variables de module préremplies :
- Sur la ligne de la clé
project_id, dans le champ Valeur, saisissez<var>PROJECT_ID</var>. N'incluez pas de guillemets. - Sur la ligne de la clé
network_name, dans le champ Valeur, saisissezquickstart-vpc. N'incluez pas de guillemets.
Remplacez PROJECT_ID par l'ID du projet Google Cloud .
- Sur la ligne de la clé
Cliquez sur Créer un aperçu.
Sur la page d'informations de l'aperçu
quickstart-preview-<var>UUID</var>, vérifiez que la valeur de la ligne État est Réussite.Pour créer un déploiement qui utilise les valeurs de l'aperçu, cliquez sur Créer un déploiement.
Dans le champ ID du déploiement, saisissez
quickstart-deployment.Cliquez sur Créer un déploiement.
Infra Manager provisionne le réseau VPC. Une fois le déploiement terminé, vous recevez une notification dans la console Google Cloud .
Vous avez créé un déploiement à l'aide d'Infra Manager. Dans les sections suivantes, vous allez vérifier le déploiement, afficher le réseau provisionné et examiner le job Cloud Build qui a exécuté Terraform.
Afficher l'état du déploiement
Une fois qu'Infra Manager a créé le déploiement, vous pouvez afficher des détails le concernant, tels que son état, sa dernière révision et la source de sa configuration Terraform.
Pour afficher les détails du déploiement, procédez comme suit :
Dans la console Google Cloud , accédez à la page Infrastructure Manager.
Dans la colonne ID, cliquez sur
quickstart-deployment.Sur la page d'informations sur le déploiement, vérifiez que la valeur de la ligne État est Actif.
Afficher le réseau VPC provisionné
Pour vérifier qu'Infra Manager a provisionné le réseau défini par la configuration Terraform, affichez le réseau dans la console Google Cloud :
Dans la console Google Cloud , accédez à la page Réseaux VPC.
La liste des réseaux inclut
quickstart-vpc, qui est le réseau provisionné par Infra Manager. La liste affiche des détails sur le réseau, tels que son mode de création de sous-réseau, son unité de transmission maximale (MTU) et son mode de routage dynamique.Pour afficher plus de détails sur le réseau, tels que ses sous-réseaux, ses règles de pare-feu et ses routes, cliquez sur
quickstart-vpc.
Afficher les résultats de compilation dans Cloud Build
Infra Manager utilise Cloud Build pour exécuter Terraform pour chaque révision de déploiement. Pour inspecter les commandes Terraform qui ont créé votre déploiement ou pour résoudre un problème de déploiement, consultez les journaux de compilation Cloud Build :
Dans la console Google Cloud , accédez à la page Historique de compilation.
Dans la table des builds, recherchez le build le plus récent avec la région
us-central1. Les builds de l'aperçuquickstart-preview-<var>UUID</var>et du déploiementquickstart-deploymentapparaissent dans cette liste.Cliquez sur l'ID de compilation pour ouvrir la page Informations sur la compilation.
La page Informations sur le build affiche l'état de chaque étape du build et le journal du build, qui inclut la sortie des commandes Terraform. Si un déploiement échoue, utilisez le journal de compilation pour en identifier la cause. Pour en savoir plus, consultez Résoudre les erreurs de déploiement.
Vous pouvez également ouvrir la compilation d'un déploiement à partir de la page d'informations du déploiement dans Infra Manager en cliquant sur le lien Journaux Cloud Build.
Effectuer un nettoyage
Pour éviter que les ressources utilisées dans ce guide de démarrage rapide ne soient facturées sur votre compte Google Cloud , supprimez le déploiement lorsque vous n'en avez plus besoin. Les aperçus de déploiement n'entraînent aucuns frais sur votre compte Google Cloud . Si vous souhaitez supprimer l'aperçu, consultez la section Supprimer des aperçus.
Supprimer le déploiement
Supprimez le déploiement et le réseau VPC provisionné :
Pour supprimer le déploiement, procédez comme suit :
Dans la console Google Cloud , accédez à la page Infrastructure Manager.
Dans la colonne ID, cliquez sur
quickstart-deployment.Sur la page d'informations du déploiement, cliquez sur Supprimer.
Dans la boîte de dialogue de confirmation, saisissez
quickstart-deployment, puis cliquez sur Confirmer.
Supprimer le compte de service
Une fois qu'Infra Manager a supprimé le déploiement, supprimez le compte de service im-quickstart-sa afin qu'il ne conserve pas ses rôles dans votre projet :
Dans la console Google Cloud , accédez à la page Comptes de service.
Cochez la case correspondant à
im-quickstart-sa, puis cliquez sur Supprimer.Dans la boîte de dialogue, cliquez sur Supprimer.
(Facultatif) Supprimez le projet.
Si vous avez créé le déploiement dans un nouveau projet Google Cloud et que vous n'en avez plus besoin, supprimez-le.
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.
Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter.
Étapes suivantes
- Découvrez le fonctionnement d'Infra Manager.
- En savoir plus sur Terraform et Infra Manager
- Mettre à jour un déploiement
- Automatiser les déploiements.
- Pour obtenir un ensemble de configurations et de modules prêts à être utilisés avecGoogle Cloud, consultez Plans et modules Terraform pour Google Cloud dans la documentation Terraform sur Google Cloud .