Docker@0 - Attività Docker v0

Compilare, contrassegnare, eseguire il push, eseguire immagini Docker o eseguire un comando Docker. Usare questa attività con Docker o il Registro Azure Container.

Compilare, contrassegnare, eseguire il push, eseguire immagini Docker o eseguire un comando Docker. Usare questa attività con Docker o il Registro Azure Container.

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

tipo di registro contenitori containerregistrytype -
string. Obbligatorio. Valori consentiti: Azure Container Registry, Container Registry. Valore predefinito: Azure Container Registry

Selezionare "Registro Azure Container" per connettersi usando una connessione al servizio di Azure. Selezionare "Registro contenitori" per connettersi all'hub Docker o a qualsiasi altro registro contenitori privato.

dockerRegistryConnection - di connessione al servizio registro Docker
Alias di input: dockerRegistryEndpoint. string. Opzionale. Usare quando containerregistrytype = Container Registry.

Specifica una connessione al servizio del Registro di sistema Docker. Obbligatorio per i comandi che devono eseguire l'autenticazione con un registro.

azureSubscription - sottoscrizione di Azure
Alias di input: azureSubscriptionEndpoint. string. Opzionale. Usare quando containerregistrytype = Azure Container Registry.

Specifica una sottoscrizione di Azure.

azureContainerRegistry - registro Azure Container
string. Opzionale. Usare quando containerregistrytype = Azure Container Registry.

Specifica un Registro Azure Container nella sottoscrizione di Azure selezionata. L'immagine del contenitore viene compilata e quindi inserita in questo registro contenitori.

action - 'azione
string. Obbligatorio. Valori consentiti: Build an image, Tag images, Push an image, Push images, Run an image, Run a Docker command. Valore predefinito: Build an image

Specifica un'azione Docker.

dockerFile - file Docker
string. Obbligatorio quando action = Build an image. Valore predefinito: **/Dockerfile

Specifica il percorso del file Docker. L'attività usa il primo file Docker trovato per compilare l'immagine.

addBaseImageData - Aggiungere metadati dell'immagine di base alle immagini
boolean. Valore predefinito: true

Il valore predefinito aggiunge dati dell'immagine di base, ad esempio, il nome dell'immagine di base e il digest per facilitare la tracciabilità. È possibile rifiutare esplicitamente impostando il valore su false.

argomenti di compilazione buildArguments -
string. Opzionale. Usare quando action = Build an image.

Specifica le variabili in fase di compilazione per il file Docker. Formattare ogni coppia di name=value in una nuova riga.

defaultContext - usare il contesto di compilazione predefinito
boolean. Opzionale. Usare quando action = Build an image. Valore predefinito: true

Specifica il contesto di compilazione della directory che contiene il file Docker.

context - del contesto di compilazione
string. Opzionale. Usare quando action = Build an image && defaultContext = false.

Specifica il percorso del contesto di compilazione.

imageName - nome immagine
string. Obbligatorio quando action == Build an image || action == Push an image || action == Run an image. Valore predefinito: $(Build.Repository.Name):$(Build.BuildId)

Specifica il nome dell'immagine Docker da compilare, eseguire il push o l'esecuzione.

imageNamesPath - percorso nomi immagine
string. Obbligatorio quando action == Tag images || action == Push images.

Specifica il percorso di un file di testo che contiene i nomi delle immagini Docker da contrassegnare o eseguire il push. Elencare ogni nome di immagine in una riga separata.

qualifyImageName - nome immagine idoneo
boolean. Opzionale. Usare quando action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image. Valore predefinito: true

Specifica un nome di immagine idoneo con il nome host della connessione al servizio registro Docker.

additionalImageTags - tag di immagine aggiuntivi
string. Opzionale. Usare quando action = Build an image || action = Tag images || action = Push an image || action = Push images.

Specifica tag aggiuntivi per l'immagine Docker compilata o sottoposta a push.

includeSourceTags - includere tag di origine
boolean. Opzionale. Usare quando action = Build an image || action = Tag image || action = Push an image || action = Push images. Valore predefinito: false

