Docker@0 - Tarefa Docker v0

Crie, marque, envie, execute imagens do Docker ou execute um comando do Docker. Use esta tarefa com o Docker ou o registro do Contêiner do Azure.

Observação

Docker@2 é uma versão mais recente desta tarefa que simplifica a tarefa removendo entradas que podem ser passadas como argumentos para o comando.

Crie, marque, envie, execute imagens do Docker ou execute um comando do Docker. Use esta tarefa com o Docker ou o registro do Contêiner do Azure.

Observação

Docker@2 é uma versão mais recente desta tarefa que simplifica a tarefa removendo entradas que podem ser passadas como argumentos para o comando.

Sintaxe

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

Insumos

containerregistrytype - Tipo de Registro de Contêiner
string. Obrigatório. Valores permitidos: Azure Container Registry, Container Registry. Valor padrão: Azure Container Registry.

Selecione 'Azure Container Registry' para se conectar a ele usando uma Conexão de Serviço do Azure. Selecione 'Registro de contêiner' para se conectar ao Docker Hub 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 de registro do Docker. Necessário para comandos que precisam ser autenticados com um registro.


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

Especifica uma assinatura do Azure.


azureContainerRegistry - 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, em seguida, enviada por push para esse registro de contêiner.


action - Ação
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.


dockerFile - Arquivo Docker
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 de base à(s) imagem(ões)
boolean. Valor padrão: true.

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


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

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


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

Especifica o contexto de compilação do diretório que contém o arquivo Docker.


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

Especifica o caminho para o contexto de compilação.


imageName - Nome da imagem
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 - de 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 a serem marcadas ou enviadas. 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 qualificado com o nome de host da conexão do serviço de registro do Docker.


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

Especifica tags adicionais para a imagem do Docker que está sendo criada ou enviada.


includeSourceTags - incluir tags 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 tags Git devem ser incluídas ao criar ou enviar por push a imagem do Docker.


includeLatestTag - Incluir de tags mais recentes
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 deve ser incluída ao criar ou enviar por push a imagem do Docker.


imageDigestFile - do arquivo 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 imagens da imagem do Docker que foi enviada por push.


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

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


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

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


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

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


envVars - Variáveis de ambiente
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.


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

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


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

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


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

Especifica um comando de execução do Docker. O comando docker run primeiro cria uma camada de contêiner gravável sobre a imagem especificada e, em seguida, inicia-a usando o comando run especificado. Por exemplo, se a imagem contiver um aplicativo web Python Flask simples, você pode 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 - Política de reinicialização
string. Necessário quando action = Run an image && detached = true. Valores permitidos: no, onFailure (Em falha), alwaysunlessStopped (A menos que parado). Valor padrão: no.

Especifica uma política de reinicialização.


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

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


customCommand - de comando
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 a 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úsculos em minúsculos e remova espaços.


workingDirectory - Diretório de Trabalho
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.


Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

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

DockerOutput
Armazena a saída do comando docker.

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

Observações

Docker@2 é uma versão mais recente desta tarefa que simplifica a tarefa removendo entradas que podem ser passadas como argumentos para o comando.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria de tarefa Construir

Ver também