Utiliser Azure Pipelines pour générer et envoyer (push) des images conteneur aux registres

La tâche Docker@2 est utilisée pour générer et envoyer (push) l’image au registre de conteneurs. La tâche Docker@2 est conçue pour simplifier le processus de génération, d’envoi (push) et de gestion des images Docker au sein de vos pipelines Azure. Cette tâche prend en charge un large éventail de commandes Docker, notamment la génération, l’envoi (push), la connexion, la déconnexion, le démarrage, l’arrêt et l’exécution.

Procédez comme ceci pour créer un pipeline YAML qui utilise la tâche Docker@2 afin de générer l’image et de la transférer.

1. Dans votre projet Azure DevOps, sélectionnez Pipelines puis New pipeline.

2. Sélectionnez GitHub comme emplacement pour votre code source et sélectionnez votre référentiel.

   • Si vous êtes redirigé vers GitHub pour vous connecter, entrez vos informations d’identification GitHub.
   • Si vous êtes redirigé vers GitHub pour installer l’application Azure Pipelines, sélectionnez Approuver et installer.

3. Sélectionnez votre dépôt.

4. Sélectionnez le modèle de pipeline Starter pour créer une configuration de pipeline de base.

5. Remplacez le contenu de azure-pipelines.yml par le code suivant :

   
   trigger:
   - main
   
   pool:
     vmImage: 'ubuntu-latest' 
   
   variables:
     repositoryName: '<target repository name>' 
   
   steps:
   - task: Docker@2
     inputs:
       containerRegistry: '<docker registry service connection>'
       repository: $(repositoryName)
       command: 'buildAndPush'
       Dockerfile: '**/Dockerfile'
   
   

6. Modifiez le fichier YAML du pipeline comme suit :

   • Remplacez <target repository name> par le nom du référentiel dans le registre de conteneurs dans lequel vous souhaitez envoyer (push) l’image.
   • Remplacez <docker registry service connection> par le nom de la connexion de service du registre Docker que vous avez créée précédemment.

7. Lorsque vous avez terminé, sélectionnez Enregistrer et exécuter>Enregistrer et exécuter.

8. Sélectionnez Job pour afficher les journaux et vérifier que le pipeline s’est exécuté avec succès.

Créer un pipeline à l’aide de l’éditeur classique

1. Dans votre projet Azure DevOps, sélectionnez Pipelines et Nouveau pipeline

2. Sélectionnez Use the classic editor depuis la page Where is your code?.

3. Sur la page Select a source, sélectionnez GitHub.

4. Choisissez votre référentiel et sélectionnez Continuer.

5. Sur la page Select a template, sélectionnez Empty pipeline puis Apply.

6. Sélectionnez ubuntu latest pour la Agent Specification.

   

Ajouter la tâche Docker@2 au pipeline

Pour générer et envoyer (push) l’image au registre de conteneurs, ajoutez la tâche Docker@2 au pipeline.

1. Ajoutez une tâche à Agent job 1.

   

2. Sélectionnez la tâche Docker, puis Add.

3. Sélectionnez la tâche buildAndPush.

4. Pour container Registry, sélectionnez la connexion de service que vous avez créée précédemment. Si vous n’en avez pas, sélectionnez +Nouveau pour créer une connexion de service Docker Hub.

   

Exécuter le pipeline

1. Sélectionnez Save and queue>Save and Queue.
2. Sur la page Run pipeline, sélectionnez Save and run.
3. Sélectionnez Job pour afficher les journaux et vérifier que le pipeline s’est exécuté avec succès.

1. Rendez-vous dans votre projet Azure DevOps et sélectionnez Pipelines dans le menu de gauche.

2. Sélectionnez Nouveau pipeline.

3. Sélectionnez GitHub comme emplacement pour votre code source et sélectionnez votre référentiel.

   • Si vous êtes redirigé vers GitHub pour vous connecter, entrez vos informations d’identification GitHub.
   • Si vous êtes redirigé vers GitHub pour installer l’application Azure Pipelines, sélectionnez Approuver et installer.

