Créer et transférer une image Docker avec Cloud Build

Créer et transférer une image Docker avec Cloud Build

Découvrez comment faire vos premiers pas avec Cloud Build en créant une image Docker et en la transférant dans Artifact Registry. Artifact Registry fournit un emplacement unique pour la gestion des packages privés et des images de conteneurs Docker.

Vous allez d'abord créer l'image à l'aide d'un fichier Dockerfile, à savoir le fichier de configuration Docker, puis la compiler à l'aide du fichier de configuration de compilation de Cloud Build.

Remarque : Ce guide de démarrage rapide vous explique comment créer une image avec docker, mais sachez que Cloud Build est compatible avec la plupart des outils de compilation et des langages de programmation.

---

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

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Compute Engine and Artifact Registry APIs.

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 APIs

Install the Google Cloud CLI.

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.

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

gcloud init

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Compute Engine and Artifact Registry APIs.

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 APIs

Install the Google Cloud CLI.

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.

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

gcloud init

Si vous avez déjà installé Google Cloud CLI, assurez-vous de disposer de la dernière version disponible en exécutant la commande gcloud components update.

1. Make sure that you have the following role or roles on the project: Artifact Registry Administrator, Cloud Build Editor, Logs Viewer, Service Account User, Service Usage Admin, Storage Bucket Viewer, Storage Object Creator

   Check for the roles

   1. In the Google Cloud console, go to the IAM page.

      Go to IAM
   2. Select the project.

   3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

   4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

   Grant the roles

   1. In the Google Cloud console, go to the IAM page.

      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'adresse e-mail d'un compte Google.

   5. Dans la liste Sélectionner un rôle, sélectionnez un 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.

   Préparer des fichiers sources à compiler

   Vous aurez besoin d'un exemple de code source à empaqueter dans une image de conteneur. Dans cette section, vous allez créer un script shell et un fichier Dockerfile. Un fichier Dockerfile est un document texte qui contient des instructions permettant à Docker de créer une image.

   1. Ouvrez une fenêtre de terminal.

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

      mkdir quickstart-docker
      cd quickstart-docker
      

   3. Créez un fichier nommé quickstart.sh avec le contenu suivant :

      #!/bin/sh
      echo "Hello, world! The time is $(date)."

   4. Créez un fichier nommé Dockerfile avec le contenu suivant :

      FROM alpine
      COPY quickstart.sh /
      CMD ["/quickstart.sh"]

   5. Dans la fenêtre de terminal, exécutez la commande suivante pour rendre quickstart.sh exécutable :

      chmod +x quickstart.sh
      

   Créer un dépôt Docker dans Artifact Registry

   1. Créez un dépôt Docker nommé quickstart-docker-repo à l'emplacement us-west2, avec comme description "dépôt Docker" :

      gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \
          --location=us-west2 --description="Docker repository"
      

   2. Vérifiez que votre dépôt a bien été créé :

      gcloud artifacts repositories list
      

      Vous verrez quickstart-docker-repo dans la liste des dépôts affichés.

   Créer une image à l'aide de Dockerfile

   Cloud Build vous permet de créer une image Docker à l'aide d'un fichier Dockerfile. Vous n'avez pas besoin d'un fichier de configuration Cloud Build distinct.

   Pour compiler à l'aide d'un fichier Dockerfile :

   1. Obtenez l'ID de votre projet Google Cloud en exécutant la commande suivante :

      gcloud config get-value project
      

   2. Exécutez la commande suivante à partir du répertoire contenant quickstart.sh et Dockerfile :

      gcloud builds submit --region=us-west2 --tag us-west2-docker.pkg.dev/PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1
      

      Remarque : Si l'ID de votre projet contient des deux-points, remplacez-les par une barre oblique.

   Une fois la compilation terminée, un résultat semblable aux lignes suivantes doit s'afficher :

   DONE
   ------------------------------------------------------------------------------------------------------------------------------------
   ID                                    CREATE_TIME                DURATION  SOURCE   IMAGES     STATUS
   545cb89c-f7a4-4652-8f63-579ac974be2e  2020-11-05T18:16:04+00:00  16S       gs://gcb-docs-project_cloudbuild/source/1604600163.528729-b70741b0f2d0449d8635aa22893258fe.tgz  us-west2-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1  SUCCESS
   

   Vous venez de créer une image Docker nommée quickstart-image à l'aide d'un fichier Dockerfile et avez transféré l'image vers Artifact Registry.

   Créer une image à l'aide d'un fichier de configuration de compilation

   Dans cette section, vous allez utiliser un fichier de configuration Cloud Build pour créer la même image Docker que ci-dessus. Le fichier de configuration de compilation demande à Cloud Build d'effectuer des tâches conformes à vos spécifications.

   1. Dans le même répertoire contenant quickstart.sh et Dockerfile, créez un fichier nommé cloudbuild.yaml avec le contenu suivant. Ce fichier est votre fichier de configuration de compilation. Au moment de la compilation, Cloud Build remplace automatiquement $PROJECT_ID par l'ID de votre projet.

      steps:
      - name: 'gcr.io/cloud-builders/docker'
        script: |
          docker build -t us-west2-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1 .
        automapSubstitutions: true
      images:
      - 'us-west2-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1'

   2. Démarrez la compilation en exécutant la commande suivante :

      gcloud builds submit --region=us-west2 --config cloudbuild.yaml
      

   Une fois la compilation terminée, un résultat semblable aux lignes suivantes doit s'afficher :

   DONE
   ------------------------------------------------------------------------------------------------------------------------------------
   ID                                    CREATE_TIME                DURATION  SOURCE          IMAGES          STATUS
   046ddd31-3670-4771-9336-8919e7098b11  2020-11-05T18:24:02+00:00  15S       gs://gcb-docs-project_cloudbuild/source/1604600641.576884-8153be22c94d438aa86c78abf11403eb.tgz  us-west2-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1  SUCCESS
   

   Vous venez de créer quickstart-image à l'aide du fichier de configuration de compilation et vous avez ensuite transféré l'image dans Artifact Registry.

   Afficher les informations sur le build

   1. Ouvrez la page Cloud Build dans la console Google Cloud .

      Ouvrir la page Cloud Build

   2. Si nécessaire, sélectionnez votre projet et cliquez sur Ouvrir.

      La page Build history (Historique de compilation) s'affiche :

      

   3. Si nécessaire, sélectionnez us-west2 dans le menu déroulant Région pour afficher les builds dans cette région.

      Deux builds seront listés, un pour chacun des builds que vous avez exécutés dans ce guide de démarrage rapide.

   4. Cliquez sur l'une des compilations.

      La page Informations sur le build s'affiche :

   5. Pour afficher les artefacts de votre compilation, cliquez sur Build Artifacts (Artefacts de compilation) sous Build Summary (Résumé de la compilation).

      Un résultat semblable aux lignes suivantes s'affiche :

      

      Vous pouvez télécharger votre journal de compilation et afficher les détails de votre image dans Artifact Registry à partir de cette page.

   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. Ouvrez la page "Artifact Registry" dans la console Google Cloud .

      Ouvrir la page "Artifact Registry"

   2. Sélectionnez votre projet et cliquez sur Ouvrir.

   3. Sélectionnez quickstart-docker-repo.

   4. Cliquez sur Supprimer.

   Vous avez maintenant supprimé le dépôt que vous avez créé dans le cadre de ce démarrage rapide.

   Étape suivante

   • Découvrez comment exécuter une image Docker.
   • Découvrez comment créer un fichier de configuration de compilation de base.
   • Découvrez comment déployer une application avec Cloud Build.
   • Découvrez comment créer des applications Node.js.
   • Découvrez comment créer des applications Java.
   • Découvrez comment créer des applications Go.