Cette page a été traduite par l'API Cloud Translation.
Switch to English

Guide de démarrage rapide : compilation

Cette page explique comment utiliser Cloud Build pour créer une image Docker et la transférer vers 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.

Avant de commencer

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder à la page de sélection du projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activer les API Cloud Build, Artifact Registry.

    Activer les API

  5. Installez et initialisez le SDK Cloud.

Préparer les fichiers source

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 simple ainsi qu'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. Saisissez la commande suivante pour pouvoir exécuter quickstart.sh :

    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-central1 ayant comme description "Docker repository" (dépôt Docker) :

    gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \
        --location=us-central1 --description="Docker repository"
    
  2. Vérifiez que votre dépôt a bien été créé :

    gcloud artifacts repositories list
    

Compiler à l'aide d'un fichier 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 votre ID de projet 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, où project-id correspond à l'ID de votre projet Cloud :

    gcloud builds submit --tag us-central1-docker.pkg.dev/project-id/quickstart-docker-repo/quickstart-image:tag1
    

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

Compiler à 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'
      args: [ 'build', '-t', 'us-central1-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1', '.' ]
    images:
    - 'us-central1-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 --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-central1-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 la compilation

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

    Ouvrir la page Cloud Build

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

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

    Capture d'écran de la page Historique de compilation

  3. Cliquez sur une compilation.

    La page Informations sur la compilation s'affiche :

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

    Capture d'écran des artefacts de compilation

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

Nettoyer

Pour éviter que les ressources utilisées dans ce guide de démarrage rapide soient facturées sur votre compte Google Cloud, procédez comme suit :

  1. Ouvrez la page "Artifact Registry" dans Google Cloud Console.

    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.

Voilà ! Vous avez terminé le guide de démarrage rapide.

Étapes suivantes