Docker@0: Docker v0-Aufgabe

Erstellen, Markieren, Pushen, Ausführen von Docker-Images oder Ausführen eines Docker-Befehls. Verwenden Sie diese Aufgabe mit Docker oder der Azure Container Registry.

Hinweis

Docker@2 ist eine neuere Version dieser Aufgabe, die die Aufgabe vereinfacht, indem Eingaben entfernt werden, die als Argumente an den Befehl übergeben werden können.

Syntax

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

Eingaben

containerregistrytype - Containerregistrierungstyp
string. Erforderlich. Zulässige Werte: Azure Container Registry, Container Registry. Standardwert. Azure Container Registry.

Wählen Sie "Azure Container Registry" aus, um mithilfe einer Azure-Dienstverbindung eine Verbindung mit dem Dienst herzustellen. Wählen Sie "Containerregistrierung" aus, um eine Verbindung mit Docker Hub oder einer anderen privaten Containerregistrierung herzustellen.

dockerRegistryConnection - Docker Registry Service-Verbindung
Eingabealias: dockerRegistryEndpoint. string. Optional. Verwenden Sie , wenn containerregistrytype = Container Registry.

Gibt eine Docker-Registrierungsdienstverbindung an. Erforderlich für Befehle, die bei einer Registrierung authentifiziert werden müssen.

azureSubscription - Azure-Abonnement
Eingabealias: azureSubscriptionEndpoint. string. Optional. Verwenden Sie , wenn containerregistrytype = Azure Container Registry.

Gibt ein Azure-Abonnement an.

azureContainerRegistry - Azure Container Registry
string. Optional. Verwenden Sie , wenn containerregistrytype = Azure Container Registry.

Gibt eine Azure Container Registry im ausgewählten Azure-Abonnement an. Das Containerimage wird erstellt und dann in diese Containerregistrierung gepusht.

action - Aktion
string. Erforderlich. Zulässige Werte: Build an image, Tag images, Push an image, Run an imagePush images, , . Run a Docker command Standardwert. Build an image.

Gibt eine Docker-Aktion an.

dockerFile - Docker-Datei
string. Erforderlich, wenn action = Build an image. Standardwert. **/Dockerfile.

Gibt den Pfad zur Docker-Datei an. Die Aufgabe verwendet die erste gefundene Docker-Datei, um das Image zu erstellen.

addBaseImageData - Hinzufügen von Basisimagemetadaten zu Bildern
boolean. Standardwert. true.

Der Standardwert fügt Basisimagedaten wie den Namen des Basisimages und den Digest hinzu, um die Rückverfolgbarkeit zu erleichtern. Sie können dies deaktivieren, indem Sie den Wert auf falsefestlegen.

buildArguments - Buildargumente
string. Optional. Verwenden Sie , wenn action = Build an image.

Gibt Buildzeitvariablen für die Docker-Datei an. Formatieren Sie jedes name=value Paar in einer neuen Zeile.

defaultContext - Verwenden des Standardbuildkontexts
boolean. Optional. Verwenden Sie , wenn action = Build an image. Standardwert. true.

Gibt den Buildkontext des Verzeichnisses an, das die Docker-Datei enthält.

context - Buildkontext
string. Optional. Verwenden Sie , wenn action = Build an image && defaultContext = false.

Gibt den Pfad zum Buildkontext an.

imageName - Bildname
string. Erforderlich, wenn action == Build an image || action == Push an image || action == Run an image. Standardwert. $(Build.Repository.Name):$(Build.BuildId).

Gibt den Namen des Docker-Images an, das erstellt, gepusht oder ausgeführt werden soll.

imageNamesPath - Pfad zu Bildnamen
string. Erforderlich, wenn action == Tag images || action == Push images.

Gibt den Pfad zu einer Textdatei an, die die Namen der docker-Images enthält, die gekennzeichnet oder gepusht werden sollen. Listen Sie jeden Imagenamen in einer separaten Zeile auf.

qualifyImageName - Qualifizieren des Imagenamens
boolean. Optional. Verwenden Sie , wenn action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image. Standardwert. true.

Gibt einen qualifizierten Imagenamen mit dem Hostnamen der Docker-Registrierungsdienstverbindung an.

additionalImageTags - Zusätzliche Bildtags
string. Optional. Verwenden Sie , wenn action = Build an image || action = Tag images || action = Push an image || action = Push images.

Gibt zusätzliche Tags für das Docker-Image an, das erstellt oder gepusht wird.

includeSourceTags - Einschließen von Quelltags
boolean. Optional. Verwenden Sie , wenn action = Build an image || action = Tag image || action = Push an image || action = Push images. Standardwert. false.

Gibt an, ob Beim Erstellen oder Pushen des Docker-Images Git-Tags eingeschlossen werden sollen.

includeLatestTag - Neuestes Tag einschließen
boolean. Optional. Verwenden Sie , wenn action = Build an image || action = Push an image || action = Push images. Standardwert. false.

