Docker@0 - Tâche Docker v0

Générez, étiquetez, envoyez(push), exécutez des images Docker ou exécutez une commande Docker. Utilisez cette tâche avec Docker ou Azure Container Registry.

Remarque

Docker@2 est une version plus récente de cette tâche qui simplifie la tâche en supprimant les entrées qui peuvent être passées en tant qu’arguments à la commande.

Syntaxe

# Docker v0
# Build, tag, push, or run Docker images, or run a Docker command.
- task: Docker@0
  inputs:
    containerregistrytype: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required. Container Registry Type. Default: Azure Container Registry.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Optional. Use when containerregistrytype = Container Registry. Docker Registry Service Connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Optional. Use when containerregistrytype = Azure Container Registry. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when containerregistrytype = Azure Container Registry. Azure Container Registry. 
    action: 'Build an image' # 'Build an image' | 'Tag images' | 'Push an image' | 'Push images' | 'Run an image' | 'Run a Docker command'. Required. Action. Default: Build an image.
    #dockerFile: '**/Dockerfile' # string. Required when action = Build an image. Docker File. Default: **/Dockerfile.
    #buildArguments: # string. Optional. Use when action = Build an image. Build Arguments. 
    #defaultContext: true # boolean. Optional. Use when action = Build an image. Use Default Build Context. Default: true.
    #context: # string. Optional. Use when action = Build an image && defaultContext = false. Build Context. 
    #imageName: '$(Build.Repository.Name):$(Build.BuildId)' # string. Required when action == Build an image || action == Push an image || action == Run an image. Image Name. Default: $(Build.Repository.Name):$(Build.BuildId).
    #imageNamesPath: # string. Required when action == Tag images || action == Push images. Image Names Path. 
    #qualifyImageName: true # boolean. Optional. Use when action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image. Qualify Image Name. Default: true.
    #additionalImageTags: # string. Optional. Use when action = Build an image || action = Tag images || action = Push an image || action = Push images. Additional Image Tags. 
    #includeSourceTags: false # boolean. Optional. Use when action = Build an image || action = Tag image || action = Push an image || action = Push images. Include Source Tags. Default: false.
    #includeLatestTag: false # boolean. Optional. Use when action = Build an image || action = Push an image || action = Push images. Include Latest Tag. Default: false.
    #imageDigestFile: # string. Optional. Use when action = Push an image || action = Push images. Image Digest File. 
    #containerName: # string. Optional. Use when action = Run an image. Container Name. 
    #ports: # string. Optional. Use when action = Run an image. Ports. 
    #volumes: # string. Optional. Use when action = Run an image. Volumes. 
    #envVars: # string. Optional. Use when action = Run an image. Environment Variables. 
    #workDir: # string. Optional. Use when action = Run an image. Working Directory. 
    #entrypoint: # string. Optional. Use when action = Run an image. Entry Point Override. 
    #containerCommand: # string. Optional. Use when action = Run an image. Command. 
    #detached: true # boolean. Optional. Use when action = Run an image. Run In Background. Default: true.
    #restartPolicy: 'no' # 'no' | 'onFailure' | 'always' | 'unlessStopped'. Required when action = Run an image && detached = true. Restart Policy. Default: no.
    #restartMaxRetries: # string. Optional. Use when action = Run an image && detached = true && restartPolicy = onFailure. Maximum Restart Retries. 
    #customCommand: # string. Required when action = Run a Docker command. Command. 
  # commands
    #addBaseImageData: true # boolean. Add base image metadata to image(s). Default: true.
  # Advanced Options
    #dockerHostEndpoint: # string. Docker Host Service Connection. 
    #enforceDockerNamingConvention: true # boolean. Force image name to follow Docker naming convention. Default: true.
    #workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Working Directory. Default: $(System.DefaultWorkingDirectory).
    #memory: # string. Memory limit.

Entrées

containerregistrytype - type de registre de conteneurs
string. Obligatoire. Valeurs autorisées : Azure Container Registry, Container Registry. Valeur par défaut : Azure Container Registry.

Sélectionnez « Azure Container Registry » pour vous y connecter à l’aide d’une connexion de service Azure. Sélectionnez « Registre de conteneurs » pour vous connecter à Docker Hub ou à tout autre registre de conteneurs privé.

