Docker@1 - Tâche Docker v1

  • Article

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

Notes

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.

Syntax

# Docker v1
# Build, tag, push, or run Docker images, or run a Docker command.
- task: Docker@1
  inputs:
  # Container Registry
    #containerregistrytype: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when command != logout. Container registry type. Default: Azure Container Registry.
    #dockerRegistryEndpoint: # string. Optional. Use when containerregistrytype = Container Registry && command != logout. Docker registry service connection. 
    #azureSubscriptionEndpoint: # string. Optional. Use when containerregistrytype = Azure Container Registry && command != logout. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when containerregistrytype = Azure Container Registry && command != logout. Azure container registry. 
  # Commands
    #addBaseImageData: true # boolean. Add base image metadata to image(s). Default: true.
    command: 'Build an image' # 'Build an image' | 'Tag image' | 'Push an image' | 'Run an image' | 'login' | 'logout'. Required. Command. Default: Build an image.
    #dockerFile: '**/Dockerfile' # string. Required when command = Build an image || command = build. Dockerfile. Default: **/Dockerfile.
    #arguments: # string. Optional. Use when command != login && command != logout. Arguments. 
    #pushMultipleImages: false # boolean. Optional. Use when command = Push an image || command = push. Push multiple images. Default: false.
    #tagMultipleImages: false # boolean. Optional. Use when command = Tag image || command = tag. Tag multiple images. Default: false.
    #imageName: '$(Build.Repository.Name):$(Build.BuildId)' # string. Required when command = Build an image || command = build || command = Run an image || command = run || pushMultipleImages = false || tagMultipleImages = false. Image name. Default: $(Build.Repository.Name):$(Build.BuildId).
    #imageNamesPath: # string. Required when tagMultipleImages = true || pushMultipleImages = true. Image names path. 
    #qualifyImageName: true # boolean. Optional. Use when command = Build an image || command = build || command = Tag image || command = tag || command = Push an image || command = push || command = Run an image || command = run. Qualify image name. Default: true.
    #qualifySourceImageName: false # boolean. Optional. Use when command = Tag image || command = tag. Qualify source image name. Default: false.
    #includeSourceTags: false # boolean. Optional. Use when command = Build an image || command = build || command = Tag image || command = tag  || command = Push an image || command = push. Include source tags. Default: false.
    #includeLatestTag: false # boolean. Optional. Use when command = Build an image || command = build. Include latest tag. Default: false.
    #addDefaultLabels: true # boolean. Optional. Use when addDefaultLabels = false. Add default labels. Default: true.
    #useDefaultContext: true # boolean. Optional. Use when command = Build an image || command = build. Use default build context. Default: true.
    #buildContext: # string. Optional. Use when useDefaultContext = false. Build context. 
    #imageDigestFile: # string. Optional. Use when command = Push an image || command = push. Image digest file. 
    #containerName: # string. Optional. Use when command = Run an image || command = run. Container name. 
    #ports: # string. Optional. Use when command = Run an image || command = run. Ports. 
    #volumes: # string. Optional. Use when command = Run an image || command = run. Volumes. 
    #envVars: # string. Optional. Use when command = Run an image || command = run. Environment variables. 
    #workingDirectory: # string. Optional. Use when command = Run an image || command = run. Working directory. 
    #entrypointOverride: # string. Optional. Use when command = Run an image || command = run. Entry point override. 
    #containerCommand: # string. Optional. Use when command = Run an image || command = run. Container command. 
    #runInBackground: true # boolean. Optional. Use when command = Run an image || command = run. Run in background. Default: true.
    restartPolicy: 'no' # 'no' | 'onFailure' | 'always' | 'unlessStopped'. Required when runInBackground = true. Restart policy. Default: no.
    #maxRestartRetries: # string. Optional. Use when runInBackground = true && restartPolicy = onFailure. Maximum restart retries. 
  # Advanced Options
    #dockerHostEndpoint: # string. Optional. Use when command != login && command != logout. Docker host service connection. 
    #enforceDockerNamingConvention: true # boolean. Optional. Use when command != login && command != logout. Force image name to follow Docker naming convention. Default: true.
    #memoryLimit: # string. Optional. Use when command != login && command != logout. Memory limit.

