Créer et exécuter un build dans un pool privé

Cette page explique comment créer un pool privé Cloud Build connecté au réseau de producteur de services, et exécuter une compilation dans le pool privé.

Le réseau du producteur de services est le réseau qui héberge le pool privé. Par défaut, un pool privé est configuré pour utiliser le réseau du producteur de services, qui fournit un environnement de compilation comprenant les éléments suivants :

  • Types de machines configurables
  • Tailles de disques configurables
  • Accès à des ressources sur l'Internet public, telles que des ressources dans un dépôt ou un registre

Pour obtenir des instructions détaillées sur cette tâche directement dans l' éditeur Cloud Shell, cliquez sur Visite guidée :

Visite guidée

Avant de commencer

  1. Connectez-vous à votre Google Cloud compte. Si vous n'avez jamais utilisé Google Cloud, créez un compte pour évaluer les performances de nos produits dans des scénarios réels. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

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

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

  4. Enable the Cloud Build API.

    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 API

  5. Installez la Google Cloud CLI.

  6. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  7. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    gcloud init

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

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

  10. Enable the Cloud Build API.

    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 API

  11. Installez la Google Cloud CLI.

  12. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  13. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    gcloud init

Créer un pool privé

  1. Dans la Google Cloud console, ouvrez l'onglet Pool de nœuds de calcul Cloud Build :

    Ouvrir l'onglet du pool de nœuds de calcul Cloud Build

  2. Cliquez sur Créer.

  3. Dans le panneau Créer un pool privé, saisissez les paramètres suivants :

    1. Dans le champ Nom, saisissez my-first-privatepool.

    2. Dans le champ Région, sélectionnez us-central1.

    3. Dans le champ Type de machine, sélectionnez e2-standard-2.

    4. Dans le champ Espace disque disponible, saisissez 800.

    5. Laissez le champ Numéro de projet du réseau vide.

    6. Laissez le champ Réseau vide.

    7. Assurez-vous que l'option Attribuer des adresses IP externes est sélectionnée.

Cliquez sur Créer pour créer le pool privé.

Patientez un court instant le temps que le pool privé soit créé. Une fois le pool privé créé, il est répertorié dans l'onglet Pool de nœuds de calcul.

Capture d'écran de la page "Pool privé"

Exécuter un build dans un pool privé

  1. Ouvrez une fenêtre de terminal.

  2. Créez un répertoire nommé quickstart-private-pool et accédez-y :

    mkdir quickstart-private-pool
cd quickstart-private-pool

  3. Créez un fichier nommé cloudbuild.yaml avec le contenu suivant :

    steps:
- name: "bash"
  script: echo "I am running in a private pool!"
options:
  pool:
    name: "projects/$PROJECT_ID/locations/us-central1/workerPools/my-first-privatepool"

  4. Lancez la compilation à l'aide du fichier de configuration de compilation :

    gcloud builds submit

Une fois la compilation terminée, un résultat semblable à ce qui suit doit s'afficher :

I am running in a private pool!
PUSH
DONE
------------------------------------------------------------------------------------------------------------------------------------     ------------------------------------------------------------------------

ID                                    CREATE_TIME                DURATION  SOURCE                                                                                       IMAGES  STATUS
5df45735-6414-40b7-9e10-e6d2023c8cea  2020-08-31T13:16:18+00:00  10S       gs://private-pool-test_cloudbuild/source/1598879777.206444-    58901ecbd14e431f8cdacc85d5dd0fc3.tgz  -       SUCCESS

Afficher les informations sur le build

  1. Ouvrez la page Historique de compilation dans la Google Cloud console.

    Ouvrir la page Cloud Build

  2. Dans la boîte déroulante Région, sélectionnez us-central1.

    La compilation que vous avez exécutée dans le pool privé s'affiche.

  3. Cliquez sur la compilation pour en afficher les détails, tels que le résumé et les artefacts.

Effectuer un nettoyage

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

  1. Ouvrez la page Pool de nœuds de calcul dans la Google Cloud console :

    Ouvrir la page "Pool privé" de Cloud Build

  2. Sur la ligne correspondant à votre pool privé, cliquez sur l'icône Corbeille.

  3. Dans la fenêtre pop-up Supprimer le pool privé ?, cliquez sur Supprimer.

Le pool privé que vous avez créé dans le cadre de ce guide de démarrage rapide est maintenant supprimé. Vous devrez peut-être actualiser votre écran pour supprimer le pool privé de la page Pool de nœuds de calcul.

Étape suivante