Gibt an, ob beim Erstellen oder Pushen des Docker-Images das neueste Tag eingeschlossen werden soll.

imageDigestFile - Image Digest-Datei
string. Optional. Verwenden Sie , wenn action = Push an image || action = Push images.

Gibt den Pfad zu einer Datei an, die erstellt und mit dem vollständigen Imagerepository-Digest des Docker-Images aufgefüllt wird, das per Push übertragen wurde.

containerName - Containername
string. Optional. Verwenden Sie , wenn action = Run an image.

Gibt den Namen des auszuführenden Docker-Containers an.

ports - Ports
string. Optional. Verwenden Sie , wenn action = Run an image.

Gibt Ports im Docker-Container an, die auf dem Host veröffentlicht werden sollen. Listen Sie jede host-port:container-port Bindung in einer neuen Zeile auf.

volumes - Volumes
string. Optional. Verwenden Sie , wenn action = Run an image.

Gibt die Volumes an, die vom Host bereitgestellt werden sollen. Listen Sie jede host-dir:container-dir in einer neuen Zeile auf.

envVars - Umgebungsvariablen
string. Optional. Verwenden Sie , wenn action = Run an image.

Gibt Umgebungsvariablen für den Docker-Container an. Listen Sie jedes name=value Paar in einer neuen Zeile auf.

workDir - Arbeitsverzeichnis
string. Optional. Verwenden Sie , wenn action = Run an image.

Gibt das Arbeitsverzeichnis für den Docker-Container an.

entrypoint - Überschreiben des Einstiegspunkts
string. Optional. Verwenden Sie , wenn action = Run an image.

Gibt eine Überschreibung des Standardeinstiegspunkts für den Docker-Container an.

containerCommand - Befehl
string. Optional. Verwenden Sie , wenn action = Run an image.

Gibt einen Docker-Ausführungsbefehl an. Der Befehl docker run erstellt zunächst eine schreibbare Containerebene über dem angegebenen Image und startet sie dann mithilfe des angegebenen Ausführungsbefehls. Wenn das Bild beispielsweise eine einfache Python Flask-Webanwendung enthält, können Sie angeben python app.py , dass die Webanwendung gestartet werden soll.

detached - Im Hintergrund ausführen
boolean. Optional. Verwenden Sie , wenn action = Run an image. Standardwert. true.

Gibt an, ob der Docker-Container im Hintergrund ausgeführt werden soll.

restartPolicy - Richtlinie neu starten
string. Erforderlich, wenn action = Run an image && detached = true. Zulässige Werte: no, onFailure (Bei Fehler), always, unlessStopped (sofern nicht beendet). Standardwert. no.

Gibt eine Neustartrichtlinie an.

restartMaxRetries - Maximale Anzahl von Neustartversuchen
string. Optional. Verwenden Sie , wenn action = Run an image && detached = true && restartPolicy = onFailure.

Gibt die maximale Anzahl von Neustartversuchen an, die der Docker-Daemon versucht.

customCommand - Befehl
string. Erforderlich, wenn action = Run a Docker command.

Gibt den Docker-Befehl und die auszuführenden Argumente an. Entfernt z. B. rmi -f image-name ein Bild.

dockerHostEndpoint - Docker Host Service-Verbindung
string.

Gibt eine Docker-Hostdienstverbindung an. Standardmäßig wird der Host des Agents verwendet.

enforceDockerNamingConvention - Erzwingen des Imagenamens, dass die Docker-Benennungskonvention folgt
boolean. Standardwert. true.

Wenn aktiviert, ändert der Name des Docker-Images entsprechend den Docker-Benennungskonventionen. Konvertieren Sie z. B. Großbuchstaben in Kleinbuchstaben, und entfernen Sie Leerzeichen.

workingDirectory - Arbeitsverzeichnis
Eingabealias: cwd. string. Standardwert. $(System.DefaultWorkingDirectory).

Gibt das Arbeitsverzeichnis für den Docker-Befehl an.

memory - Arbeitsspeicherlimit
string.

Gibt die maximale Für den Container verfügbare Arbeitsspeichermenge als ganze Zahl mit optionalen Suffixen an, z. B 2GB. .

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Diese Aufgabe definiert die folgenden Ausgabevariablen, die Sie in nachgelagerten Schritten, Aufträgen und Phasen nutzen können.

DockerOutput
Speichert die Ausgabe des Docker-Befehls.

DockerOutputPath
Der Pfad der Datei, die die Ausgabe des Buildbefehls enthält.

Hinweise

Docker@2 ist eine neuere Version dieser Aufgabe, die die Aufgabe vereinfacht, indem Eingaben entfernt werden, die als Argumente an den Befehl übergeben werden können.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	Alle unterstützten Agent-Versionen.
Aufgabenkategorie	Entwickeln

Weitere Informationen

• Docker@2