# Docker v1
# Build, tag, push, or run Docker images, or run a Docker command.
- task: Docker@1
  inputs:
  # Container Registry
    #containerregistrytype: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when command != logout. Container registry type. Default: Azure Container Registry.
    #dockerRegistryEndpoint: # string. Optional. Use when containerregistrytype = Container Registry && command != logout. Docker registry service connection. 
    #azureSubscriptionEndpoint: # string. Optional. Use when containerregistrytype = Azure Container Registry && command != logout. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when containerregistrytype = Azure Container Registry && command != logout. Azure container registry. 
  # Commands
    command: 'Build an image' # 'Build an image' | 'Tag image' | 'Push an image' | 'Run an image' | 'login' | 'logout'. Required. Command. Default: Build an image.
    #dockerFile: '**/Dockerfile' # string. Required when command = Build an image || command = build. Dockerfile. Default: **/Dockerfile.
    #arguments: # string. Optional. Use when command != login && command != logout. Arguments. 
    #pushMultipleImages: false # boolean. Optional. Use when command = Push an image || command = push. Push multiple images. Default: false.
    #tagMultipleImages: false # boolean. Optional. Use when command = Tag image || command = tag. Tag multiple images. Default: false.
    #imageName: '$(Build.Repository.Name):$(Build.BuildId)' # string. Required when command = Build an image || command = build || command = Run an image || command = run || pushMultipleImages = false || tagMultipleImages = false. Image name. Default: $(Build.Repository.Name):$(Build.BuildId).
    #imageNamesPath: # string. Required when tagMultipleImages = true || pushMultipleImages = true. Image names path. 
    #qualifyImageName: true # boolean. Optional. Use when command = Build an image || command = build || command = Tag image || command = tag || command = Push an image || command = push || command = Run an image || command = run. Qualify image name. Default: true.
    #qualifySourceImageName: false # boolean. Optional. Use when command = Tag image || command = tag. Qualify source image name. Default: false.
    #includeSourceTags: false # boolean. Optional. Use when command = Build an image || command = build || command = Tag image || command = tag  || command = Push an image || command = push. Include source tags. Default: false.
    #includeLatestTag: false # boolean. Optional. Use when command = Build an image || command = build. Include latest tag. Default: false.
    #addDefaultLabels: true # boolean. Optional. Use when addDefaultLabels = false. Add default labels. Default: true.
    #useDefaultContext: true # boolean. Optional. Use when command = Build an image || command = build. Use default build context. Default: true.
    #buildContext: # string. Optional. Use when useDefaultContext = false. Build context. 
    #imageDigestFile: # string. Optional. Use when command = Push an image || command = push. Image digest file. 
    #containerName: # string. Optional. Use when command = Run an image || command = run. Container name. 
    #ports: # string. Optional. Use when command = Run an image || command = run. Ports. 
    #volumes: # string. Optional. Use when command = Run an image || command = run. Volumes. 
    #envVars: # string. Optional. Use when command = Run an image || command = run. Environment variables. 
    #workingDirectory: # string. Optional. Use when command = Run an image || command = run. Working directory. 
    #entrypointOverride: # string. Optional. Use when command = Run an image || command = run. Entry point override. 
    #containerCommand: # string. Optional. Use when command = Run an image || command = run. Container command. 
    #runInBackground: true # boolean. Optional. Use when command = Run an image || command = run. Run in background. Default: true.
    restartPolicy: 'no' # 'no' | 'onFailure' | 'always' | 'unlessStopped'. Required when runInBackground = true. Restart policy. Default: no.
    #maxRestartRetries: # string. Optional. Use when runInBackground = true && restartPolicy = onFailure. Maximum restart retries. 
  # Advanced Options
    #dockerHostEndpoint: # string. Optional. Use when command != login && command != logout. Docker host service connection. 
    #enforceDockerNamingConvention: true # boolean. Optional. Use when command != login && command != logout. Force image name to follow Docker naming convention. Default: true.
    #memoryLimit: # string. Optional. Use when command != login && command != logout. Memory limit.

