Docker@0 – Docker v0-Aufgabe

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

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.

Eingänge

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

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

dockerRegistryConnection - Verbindung mit dem Docker-Registrierungsdienst
Eingabealias: dockerRegistryEndpoint. string. Wahlfrei. Wird verwendet, wenn containerregistrytype = Container Registry.

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

azureSubscription - Azure-Abonnement
Eingabealias: azureSubscriptionEndpoint. string. Wahlfrei. Wird verwendet, wenn containerregistrytype = Azure Container Registry.

Gibt ein Azure-Abonnement an.

azureContainerRegistry - Azure Container Registry
string. Wahlfrei. Wird verwendet, wenn containerregistrytype = Azure Container Registry.

Gibt eine Azure-Containerregistrierung im ausgewählten Azure-Abonnement an. Das Containerimage wird erstellt und dann an diese Containerregistrierung übertragen.

action - Aktion
string. Erforderlich. Zulässige Werte: Build an image, Tag images, Push an image, Push images, Run an image, 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 Docker-Datei, die zum Erstellen des Images gefunden wird.

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

Der Standardwert fügt Basisbilddaten hinzu, z. B. den Basisbildnamen und den Digest zur Unterstützung der Rückverfolgbarkeit. Sie können dies deaktivieren, indem Sie den Wert auf falsefestlegen.

buildArguments - Buildargumente
string. Wahlfrei. Wird verwendet, wenn action = Build an image.

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

defaultContext - Standardbuildkontext- verwenden
boolean. Wahlfrei. Wird verwendet, wenn action = Build an image. Standardwert: true.

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

context - Buildkontext-
string. Wahlfrei. Wird verwendet, 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, übertragen oder ausgeführt werden soll.

imageNamesPath - Pfad für 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 kategorisiert oder pushen sollen. Listen Sie jeden Bildnamen in einer separaten Zeile auf.

qualifyImageName - Qualifizieren des Bildnamens
boolean. Wahlfrei. Wird verwendet, 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 des Docker-Registrierungsdiensts an.

additionalImageTags - zusätzliche Bildtags
string. Wahlfrei. Wird verwendet, 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 pusht wird.

includeSourceTags - Source Tags einschließen
boolean. Wahlfrei. Wird verwendet, wenn action = Build an image || action = Tag image || action = Push an image || action = Push images. Standardwert: false.

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

includeLatestTag - Neuesten Tag- einschließen
boolean. Wahlfrei. Wird verwendet, wenn action = Build an image || action = Push an image || action = Push images. Standardwert: false.

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

imageDigestFile - Image Digest-Datei
string. Wahlfrei. Wird verwendet, wenn action = Push an image || action = Push images.

Gibt den Pfad zu einer Datei an, die erstellt und mit dem vollständigen Image-Repositorydigest des Docker-Images aufgefüllt wird, das pusht wurde.

containerName - Containername
string. Wahlfrei. Wird verwendet, wenn action = Run an image.

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

ports - Häfen
string. Wahlfrei. Wird verwendet, wenn action = Run an image.

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

volumes - Inhalte
string. Wahlfrei. Wird verwendet, wenn action = Run an image.

Gibt die Volumes an, die vom Host bereitgestellt werden sollen. Jede host-dir:container-dir in einer neuen Zeile auflisten.

envVars - Umgebungsvariablen
string. Wahlfrei. Wird verwendet, 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. Wahlfrei. Wird verwendet, wenn action = Run an image.

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

entrypoint - Eintragspunktüberschreibung
string. Wahlfrei. Wird verwendet, wenn action = Run an image.

Gibt eine Außerkraftsetzung des Standardeinstiegspunkts für den Docker-Container an.

containerCommand - Befehl
string. Wahlfrei. Wird verwendet, wenn action = Run an image.

Gibt einen Docker-Ausführungsbefehl an. Der Befehl "Docker run" erstellt zunächst eine beschreibbare Containerebene über das angegebene Image und startet sie dann mit dem angegebenen Ausführungsbefehl. Wenn das Bild beispielsweise eine einfache Python Flask-Webanwendung enthält, können Sie python app.py angeben, um die Webanwendung zu starten.

detached - Im Hintergrund ausführen
boolean. Wahlfrei. Wird verwendet, 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 Neustartversuche
string. Wahlfrei. Wird verwendet, wenn action = Run an image && detached = true && restartPolicy = onFailure.

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

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

Gibt den auszuführenden Docker-Befehl und die auszuführenden Argumente an. Beispielsweise entfernt rmi -f image-name ein Bild.

dockerHostEndpoint - Docker-Hostdienstverbindung
string.

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

enforceDockerNamingConvention - Erzwingen des Imagenamens nach der Docker-Benennungskonvention
boolean. Standardwert: true.

Wenn diese Option aktiviert ist, wird der Docker-Imagename entsprechend den Docker-Benennungskonventionen geändert. 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 - Speicherbeschränkung
string.

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

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Mit dieser Aufgabe werden die folgenden Ausgabevariablendefiniert, die Sie in nachgeschalteten Schritten, Aufträgen und Phasen verwenden können.

DockerOutput
Speichert die Ausgabe des Docker-Befehls.

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

Bemerkungen

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, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	Alle unterstützten Agentversionen.
Vorgangskategorie	Bauen

Siehe auch

• Docker@2