Docker@0 - Attività Docker v0

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

Nota

Docker@2 è una versione più recente di questa attività che semplifica l'attività rimuovendo gli input che possono essere passati come argomenti al comando.

Sintassi

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

Input

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

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

dockerRegistryConnection - Connessione del servizio registro Docker
Alias di input: dockerRegistryEndpoint. string. facoltativo. 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 di sistema.

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

Specifica una sottoscrizione di Azure.

azureContainerRegistry - Registro Azure Container
string. facoltativo. Usare quando containerregistrytype = Azure Container Registry.

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

action - Azione
string. Obbligatorio. Valori consentiti: Build an image, Push an imageRun a Docker commandTag imagesPush imagesRun an image. Valore predefinito: Build an image.

Specifica un'azione Docker.

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

Specifica il percorso del file Docker. L'attività usa il primo file Docker che trova 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.

buildArguments - Argomenti di compilazione
string. facoltativo. Usare quando action = Build an image.

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

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

Specifica il contesto di compilazione della directory contenente il file Docker.

context - Contesto di compilazione
string. facoltativo. 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 per compilare, eseguire o eseguire.

imageNamesPath - Percorso nomi immagini
string. Obbligatorio quando action == Tag images || action == Push images.

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

qualifyImageName - Nome immagine qualificato
boolean. facoltativo. 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 immagine qualificato con il nome host del servizio del registro Docker.

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

Specifica tag aggiuntivi per l'immagine Docker in fase di compilazione o push.

includeSourceTags - Includere tag di origine
boolean. facoltativo. 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. facoltativo. 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 di digest immagine
string. facoltativo. Usare quando action = Push an image || action = Push images.

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

containerName - Nome contenitore
string. facoltativo. Usare quando action = Run an image.

Specifica il nome del contenitore Docker da eseguire.

ports - Porte
string. facoltativo. Usare quando action = Run an image.

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

volumes - Volumi
string. facoltativo. Usare quando action = Run an image.

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

envVars - Variabili di ambiente
string. facoltativo. Usare quando action = Run an image.

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

workDir - Directory di lavoro
string. facoltativo. Usare quando action = Run an image.

Specifica la directory di lavoro per il contenitore Docker.

entrypoint - Override punto di ingresso
string. facoltativo. Usare quando action = Run an image.

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

containerCommand - Comando
string. facoltativo. Usare quando action = Run an image.

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

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

Specifica se eseguire il contenitore Docker in background.

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

Specifica un criterio di riavvio.

restartMaxRetries - Tentativi di riavvio massimo
string. facoltativo. 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 e gli argomenti Docker da eseguire. Ad esempio, rmi -f image-name rimuove un'immagine.

dockerHostEndpoint - Connessione del servizio host Docker
string.

Specifica una connessione al servizio host Docker. Impostazione predefinita dell'host dell'agente.

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

Se abilitato, modifica il nome dell'immagine Docker in base alle convenzioni di denominazione di Docker. Ad esempio, convertire i caratteri maiuscoli in minuscolo 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 intero con suffissi facoltativi, ad esempio 2GB.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

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

DockerOutput
Archivia l'output del comando docker.

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

Commenti

Docker@2 è una versione più recente di questa attività che semplifica l'attività rimuovendo gli input che possono essere passati come argomenti al comando.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	Tutte le versioni dell'agente supportate.
Categoria attività	Compilazione

Vedi anche

• Docker@2