Docker@0 – Tarefa do Docker v0

Crie, marque, pressione, execute imagens do Docker ou execute um comando do Docker. Use essa tarefa com o Docker ou o Registro de Contêiner do Azure.

Crie, marque, pressione, execute imagens do Docker ou execute um comando do Docker. Use essa tarefa com o Docker ou o Registro de Contêiner do Azure.

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

containerregistrytype - tipo de registro de contêiner
string. Obrigatório Valores permitidos: Azure Container Registry, Container Registry. Valor padrão: Azure Container Registry.

Selecione 'Registro de Contêiner do Azure' para se conectar a ele usando uma Conexão de Serviço do Azure. Selecione 'Registro de contêiner' para se conectar ao Hub do Docker ou a qualquer outro registro de contêiner privado.

dockerRegistryConnection - de Conexão do Serviço de Registro do Docker
Alias de entrada: dockerRegistryEndpoint. string. Opcional. Use quando containerregistrytype = Container Registry.

Especifica uma conexão de serviço do Registro do Docker. Necessário para comandos que precisam ser autenticados com um registro.

azureSubscription - assinatura do Azure
Alias de entrada: azureSubscriptionEndpoint. string. Opcional. Use quando containerregistrytype = Azure Container Registry.

Especifica uma assinatura do Azure.

azureContainerRegistry - do Registro de Contêiner do Azure
string. Opcional. Use quando containerregistrytype = Azure Container Registry.

Especifica um Registro de Contêiner do Azure na Assinatura do Azure selecionada. A imagem do contêiner é criada e enviada por push para esse registro de contêiner.

de Ação action -
string. Obrigatório Valores permitidos: Build an image, Tag images, Push an image, Push images, Run an image, Run a Docker command. Valor padrão: Build an image.

Especifica uma ação do Docker.

de arquivo do Docker dockerFile -
string. Necessário quando action = Build an image. Valor padrão: **/Dockerfile.

Especifica o caminho para o arquivo do Docker. A tarefa usa o primeiro arquivo do Docker encontrado para criar a imagem.

addBaseImageData - Adicionar metadados de imagem base a imagens
boolean. Valor padrão: true.

O valor padrão adiciona dados de imagem base, como o nome da imagem base e o resumo para ajudar na rastreabilidade. Você pode recusar definindo o valor como false.

buildArguments - criar argumentos
string. Opcional. Use quando action = Build an image.

Especifica variáveis de tempo de build para o arquivo do Docker. Formate cada par name=value em uma nova linha.

defaultContext - usar de contexto de build padrão
boolean. Opcional. Use quando action = Build an image. Valor padrão: true.

Especifica o contexto de build do diretório que contém o arquivo do Docker.

context - de contexto de build
string. Opcional. Use quando action = Build an image && defaultContext = false.

Especifica o caminho para o contexto de build.

de nome da imagem imageName -
string. Necessário quando action == Build an image || action == Push an image || action == Run an image. Valor padrão: $(Build.Repository.Name):$(Build.BuildId).

Especifica o nome da imagem do Docker a ser criada, enviada por push ou executada.

imageNamesPath - caminho de nomes de imagem
string. Necessário quando action == Tag images || action == Push images.

Especifica o caminho para um arquivo de texto que contém os nomes das imagens do Docker para marcar ou enviar por push. Liste cada nome de imagem em uma linha separada.

qualifyImageName - qualificar o nome da imagem
boolean. Opcional. Use quando action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image. Valor padrão: true.

Especifica um nome de imagem de qualificação com o nome do host da conexão de serviço do Registro do Docker.

additionalImageTags - marcas de imagem adicionais
string. Opcional. Use quando action = Build an image || action = Tag images || action = Push an image || action = Push images.

Especifica marcas adicionais para a imagem do Docker que está sendo criada ou enviada por push.

includeSourceTags - incluir marcas de origem
boolean. Opcional. Use quando action = Build an image || action = Tag image || action = Push an image || action = Push images. Valor padrão: false.