# Docker v1
# Build, tag, push, or run Docker images, or run a Docker command.
- task: Docker@1
  inputs:
  # Container Registry
    #containerregistrytype: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when command != logout. Container registry type. Default: Azure Container Registry.
    #dockerRegistryEndpoint: # string. Optional. Use when containerregistrytype = Container Registry && command != logout. Docker registry service connection. 
    #azureSubscriptionEndpoint: # string. Optional. Use when containerregistrytype = Azure Container Registry && command != logout. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when containerregistrytype = Azure Container Registry && command != logout. Azure container registry. 
  # Commands
    command: 'Build an image' # 'Build an image' | 'Tag image' | 'Push an image' | 'Run an image' | 'login' | 'logout'. Required. Command. Default: Build an image.
    #dockerFile: '**/Dockerfile' # string. Required when command = Build an image || command = build. Dockerfile. Default: **/Dockerfile.
    #arguments: # string. Optional. Use when command != login && command != logout. Arguments. 
    #pushMultipleImages: false # boolean. Optional. Use when command = Push an image || command = push. Push multiple images. Default: false.
    #tagMultipleImages: false # boolean. Optional. Use when command = Tag image || command = tag. Tag multiple images. Default: false.
    #imageName: '$(Build.Repository.Name):$(Build.BuildId)' # string. Required when command = Build an image || command = build || command = Run an image || command = run || pushMultipleImages = false || tagMultipleImages = false. Image name. Default: $(Build.Repository.Name):$(Build.BuildId).
    #imageNamesPath: # string. Required when tagMultipleImages = true || pushMultipleImages = true. Image names path. 
    #qualifyImageName: true # boolean. Optional. Use when command = Build an image || command = build || command = Tag image || command = tag || command = Push an image || command = push || command = Run an image || command = run. Qualify image name. Default: true.
    #includeSourceTags: false # boolean. Optional. Use when command = Build an image || command = build || command = Tag image || command = tag  || command = Push an image || command = push. Include source tags. Default: false.
    #includeLatestTag: false # boolean. Optional. Use when command = Build an image || command = build. Include latest tag. Default: false.
    #addDefaultLabels: true # boolean. Optional. Use when addDefaultLabels = false. Add default labels. Default: true.
    #useDefaultContext: true # boolean. Optional. Use when command = Build an image || command = build. Use default build context. Default: true.
    #buildContext: # string. Optional. Use when useDefaultContext = false. Build context. 
    #imageDigestFile: # string. Optional. Use when command = Push an image || command = push. Image digest file. 
    #containerName: # string. Optional. Use when command = Run an image || command = run. Container name. 
    #ports: # string. Optional. Use when command = Run an image || command = run. Ports. 
    #volumes: # string. Optional. Use when command = Run an image || command = run. Volumes. 
    #envVars: # string. Optional. Use when command = Run an image || command = run. Environment variables. 
    #workingDirectory: # string. Optional. Use when command = Run an image || command = run. Working directory. 
    #entrypointOverride: # string. Optional. Use when command = Run an image || command = run. Entry point override. 
    #containerCommand: # string. Optional. Use when command = Run an image || command = run. Container command. 
    #runInBackground: true # boolean. Optional. Use when command = Run an image || command = run. Run in background. Default: true.
    restartPolicy: 'no' # 'no' | 'onFailure' | 'always' | 'unlessStopped'. Required when runInBackground = true. Restart policy. Default: no.
    #maxRestartRetries: # string. Optional. Use when runInBackground = true && restartPolicy = onFailure. Maximum restart retries. 
  # Advanced Options
    #dockerHostEndpoint: # string. Optional. Use when command != login && command != logout. Docker host service connection. 
    #enforceDockerNamingConvention: true # boolean. Optional. Use when command != login && command != logout. Force image name to follow Docker naming convention. Default: true.
    #memoryLimit: # string. Optional. Use when command != login && command != logout. Memory limit.

