DockerCompose@1 - Tarefa do Docker Compose v1

Compilar, efetuar push ou executar aplicativos docker de vários contêineres. A tarefa pode ser usada com o Registro de Contêiner do Docker ou do Azure.

# Docker Compose v1
# Build, push or run multi-container Docker applications. Task can be used with Docker or Azure Container registry.
- task: DockerCompose@1
  inputs:
    containerregistrytype: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required. Container Registry Type. Default: Azure Container Registry.
    #dockerRegistryEndpoint: # string. 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. 
    dockerComposeFile: '**/docker-compose.yml' # string. Required. Docker Compose File. Default: **/docker-compose.yml.
    #additionalDockerComposeFiles: # string. Additional Docker Compose Files. 
    #dockerComposeFileArgs: # string. Environment Variables. 
    #projectName: '$(Build.Repository.Name)' # string. Project Name. Default: $(Build.Repository.Name).
    #qualifyImageNames: true # boolean. Qualify Image Names. Default: true.
    action: 'Run a Docker Compose command' # 'Build services' | 'Push services' | 'Run services' | 'Run a specific service' | 'Lock services' | 'Write service image digests' | 'Combine configuration' | 'Run a Docker Compose command'. Required. Action. Default: Run a Docker Compose command.
    #additionalImageTags: # string. Optional. Use when action = Build services || action = Push services. Additional Image Tags. 
    #includeSourceTags: false # boolean. Optional. Use when action = Build services || action = Push services. Include Source Tags. Default: false.
    #includeLatestTag: false # boolean. Optional. Use when action = Build services || action = Push services. Include Latest Tag. Default: false.
    #buildImages: true # boolean. Optional. Use when action = Run services. Build Images. Default: true.
    #serviceName: # string. Required when action = Run a specific service. Service Name. 
    #containerName: # string. Optional. Use when action = Run a specific service. Container Name. 
    #ports: # string. Optional. Use when action = Run a specific service. Ports. 
    #workingDirectory: # string. Alias: workDir. Optional. Use when action = Run a specific service. Working Directory. 
    #entrypoint: # string. Optional. Use when action = Run a specific service. Entry Point Override. 
    #containerCommand: # string. Optional. Use when action = Run a specific service. Command. 
    #detached: true # boolean. Optional. Use when action = Run services || action = Run a specific service. Run in Background. Default: true.
    #abortOnContainerExit: true # boolean. Optional. Use when action = Run services && detached == false. Abort on Container Exit. Default: true.
    #imageDigestComposeFile: '$(Build.StagingDirectory)/docker-compose.images.yml' # string. Required when action = Write service image digests. Image Digest Compose File. Default: $(Build.StagingDirectory)/docker-compose.images.yml.
    #removeBuildOptions: false # boolean. Optional. Use when action = Lock services || action = Combine configuration. Remove Build Options. Default: false.
    #baseResolveDirectory: # string. Optional. Use when action = Lock services || action = Combine configuration. Base Resolve Directory. 
    #outputDockerComposeFile: '$(Build.StagingDirectory)/docker-compose.yml' # string. Required when action = Lock services || action = Combine configuration. Output Docker Compose File. Default: $(Build.StagingDirectory)/docker-compose.yml.
    #dockerComposeCommand: # string. Required when action = Run a Docker Compose command. Command. 
    #arguments: # string. Optional. Use when action != Lock services && action != Combine configuration && action != Write service image digests. Arguments. 
  # Advanced Options
    #dockerHostEndpoint: # string. Docker Host Service Connection. 
    #nopIfNoDockerComposeFile: false # boolean. No-op if no Docker Compose File. Default: false.
    #requireAdditionalDockerComposeFiles: false # boolean. Require Additional Docker Compose Files. Default: false.
    #currentWorkingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Working Directory. Default: $(System.DefaultWorkingDirectory).
    #dockerComposePath: # string. Docker Compose executable Path.

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

Selecione um tipo de registro de contêiner.

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

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

Selecione uma assinatura do Azure.

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

Selecione um Registro de Contêiner do Azure.

dockerComposeFile - de Arquivo do Docker Compose
string. Obrigatório Valor padrão: **/docker-compose.yml.

Caminho para o arquivo principal do Docker Compose a ser usado.

additionalDockerComposeFiles - arquivos de redação adicionais do Docker
string.

Arquivos adicionais do Docker Compose a serem combinados com o arquivo principal do Docker Compose. Caminhos relativos são resolvidos em relação ao diretório que contém o arquivo docker compose primário. Se um arquivo especificado não for encontrado, ele será ignorado. Especifique cada caminho de arquivo em uma nova linha.

variáveis de ambiente dockerComposeFileArgs -
string.

Variáveis de ambiente a serem definidas durante o comando. Especifique cada par name=value em uma nova linha.

projectName - nome do projeto
string. Valor padrão: $(Build.Repository.Name).

Nome do projeto usado para nomenclatura padrão de imagens e contêineres.

qualifyImageNames - qualificar nomes de imagem
boolean. Valor padrão: true.