Especifica se as marcas git devem ser incluídas ao criar ou enviar por push a imagem do Docker.

includeLatestTag - incluir a marca mais recente
boolean. Opcional. Use quando action = Build an image || action = Push an image || action = Push images. Valor padrão: false.

Especifica se a marca de mais recente do deve ser incluída ao criar ou enviar por push a imagem do Docker.

de arquivo do imageDigestFile - Image Digest
string. Opcional. Use quando action = Push an image || action = Push images.

Especifica o caminho para um arquivo que é criado e preenchido com o resumo completo do repositório de imagem da imagem do Docker que foi enviada por push.

de nome do contêiner containerName -
string. Opcional. Use quando action = Run an image.

Especifica o nome do contêiner do Docker a ser executado.

portas ports -
string. Opcional. Use quando action = Run an image.

Especifica portas no contêiner do Docker a serem publicadas no host. Liste cada associação host-port:container-port em uma nova linha.

volumes - volumes
string. Opcional. Use quando action = Run an image.

Especifica os volumes a serem montados do host. Liste cada host-dir:container-dir em uma nova linha.

variáveis de ambiente envVars -
string. Opcional. Use quando action = Run an image.

Especifica variáveis de ambiente para o contêiner do Docker. Liste cada par name=value em uma nova linha.

do Diretório de Trabalho do
string. Opcional. Use quando action = Run an image.

Especifica o diretório de trabalho para o contêiner do Docker.

substituição de ponto de entrada entrypoint -
string. Opcional. Use quando action = Run an image.

Especifica uma substituição do ponto de entrada padrão para o contêiner do Docker.

comando containerCommand -
string. Opcional. Use quando action = Run an image.

Especifica um comando de execução do Docker. O comando de execução do Docker primeiro cria uma camada de contêiner gravável sobre a imagem especificada e, em seguida, inicia-a usando o comando de execução especificado. Por exemplo, se a imagem contiver um aplicativo Web Simples do Python Flask, você poderá especificar python app.py para iniciar o aplicativo Web.

detached - executar em segundo plano
boolean. Opcional. Use quando action = Run an image. Valor padrão: true.

Especifica se o contêiner do Docker deve ser executado em segundo plano.

restartPolicy - de Política de Reinicialização
string. Necessário quando action = Run an image && detached = true. Valores permitidos: no, onFailure (Em falha), always, unlessStopped (a menos que parado). Valor padrão: no.

Especifica uma política de reinicialização.

restartMaxRetries - tentativas máximas de reinicialização
string. Opcional. Use quando action = Run an image && detached = true && restartPolicy = onFailure.

Especifica o número máximo de tentativas de reinicialização que o daemon do Docker tenta.

comando customCommand -
string. Necessário quando action = Run a Docker command.

Especifica o comando do Docker e os argumentos a serem executados. Por exemplo, rmi -f image-name remove uma imagem.

dockerHostEndpoint - de Conexão do Serviço de Host do Docker
string.

Especifica uma conexão de serviço de host do Docker. O padrão é o host do agente.

enforceDockerNamingConvention - Forçar o nome da imagem para seguir a convenção de nomenclatura do Docker
boolean. Valor padrão: true.

Se habilitado, modifica o nome da imagem do Docker de acordo com as convenções de nomenclatura do Docker. Por exemplo, converta caracteres maiúsculas em minúsculas e remova espaços.

do Diretório de Trabalho do
Alias de entrada: cwd. string. Valor padrão: $(System.DefaultWorkingDirectory).

Especifica o diretório de trabalho para o comando docker.

memory - limite de memória
string.

Especifica a quantidade máxima de memória disponível para o contêiner como um inteiro com sufixos opcionais, por exemplo, 2GB.

Essa tarefa define as seguintes variáveis de saída , que você pode consumir em etapas downstream, trabalhos e estágios.

DockerOutput
Armazena a saída do comando docker.

DockerOutputPath
o caminho do arquivo que contém a saída do comando de build.