# Docker v1
# Build, tag, push, or run Docker images, or run a Docker command. Task can be used with Docker or Azure Container registry.
- task: Docker@1
  inputs:
  # Container Registry
    #containerregistrytype: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when command != logout. Container registry type. Default: Azure Container Registry.
    #dockerRegistryEndpoint: # string. Optional. Use when containerregistrytype = Container Registry && command != logout. Docker registry service connection. 
    #azureSubscriptionEndpoint: # string. Optional. Use when containerregistrytype = Azure Container Registry && command != logout. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when containerregistrytype = Azure Container Registry && command != logout. Azure container registry. 
  # Commands
    command: 'Build an image' # 'Build an image' | 'Tag image' | 'Push an image' | 'Run an image' | 'login' | 'logout'. Required. Command. Default: Build an image.
    #dockerFile: '**/Dockerfile' # string. Required when command = Build an image || command = build. Dockerfile. Default: **/Dockerfile.
    #arguments: # string. Optional. Use when command != Run an image && command != run && command != login && command != logout. Arguments. 
    #useDefaultContext: true # boolean. Optional. Use when command = Build an image || command = build. Use default build context. Default: true.
    #buildContext: # string. Optional. Use when useDefaultContext = false. Build context. 
    #pushMultipleImages: false # boolean. Optional. Use when command = Push an image || command = push. Push multiple images. Default: false.
    #tagMultipleImages: false # boolean. Optional. Use when command = Tag image || command = tag. Tag multiple images. Default: false.
    #imageName: '$(Build.Repository.Name):$(Build.BuildId)' # string. Required when command = Build an image || command = build || command = Run an image || command = run || pushMultipleImages = false || tagMultipleImages = false. Image name. Default: $(Build.Repository.Name):$(Build.BuildId).
    #imageNamesPath: # string. Required when tagMultipleImages = true || pushMultipleImages = true. Image names path. 
    #qualifyImageName: true # boolean. Optional. Use when command = Build an image || command = build || command = Tag image || command = tag || command = Push an image || command = push || command = Run an image || command = run. Qualify image name. Default: true.
    #includeSourceTags: false # boolean. Optional. Use when command = Build an image || command = build || command = Tag image || command = tag  || command = Push an image || command = push. Include source tags. Default: false.
    #includeLatestTag: false # boolean. Optional. Use when command = Build an image || command = build. Include latest tag. Default: false.
    #addDefaultLabels: true # boolean. Optional. Use when command = Build an image || command = build. Add default labels. Default: true.
    #imageDigestFile: # string. Optional. Use when command = Push an image || command = push. Image digest file. 
    #containerName: # string. Optional. Use when command = Run an image || command = run. Container name. 
    #ports: # string. Optional. Use when command = Run an image || command = run. Ports. 
    #volumes: # string. Optional. Use when command = Run an image || command = run. Volumes. 
    #envVars: # string. Optional. Use when command = Run an image || command = run. Environment variables. 
    #workingDirectory: # string. Optional. Use when command = Run an image || command = run. Working directory. 
    #entrypointOverride: # string. Optional. Use when command = Run an image || command = run. Entry point override. 
    #containerCommand: # string. Optional. Use when command = Run an image || command = run. Command. 
    #runInBackground: true # boolean. Optional. Use when command = Run an image || command = run. Run in background. Default: true.
    restartPolicy: 'no' # 'no' | 'onFailure' | 'always' | 'unlessStopped'. Required when runInBackground = true. Restart policy. Default: no.
    #maxRestartRetries: # string. Optional. Use when runInBackground = true && restartPolicy = onFailure. Maximum restart retries. 
  # Advanced Options
    #dockerHostEndpoint: # string. Optional. Use when command != login && command != logout. Docker host service connection. 
    #enforceDockerNamingConvention: true # boolean. Optional. Use when command != login && command != logout. Force image name to follow Docker naming convention. Default: true.
    #memoryLimit: # string. Optional. Use when command != login && command != logout. Memory limit.

Entrées

containerregistrytype - Type de registre de conteneurs
string. Nécessaire lorsque command != logout. Valeurs autorisées : Azure Container Registry, Container Registry. Valeur par défaut : Azure Container Registry.

Spécifie la Azure Container Registry à connecter à l’aide d’une connexion de service Azure. Sélectionnez un Azure Container Registry pour vous connecter à un Docker Hub ou à tout autre registre de conteneurs privé.


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

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