dockerRegistryConnection - connexion au service De Registre Docker
Alias d’entrée : dockerRegistryEndpoint. string. Optionnel. Utilisez quand containerregistrytype = Container Registry.

Spécifie une connexion de service de Registre Docker. Obligatoire pour les commandes qui doivent s’authentifier auprès d’un registre.

azureSubscription - abonnement Azure
Alias d’entrée : azureSubscriptionEndpoint. string. Optionnel. Utilisez quand containerregistrytype = Azure Container Registry.

Spécifie un abonnement Azure.

azureContainerRegistry - Azure Container Registry
string. Optionnel. Utilisez quand containerregistrytype = Azure Container Registry.

Spécifie un Registre de conteneurs Azure dans l’abonnement Azure sélectionné. L’image conteneur est générée, puis envoyée (push) à ce registre de conteneurs.

action - action
string. Obligatoire. Valeurs autorisées : Build an image, Tag images, Push an image, Push images, Run an image, Run a Docker command. Valeur par défaut : Build an image.

Spécifie une action Docker.

dockerFile - fichier Docker
string. Obligatoire lorsque action = Build an image. Valeur par défaut : **/Dockerfile.

Spécifie le chemin d’accès au fichier Docker. La tâche utilise le premier fichier Docker trouvé pour générer l’image.

addBaseImageData - Ajouter des métadonnées d’image de base aux images
boolean. Valeur par défaut : true.

La valeur par défaut ajoute des données d’image de base telles que le nom de l’image de base et la synthèse pour faciliter la traçabilité. Vous pouvez désactiver l’option en définissant la valeur sur false.

buildArguments - arguments de génération
string. Optionnel. Utilisez quand action = Build an image.

Spécifie des variables au moment de la génération pour le fichier Docker. Mettez en forme chaque paire name=value sur une nouvelle ligne.

defaultContext - utiliser le contexte de build par défaut
boolean. Optionnel. Utilisez quand action = Build an image. Valeur par défaut : true.

Spécifie le contexte de build du répertoire qui contient le fichier Docker.

context - de contexte de génération
string. Optionnel. Utilisez quand action = Build an image && defaultContext = false.

Spécifie le chemin d’accès au contexte de build.

imageName - nom d’image
string. Obligatoire lorsque action == Build an image || action == Push an image || action == Run an image. Valeur par défaut : $(Build.Repository.Name):$(Build.BuildId).

Spécifie le nom de l’image Docker à générer, envoyer (push) ou exécuter.

chemin d’accès des noms d’images imageNamesPath -
string. Obligatoire lorsque action == Tag images || action == Push images.

Spécifie le chemin d’accès à un fichier texte qui contient les noms des images Docker à baliser ou envoyer (push). Répertoriez chaque nom d’image sur une ligne distincte.

qualifyImageName - qualifier le nom de l’image
boolean. Optionnel. Utilisez quand action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image. Valeur par défaut : true.

Spécifie un nom d’image éligible avec le nom d’hôte de la connexion du service de Registre Docker.

additionalImageTags - balises d’image supplémentaires
string. Optionnel. Utilisez quand action = Build an image || action = Tag images || action = Push an image || action = Push images.

Spécifie des balises supplémentaires pour l’image Docker en cours de génération ou push.

includeSourceTags - inclure des balises sources
boolean. Optionnel. Utilisez quand action = Build an image || action = Tag image || action = Push an image || action = Push images. Valeur par défaut : false.

Spécifie s’il faut inclure des balises Git lors de la génération ou de l’envoi (push) de l’image Docker.

includeLatestTag - Inclure la dernière de balise
boolean. Optionnel. Utilisez quand action = Build an image || action = Push an image || action = Push images. Valeur par défaut : false.

Spécifie s’il faut inclure la dernière balise de lors de la génération ou de l’envoi (push) de l’image Docker.

imageDigestFile - fichier de synthèse d’images
string. Optionnel. Utilisez quand action = Push an image || action = Push images.

Spécifie le chemin d’accès à un fichier créé et rempli avec le résumé complet du référentiel d’images de l’image Docker envoyée( push).

