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

  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

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

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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.enable permission. 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.

    Enable the APIs

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 :

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 :

  1. Dans la console Google Cloud , accédez à la page Infrastructure Manager.

    Accéder à Infrastructure Manager

  2. Cliquez sur Créer un déploiement.

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

      1. 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.
      2. Dans le champ Nom du compte de service, saisissez im-quickstart-sa, puis cliquez sur Créer et continuer.
      3. 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.

      4. Cliquez sur Continue (Continuer), puis sur Done (OK).

      5. Fermez l'onglet et revenez à la page Créer un déploiement Terraform.

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

    • Répertoire Git : modules/vpc

  4. Cliquez sur Continuer.

  5. 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, saisissez quickstart-vpc. N'incluez pas de guillemets.

    Remplacez PROJECT_ID par l'ID du projet Google Cloud .

  6. Cliquez sur Créer un aperçu.

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

  8. Pour créer un déploiement qui utilise les valeurs de l'aperçu, cliquez sur Créer un déploiement.

  9. Dans le champ ID du déploiement, saisissez quickstart-deployment.

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

  1. Dans la console Google Cloud , accédez à la page Infrastructure Manager.

    Accéder à Infrastructure Manager

  2. Dans la colonne ID, cliquez sur quickstart-deployment.

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

  1. Dans la console Google Cloud , accédez à la page Réseaux VPC.

    Accéder aux 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.

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

  1. Dans la console Google Cloud , accédez à la page Historique de compilation.

    Accéder à l'historique de compilation

  2. Dans la table des builds, recherchez le build le plus récent avec la région us-central1. Les builds de l'aperçu quickstart-preview-<var>UUID</var> et du déploiement quickstart-deployment apparaissent dans cette liste.

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

  1. Dans la console Google Cloud , accédez à la page Infrastructure Manager.

    Accéder à Infrastructure Manager

  2. Dans la colonne ID, cliquez sur quickstart-deployment.

  3. Sur la page d'informations du déploiement, cliquez sur Supprimer.

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

  1. Dans la console Google Cloud , accédez à la page Comptes de service.

    Accéder à la page "Comptes de service"

  2. Cochez la case correspondant à im-quickstart-sa, puis cliquez sur Supprimer.

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

  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. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter.

Étapes suivantes