dockerRegistryEndpoint - Connexion au service du Registre Docker
string. facultatif. Utilisez quand containerregistrytype = Container Registry && command != logout.

Spécifie une connexion au service de registre Docker. Obligatoire pour les commandes qui s’authentifient à l’aide d’un registre.


azureSubscriptionEndpoint - Abonnement Azure
string. facultatif. Utilisez quand containerregistrytype = Azure Container Registry && command != logout.

Spécifie un abonnement Azure.


azureContainerRegistry - Registre de conteneurs Azure
string. facultatif. Utilisez quand containerregistrytype = Azure Container Registry && command != logout.

Spécifie un Azure Container Registry dans l’abonnement Azure sélectionné. L’image conteneur est générée et envoyée à ce registre de conteneurs.


command - Commande
string. Obligatoire. Valeurs autorisées : Build an image (build), Tag image (balise), Push an image (push), Run an image (exécuter), login, . logout Valeur par défaut : Build an image.

Spécifie la commande docker à exécuter.


dockerFile - Dockerfile
string. Nécessaire lorsque command = Build an image || command = build. Valeur par défaut : **/Dockerfile.

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


arguments - Arguments
string. facultatif. Utilisez quand command != login && command != logout.

Spécifie les arguments supplémentaires à passer au client Docker. L’utilisation de la valeur buildAndPush dans le paramètre de commande ignore la propriété arguments.


arguments - Arguments
string. facultatif. Utilisez quand command != Run an image && command != run && command != login && command != logout.

Spécifie les arguments supplémentaires à passer au client Docker. L’utilisation de la valeur buildAndPush dans le paramètre de commande ignore la propriété arguments.


pushMultipleImages - Envoyer (push) plusieurs images
boolean. facultatif. Utilisez quand command = Push an image || command = push. Valeur par défaut : false.

Spécifie une liste dans un fichier texte d’images Docker à envoyer (push). Répertoriez chaque nom d’image au format Imagename1:tag1 sur une ligne distincte. La liste d’un nom d’image sans étiquettes, par exemple Imagename2, envoie toutes les balises dans le Imagename2 conteneur.


tagMultipleImages - Étiqueter plusieurs images
boolean. facultatif. Utilisez quand command = Tag image || command = tag. Valeur par défaut : false.

Spécifie une liste de plusieurs balises d’image et d’images Docker à baliser dans un fichier texte. Répertoriez chaque nom d’image au format Imagename1:tag1 sur une ligne distincte. Les images répertoriées sans étiquette comme Imagename2 étant étiquetées comme étant les plus récentes par défaut.


imageName - Nom de l’image
string. Nécessaire lorsque command = Build an image || command = build || command = Run an image || command = run || pushMultipleImages = false || tagMultipleImages = false. Valeur par défaut : $(Build.Repository.Name):$(Build.BuildId).

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


imageNamesPath - Chemin d’accès aux noms d’images
string. Nécessaire lorsque tagMultipleImages = true || pushMultipleImages = true.

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. facultatif. Utilisez quand command = Build an image || command = build || command = Tag image || command = tag || command = Push an image || command = push || command = Run an image || command = run. Valeur par défaut : true.

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


qualifySourceImageName - Qualifier le nom de l’image source
boolean. facultatif. Utilisez quand command = Tag image || command = tag. Valeur par défaut : false.

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


includeSourceTags - Inclure des balises sources
boolean. facultatif. Utilisez quand command = Build an image || command = build || command = Tag image || command = tag || command = Push an image || command = push. Valeur par défaut : false.

Spécifie les balises Git à inclure lors de la génération ou de l’envoi (push) de l’image Docker.


includeLatestTag - Inclure la dernière balise
boolean. facultatif. Utilisez quand command = Build an image || command = build. Valeur par défaut : false.

Spécifie s’il faut utiliser la dernière balise lors de la génération de l’image Docker.


addDefaultLabels - Ajouter des étiquettes par défaut
boolean. facultatif. Utilisez quand addDefaultLabels = false. Valeur par défaut : true.