Qualifique nomes de imagem para serviços criados com o nome de host da conexão do serviço de registro do Docker se não for especificado de outra forma.

de Ação action -
string. Obrigatório Valores permitidos: Build services (Criar imagens de serviço), Push services (imagens de serviço push), Run services (Executar imagens de serviço), Run a specific service (Executar uma imagem de serviço específica), Lock services (Bloquear imagens de serviço), Write service image digests, Combine configuration, Run a Docker Compose command. Valor padrão: Run a Docker Compose command.

Selecione uma ação do Docker Compose.

additionalImageTags - marcas de imagem adicionais
string. Opcional. Use quando action = Build services || action = Push services.

Tags adicionais para as imagens do Docker que estão sendo criadas ou enviadas.

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

Inclua tags do Git ao criar ou enviar imagens do Docker.

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

Inclua a tag 'mais recente' ao criar ou enviar imagens do Docker.

buildImages - criar imagens
boolean. Opcional. Use quando action = Run services. Valor padrão: true.

Crie imagens antes de iniciar contêineres de serviço.

serviceName - nome do serviço
string. Necessário quando action = Run a specific service.

Nome do serviço específico a ser executado.

de nome do contêiner containerName -
string. Opcional. Use quando action = Run a specific service.

Nome do contêiner de serviço específico a ser executado.

portas ports -
string. Opcional. Use quando action = Run a specific service.

Portas no contêiner de serviço específico para publicar no host. Especifique cada associação host-port:container-port em uma nova linha.

do Diretório de Trabalho do workingDirectory -
Alias de entrada: workDir. string. Opcional. Use quando action = Run a specific service.

O diretório de trabalho para o contêiner de serviço específico.

substituição de ponto de entrada entrypoint -
string. Opcional. Use quando action = Run a specific service.

Substitua o ponto de entrada padrão para o contêiner de serviço específico.

comando containerCommand -
string. Opcional. Use quando action = Run a specific service.

Comando para ser executado no contêiner de serviço específico. Por exemplo, se a imagem contiver um aplicativo Web Python Flask simples, você poderá especificar 'python app.py' para iniciar o aplicativo Web.

detached - executar em segundo plano
boolean. Opcional. Use quando action = Run services || action = Run a specific service. Valor padrão: true.

Execute os contêineres de serviço em segundo plano.

Anulação abortOnContainerExit - no de Saída do Contêiner
boolean. Opcional. Use quando action = Run services && detached == false. Valor padrão: true.

Pare todos os contêineres quando algum contêiner for encerrado.

imageDigestComposeFile - de Arquivo de Redação do Image Digest
string. Necessário quando action = Write service image digests. Valor padrão: $(Build.StagingDirectory)/docker-compose.images.yml.

Caminho para um arquivo do Docker Compose criado e preenchido com os resumos completos do repositório de imagens da imagem do Docker de cada serviço.

removeBuildOptions - remover opções de build
boolean. Opcional. Use quando action = Lock services || action = Combine configuration. Valor padrão: false.

Remova as opções de compilação do arquivo de saída do Docker Compose.

baseResolveDirectory - do Diretório de Resolução Base
string. Opcional. Use quando action = Lock services || action = Combine configuration.

O diretório base do qual os caminhos relativos no arquivo de saída do Docker Compose devem ser resolvidos.

outputDockerComposeFile - arquivo de composição do Docker de saída
string. Necessário quando action = Lock services || action = Combine configuration. Valor padrão: $(Build.StagingDirectory)/docker-compose.yml.

Caminho para um arquivo de saída do Docker Compose.

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

Docker Compose para executar com argumentos. Por exemplo, 'rm --all' para remover todos os contêineres de serviço parados.

argumentos arguments -
string. Opcional. Use quando action != Lock services && action != Combine configuration && action != Write service image digests.

Opções de comando do Docker Compose. Por exemplo:
Para o comando build,
--pull --compress --parallel.

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

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

nopIfNoDockerComposeFile - não opera se não houver de Arquivo do Docker Compose
boolean. Valor padrão: false.

Se o arquivo do Docker Compose não existir, ignore esta tarefa. Isso é útil quando a tarefa oferece um comportamento opcional com base na existência de um arquivo do Docker Compose no repositório.

requireAdditionalDockerComposeFiles - exigir arquivos de redação adicionais do Docker
boolean. Valor padrão: false.

Produzirá um erro se os arquivos adicionais do Docker Compose não existirem. Isso substitui o comportamento padrão que é ignorar um arquivo se ele não existir.

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

Diretório de trabalho para o comando Docker Compose.

dockerComposePath - de caminho executável do Docker Compose
string.

Esse executável docker-compose será usado se o caminho for fornecido.

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

DockerComposeOutput
O caminho do(s) arquivo(s) que contém a saída do comando. Isso pode conter vários caminhos de arquivo (separados por caracteres de nova linha) no caso do comando dockerComposeRun (um para execução e outro para download), dockerPush (um para cada imagem enviada), dockerBuild (a compilação em si e todos os comandos de tag) e dockerDigest (um para cada imagem extraída). Os outros comandos só geram um arquivo.