containerName - nom de conteneur
string. Optionnel. Utilisez quand action = Run an image.

Spécifie le nom du conteneur Docker à exécuter.

ports ports -
string. Optionnel. Utilisez quand action = Run an image.

Spécifie les ports du conteneur Docker à publier sur l’hôte. Répertoriez chaque liaison host-port:container-port sur une nouvelle ligne.

volumes - volumes
string. Optionnel. Utilisez quand action = Run an image.

Spécifie les volumes à monter à partir de l’hôte. Répertoriez chaque host-dir:container-dir sur une nouvelle ligne.

variables d’environnement envVars -
string. Optionnel. Utilisez quand action = Run an image.

Spécifie des variables d’environnement pour le conteneur Docker. Répertoriez chaque paire name=value sur une nouvelle ligne.

workDir - répertoire de travail
string. Optionnel. Utilisez quand action = Run an image.

Spécifie le répertoire de travail du conteneur Docker.

remplacement de point d’entrée entrypoint -
string. Optionnel. Utilisez quand action = Run an image.

Spécifie un remplacement du point d’entrée par défaut pour le conteneur Docker.

containerCommand - commande
string. Optionnel. Utilisez quand action = Run an image.

Spécifie une commande Docker Run. La commande docker run crée d’abord une couche conteneur accessible en écriture sur l’image spécifiée, puis la démarre à l’aide de la commande d’exécution spécifiée. Par exemple, si l’image contient une application web Python Flask simple, vous pouvez spécifier python app.py pour lancer l’application web.

detached - Exécuter en arrière-plan
boolean. Optionnel. Utilisez quand action = Run an image. Valeur par défaut : true.

Spécifie s’il faut exécuter le conteneur Docker en arrière-plan.

restartPolicy - redémarrer la stratégie
string. Obligatoire lorsque action = Run an image && detached = true. Valeurs autorisées : no, onFailure (en cas d’échec), always, unlessStopped (sauf s’il est arrêté). Valeur par défaut : no.

Spécifie une stratégie de redémarrage.

restartMaxRetries - tentatives maximales de redémarrage
string. Optionnel. Utilisez quand action = Run an image && detached = true && restartPolicy = onFailure.

Spécifie le nombre maximal de nouvelles tentatives de redémarrage que le démon Docker tente.

customCommand - commande
string. Obligatoire lorsque action = Run a Docker command.

Spécifie la commande Docker et les arguments à exécuter. Par exemple, rmi -f image-name supprime une image.

dockerHostEndpoint - connexion au service hôte Docker
string.

Spécifie une connexion de service hôte Docker. La valeur par défaut est l’hôte de l’agent.

enforceDockerNamingConvention - Forcer le nom de l’image à suivre la convention d’affectation de noms Docker
boolean. Valeur par défaut : true.

Si cette option est activée, modifie le nom de l’image Docker en fonction des conventions d’affectation de noms Docker. Par exemple, convertissez des caractères majuscules en minuscules et supprimez des espaces.

workingDirectory - répertoire de travail
Alias d’entrée : cwd. string. Valeur par défaut : $(System.DefaultWorkingDirectory).

Spécifie le répertoire de travail de la commande Docker.

limite de mémoire memory -
string.

Spécifie la quantité maximale de mémoire disponible pour le conteneur sous forme d’entier avec des suffixes facultatifs, par exemple 2GB.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Cette tâche définit les variables de sortie suivantes, que vous pouvez utiliser en aval, les travaux et les étapes.

DockerOutput
Stocke la sortie de la commande Docker.

DockerOutputPath
Chemin d’accès du fichier qui contient la sortie de la commande build.

Remarques

Docker@2 est une version plus récente de cette tâche qui simplifie la tâche en supprimant les entrées qui peuvent être passées en tant qu’arguments à la commande.

Spécifications

Besoin	Descriptif
Types de pipelines	YAML, Build Classique, Version Classique
Exécutions sur	Agent, DeploymentGroup
demandes	Aucun
fonctionnalités de	Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande	N'importe quel
variables settables	N'importe quel
Version de l’agent	Toutes les versions de l’agent prises en charge.
Catégorie de tâche	Construire

Voir aussi

• Docker@2