Spécifie s’il faut ajouter des métadonnées CI/CD à l’image conteneur à l’aide d’étiquettes Docker, telles que les informations de dépôt, de validation, de build et de mise en production.


addDefaultLabels - Ajouter des étiquettes par défaut
boolean. facultatif. Utilisez quand command = Build an image || command = build. Valeur par défaut : true.

Spécifie s’il faut ajouter des métadonnées CI/CD à l’image conteneur à l’aide d’étiquettes Docker, telles que les informations de dépôt, de validation, de build et de mise en production.


useDefaultContext - Utiliser le contexte de build par défaut
boolean. facultatif. Utilisez quand command = Build an image || command = build. Valeur par défaut : true.

Spécifie l’ajout ou la suppression du contexte de build au répertoire qui contient le fichier Docker.


buildContext - Contexte de génération
string. facultatif. Utilisez quand useDefaultContext = false.

Spécifie le chemin d’accès au contexte de génération.


imageDigestFile - Fichier de synthèse d’image
string. facultatif. Utilisez quand command = Push an image || command = push.

Spécifie le chemin d’accès à un fichier créé et rempli avec le condensé complet du référentiel d’images de l’image Docker qui a été poussée.


containerName - Nom du conteneur
string. facultatif. Utilisez quand command = Run an image || command = run.

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


ports - Ports
string. facultatif. Utilisez quand command = Run an image || command = run.

Spécifie les ports dans le conteneur Docker à publier sur l’hôte. Répertorier chaque host-port:container-port liaison sur une ligne distincte.


volumes - Volumes
string. facultatif. Utilisez quand command = Run an image || command = run.

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


envVars - Variables d’environnement
string. facultatif. Utilisez quand command = Run an image || command = run.

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


workingDirectory - Répertoire de travail
string. facultatif. Utilisez quand command = Run an image || command = run.

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


entrypointOverride - Remplacement du point d’entrée
string. facultatif. Utilisez quand command = Run an image || command = run.

Spécifie s’il faut remplacer le point d’entrée par défaut pour le conteneur Docker.


containerCommand - Commande conteneur
string. facultatif. Utilisez quand command = Run an image || command = run.

Spécifie une commande Docker run. La commande docker run crée d’abord une couche de 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.


containerCommand - Commande
string. facultatif. Utilisez quand command = Run an image || command = run.

Spécifie une commande Docker run. La commande docker run crée d’abord une couche de 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.


runInBackground - Exécuter en arrière-plan
boolean. facultatif. Utilisez quand command = Run an image || command = run. Valeur par défaut : true.

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


restartPolicy - Stratégie de redémarrage
string. Nécessaire lorsque runInBackground = true. Valeurs autorisées : no, onFailure (En cas d’échec), always, unlessStopped (sauf si elles sont arrêtées). Valeur par défaut : no.

Spécifie quand exécuter une stratégie de redémarrage.


maxRestartRetries - Nombre maximal de nouvelles tentatives de redémarrage
string. facultatif. Utilisez quand runInBackground = true && restartPolicy = onFailure.

Spécifie le nombre maximal de tentatives de redémarrage du démon Docker.


dockerHostEndpoint - Connexion au service hôte Docker
string. facultatif. Utilisez quand command != login && command != logout.

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. facultatif. Utilisez quand command != login && command != logout. Valeur par défaut : true.

La valeur par défaut modifie le nom de l’image Docker en fonction des conventions d’affectation de noms Docker. Par exemple, convertissez les caractères majuscules en minuscules et supprimez les espaces.


memoryLimit - Limite de mémoire
string. facultatif. Utilisez quand command != login && command != logout.

Spécifie la quantité maximale de mémoire disponible pour le conteneur sous la forme d’un entier avec des suffixes facultatifs comme 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 dans les étapes, les travaux et les étapes en aval.

DockerOutput
Stocke la sortie de la commande docker

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

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

DockerOutput
Stocke la sortie de la commande docker

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.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes None
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande Quelconque
Variables paramétrables Quelconque
Version de l’agent Toutes les versions d’agent prises en charge.
Catégorie de la tâche Build

Voir aussi