Specifica se includere tag Git durante la compilazione o il push dell'immagine Docker.

includeLatestTag - includi tag più recenti
boolean. Opzionale. Usare quando action = Build an image || action = Push an image || action = Push images. Valore predefinito: false

Specifica se includere il tag più recente durante la compilazione o il push dell'immagine Docker.

imageDigestFile - file digest immagine
string. Opzionale. Usare quando action = Push an image || action = Push images.

Specifica il percorso di un file creato e popolato con il digest completo del repository di immagini dell'immagine Docker di cui è stato eseguito il push.

nome contenitore containerName -
string. Opzionale. Usare quando action = Run an image.

Specifica il nome del contenitore Docker da eseguire.

ports - porte
string. Opzionale. Usare quando action = Run an image.

Specifica le porte nel contenitore Docker da pubblicare nell'host. Elencare ogni host-port:container-port binding in una nuova riga.

volumi volumes -
string. Opzionale. Usare quando action = Run an image.

Specifica i volumi da montare dall'host. Elencare ogni host-dir:container-dir in una nuova riga.

variabili di ambiente envVars -
string. Opzionale. Usare quando action = Run an image.

Specifica le variabili di ambiente per il contenitore Docker. Elencare ogni coppia di name=value in una nuova riga.

workDir - directory di lavoro
string. Opzionale. Usare quando action = Run an image.

Specifica la directory di lavoro per il contenitore Docker.

entrypoint - override del punto di ingresso
string. Opzionale. Usare quando action = Run an image.

Specifica un override del punto di ingresso predefinito per il contenitore Docker.

containerCommand - comando
string. Opzionale. Usare quando action = Run an image.

Specifica un comando docker run. Il comando docker run crea innanzitutto un livello contenitore scrivibile sull'immagine specificata e quindi lo avvia usando il comando run specificato. Ad esempio, se l'immagine contiene una semplice applicazione Web Python Flask, è possibile specificare python app.py per avviare l'applicazione Web.

detached - esecuzione in background
boolean. Opzionale. Usare quando action = Run an image. Valore predefinito: true

Specifica se eseguire il contenitore Docker in background.

restartPolicy - di criteri di riavvio
string. Obbligatorio quando action = Run an image && detached = true. Valori consentiti: no, onFailure (in caso di errore), always, unlessStopped (a meno che non sia stato arrestato). Valore predefinito: no

Specifica un criterio di riavvio.

restartMaxRetries - numero massimo di tentativi di riavvio
string. Opzionale. Usare quando action = Run an image && detached = true && restartPolicy = onFailure.

Specifica il numero massimo di tentativi di riavvio tentati dal daemon Docker.

customCommand - comando
string. Obbligatorio quando action = Run a Docker command.

Specifica il comando Docker e gli argomenti da eseguire. Ad esempio, rmi -f image-name rimuove un'immagine.

dockerHostEndpoint - connessione al servizio host Docker
string.

Specifica una connessione al servizio host Docker. L'impostazione predefinita è l'host dell'agente.

enforceDockerNamingConvention - Forzare il nome dell'immagine a seguire la convenzione di denominazione di Docker
boolean. Valore predefinito: true

Se abilitata, modifica il nome dell'immagine Docker in base alle convenzioni di denominazione docker. Ad esempio, convertire i caratteri maiuscoli in lettere minuscole e rimuovere spazi.

workingDirectory - directory di lavoro
Alias di input: cwd. string. Valore predefinito: $(System.DefaultWorkingDirectory)

Specifica la directory di lavoro per il comando Docker.

memory - limite di memoria
string.

Specifica la quantità massima di memoria disponibile per il contenitore come numero intero con suffissi facoltativi, ad esempio 2GB.

Questa attività definisce le variabili di output seguenti , che è possibile utilizzare nei passaggi downstream, nei processi e nelle fasi.

DockerOutput
Archivia l'output del comando Docker.

DockerOutputPath
Percorso del file che contiene l'output del comando di compilazione.