Envoyer (push) une image

Azure DevOps Services

Utilisez Azure Pipelines pour envoyer (push) votre image à un registre de conteneurs tel que Azure Container Registry, Docker Hub ou Google Container Registry. Azure Container Registry est un service de registre managé basé sur le registre Docker open source 2.0.

Pour obtenir un didacticiel sur la création et l’envoi d’images vers un registre de conteneurs, consultez Générer et envoyer (push) des images Docker à Azure Container Registry.

Pour savoir comment créer une image conteneur à déployer avec Azure Pipelines, consultez Créer des images conteneur pour déployer des applications.

À propos de la tâche Docker

Vous utiliserez la tâche Docker@2 pour générer ou envoyer (push) des images Docker, vous connecter ou vous déconnecter, démarrer ou arrêter des conteneurs ou exécuter une commande Docker.

La tâche utilise une connexion de service de registre Docker pour se connecter et envoyer (push) à un registre de conteneurs. Le processus de création d’une connexion au service de registre Docker diffère en fonction de votre registre.

La connexion au service de registre Docker stocke les informations d’identification dans le registre de conteneurs avant d’envoyer l’image. Vous pouvez également référencer directement les connexions de service dans Docker sans tâche de script supplémentaire.

Créer une connexion de service Docker

Vous devez suivre un autre processus pour créer une connexion de service pour Azure Container Registry, Docker Hub et Google Container Registry.

Azure Container Registry

Avec l’option Azure Container Registry, l’abonnement (associé à l’identité Microsoft Entra de l’utilisateur connecté à Azure DevOps) et le registre de conteneurs au sein de l’abonnement sont utilisés pour créer la connexion de service.

Lorsque vous créez un pipeline pour un référentiel qui contient un fichier Dockerfile, Azure Pipelines détecte dockerfile dans le référentiel. Pour démarrer ce processus, créez un pipeline et sélectionnez le référentiel avec votre fichier Dockerfile.

1. Sous l’onglet Configurer, sélectionnez la tâcheDocker – Générer et envoyer (push) une image à Azure Container Registry.

   

2. Sélectionnez votre abonnement Azure, puis sélectionnez Continuer.

3. Sélectionnez votre registre de conteneurs dans le menu déroulant, puis fournissez un nom d’image à votre image conteneur.

4. Sélectionnez Valider et configurer lorsque vous avez terminé.

   

   À mesure qu’Azure Pipelines crée votre pipeline, le processus va effectuer les opérations suivants :

   • Créer une connexion de service de registre Docker pour permettre à votre pipeline d’envoyer (push) des images à votre registre de conteneurs.

   • Générer un fichier azure-pipelines.yml, qui définit votre pipeline.

Pour obtenir une vue d’ensemble plus détaillée, consultez la documentation Générer et envoyer (push) vers Azure Container Registry.

Docker Hub

Choisissez l’option Docker Hub sous Connexion au service de registre Docker et fournissez votre nom d’utilisateur et votre mot de passe pour créer une connexion au service Docker.

Google Container Registry

Pour créer une connexion de service Docker associée à Google Container Registry :

1. Ouvrez votre projet dans la console GCP, puis ouvrez Cloud Shell

2. Pour gagner du temps lors de la saisie de votre ID de projet et des options de zone du moteur de calcul, définissez les valeurs de configuration par défaut en exécutant les commandes suivantes :

   gcloud config set project [PROJECT_NAME]
   gcloud config set compute/zone [ZONE]
   

3. Remplacez [PROJECT_NAME] par le nom de votre projet GCP et remplacez [ZONE] par le nom de la zone que vous allez utiliser pour créer des ressources. Si vous ne savez pas quelle zone choisir, utilisez us-central1-a. Par exemple :

   gcloud config set project azure-pipelines-test-project-12345
   gcloud config set compute/zone us-central1-a
   

4. Activez l’API Container Registry pour votre projet :

   gcloud services enable containerregistry.googleapis.com
   

5. Créez un compte de service pour Azure Pipelines afin de publier des images Docker :

   gcloud iam service-accounts create azure-pipelines-publisher --display-name "Azure Pipelines Publisher"
   

6. Attribuez le rôle Stockage Administration IAM au compte de service :

   PROJECT_NUMBER=$(gcloud projects describe \
   $(gcloud config get-value core/project) \
   --format='value(projectNumber)')
   
   AZURE_PIPELINES_PUBLISHER=$(gcloud iam service-accounts list \
       --filter="displayName:Azure Pipelines Publisher" \
       --format='value(email)')
   
   gcloud projects add-iam-policy-binding \
       $(gcloud config get-value core/project) \
       --member serviceAccount:$AZURE_PIPELINES_PUBLISHER \
       --role roles/storage.admin
   

7. Générez une clé de compte de service :

   gcloud iam service-accounts keys create \
   azure-pipelines-publisher.json --iam-account $AZURE_PIPELINES_PUBLISHER
   
   tr -d '\n' < azure-pipelines-publisher.json > azure-pipelines-publisher-oneline.json
   

   Lancez l’Éditeur de code en cliquant sur le bouton dans le coin supérieur droit de Cloud Shell :

   

8. Ouvrez le fichier named azure-pipelines-publisher-oneline.json. Vous aurez besoin du contenu de ce fichier dans l’une des étapes suivantes :

9. Dans votre organisation Azure DevOps, sélectionnez Paramètres du projet, puis sélectionnez Pipelines -> Connexions de service.

10. Sélectionnez Nouvelle connexion de service, puis choisissez Registre Docker

11. Dans la boîte de dialogue, saisissez des valeurs pour les champs suivants :

    • Registre Docker :https://gcr.io/[PROJECT-ID], où [PROJECT-ID] est le nom de votre projet GCP.
    • ID Docker :_json_key
    • Mot de passe Docker : coller le contenu de azure-pipelines-publisher-oneline.json
    • Nom de la connexion de service :gcrServiceConnection

12. Sélectionnez Enregistrer pour créer la connexion de service