4. Sélectionnez le modèle Docker - Construire et envoyer une image à Azure Container Registry.

5. Sélectionnez votre abonnement Azure et Continue.

6. Sélectionnez votre Container Registry, puis sélectionnez Validate and configure.

   Exemple de pipeline YAML :

   # Docker
   # Build and push an image to Azure Container Registry
   # https://docs.microsoft.com/azure/devops/pipelines/languages/docker
   
   trigger:
   - main
   
   resources:
   - repo: self
   
   variables:
     # Container registry service connection established during pipeline creation
     dockerRegistryServiceConnection: '7f9dc28e-5551-43ee-891f-33bf61a995de'
     imageRepository: 'usernamepipelinesjavascriptdocker'
     containerRegistry: 'repoistoryname.azurecr.io'
     dockerfilePath: '$(Build.SourcesDirectory)/app/Dockerfile'
     tag: '$(Build.BuildId)'
   
     # Agent VM image name
     vmImageName: 'ubuntu-latest'
   
   stages:
   - stage: Build
     displayName: Build and push stage
     jobs:
     - job: Build
       displayName: Build
       pool:
         vmImage: $(vmImageName)
       steps:
       - task: Docker@2
         displayName: Build and push an image to container registry
         inputs:
           command: buildAndPush
           repository: $(imageRepository)
           dockerfile: $(dockerfilePath)
           containerRegistry: $(dockerRegistryServiceConnection)
           tags: |
             $(tag)
   
   

7. Sélectionnez Enregistrer et exécuter et Enregistrer et réexécuter.

8. Sélectionnez la tâche pour afficher les logs et vérifier que le pipeline s’est exécuté correctement.

Le modèle Docker crée la connexion de service à votre Registre de conteneurs Azure et utilise la tâche de Docker@2 pour générer et envoyer (push) l’image Docker au registre.

La tâche Docker@2 est conçue pour simplifier le processus de génération, d’envoi (push) et de gestion des images Docker au sein de vos pipelines Azure. Cette tâche prend en charge un large éventail de commandes Docker, notamment la génération, l’envoi (push), la connexion, la déconnexion, le démarrage, l’arrêt et l’exécution.

Créer un pipeline à l’aide de l’éditeur classique

1. Dans votre projet Azure DevOps, sélectionnez Pipelines et Nouveau pipeline.

2. Sélectionnez Utiliser l’éditeur classique dans la page Où Se Trouve Votre Code ?.

3. Sur la page Select a source, sélectionnez GitHub.

4. Choisissez votre référentiel et sélectionnez Continuer.

5. Sur la page Select a template, sélectionnez Empty pipeline puis Apply.

6. Sélectionnez ubuntu latest pour la Agent Specification.

   

Ajouter la tâche Docker@2 au pipeline

Ajoutez une tâche Docker@2 au pipeline pour générer et envoyer (push) l’image au registre de conteneurs.

1. Ajoutez une tâche à Agent job 1.

   

2. Sélectionnez la tâche Docker, puis Add.

3. Sélectionnez la tâche buildAndPush.

4. Créez une connexion de service, sélectionnez +Nouveau.

   

5. Renseignez les champs suivants :

   Champ	Description
   Abonnement	Sélectionnez votre abonnement Azure.
   registre de conteneurs Azure	Sélectionnez votre registre de conteneurs Azure.
   nom de connexion de service	Entrez un nom pour la connexion de service.
   Accorder l’autorisation d’accès à tous les pipelines	Sélectionnez cette option pour accorder l’accès à tous les pipelines.

   

6. Sélectionnez Enregistrer.

Exécuter le pipeline

1. Sélectionnez Save and queue>Save and Queue.
2. Sur la page Run pipeline, sélectionnez Save and run.
3. Sélectionnez Job pour afficher les journaux et vérifier que le pipeline s’est exécuté avec succès.