AzureContainerApps@1 - Tarefa Azure Container Apps Deploy v1

Sintaxe

# Azure Container Apps Deploy v1
# An Azure DevOps Task to build and deploy Azure Container Apps.
- task: AzureContainerApps@1
  inputs:
  # advanced
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    #appSourcePath: # string. Application source path. 
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure Resource Manager connection. 
    #acrName: # string. Azure Container Registry name. 
    #acrUsername: # string. Azure Container Registry username. 
    #acrPassword: # string. Azure Container Registry password. 
    #dockerfilePath: # string. Dockerfile path. 
    #imageToBuild: # string. Docker image to build. 
    #imageToDeploy: # string. Docker image to deploy. 
    #containerAppName: # string. Azure Container App name. 
    #resourceGroup: # string. Azure resource group name. 
    #containerAppEnvironment: # string. Azure Container App environment. 
    #runtimeStack: # string. Application runtime stack. 
    #targetPort: # string. Application target port. 
    #location: # string. Location of the Container App. 
    #environmentVariables: # string. Environment variables. 
    #ingress: # string. Ingress setting. 
    #yamlConfigPath: # string. YAML configuration file path. 
    #disableTelemetry: # boolean. Disable telemetry.

Insumos

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

Comentários

Esta Tarefa de Pipelines do Azure permite que os usuários implantem facilmente sua fonte de aplicativo em um de Aplicativo de Contêiner do Azure em seu fluxo de trabalho do Azure Pipelines, fornecendo uma imagem criada anteriormente, um Dockerfile a partir do qual uma imagem pode ser criada ou usando um construtor para criar uma imagem de aplicativo executável para o usuário.

A tarefa tem os dois padrões de uso a seguir.

• Empurrar uma imagem para o ACR - ao enviar uma nova imagem para o ACR, as entradas de tarefas acrName e appSourcePath são necessárias.
• Implantando uma imagem enviada anteriormente por push - ao implantar uma imagem enviada anteriormente, a entrada de tarefa imageToDeploy é necessária. Se essa imagem for encontrada em uma instância ACR que requer autenticação para pull, o argumento acrName ou os argumentos acrUsername e acrPassword podem ser fornecidos para autenticar solicitações para a instância ACR.

Se nenhum Dockerfile for encontrado ou fornecido na fonte do aplicativo fornecida, as seguintes etapas serão executadas por esta tarefa:

• Usa o Oryx++ Builder para criar a fonte do aplicativo usando Oryx para produzir uma imagem de aplicativo executável
• Envia essa imagem de aplicativo executável para o Registro de Contêiner do Azure fornecido
• Cria ou atualiza um aplicativo de contêiner com base nesta imagem

Se um Dockerfile for encontrado ou descoberto na fonte do aplicativo, o construtor não será usado e a imagem será criada com uma chamada para docker build e o Aplicativo de Contêiner será criado ou atualizado com base nessa imagem.

Se uma imagem criada anteriormente já tiver sido enviada por push para a instância ACR e for fornecida para essa tarefa, nenhuma fonte de aplicativo será necessária e a imagem será usada ao criar ou atualizar o Aplicativo de Contêiner.

Executando esta tarefa em agentes hospedados pela Microsoft

Se você estiver executando essa tarefa em um agente hospedado pela Microsoft, você pode achar que essa tarefa não capaz de ser executada com êxito com os seguintes sistemas operacionais:

• macOS
  • Os macOS runners fornecidos pela Microsoft não vêm instalados com o Docker (mais informações aqui); como resultado, essa tarefa não é capaz de executar nenhum comando docker, como enviar as imagens de aplicativo executáveis construídas para o ACR.
• Mac OS
  • Os executores do Windows fornecidos pela Microsoft vêm com o Docker instalado, mas, por padrão, as imagens baseadas em Linux não podem ser puxadas para baixo; como resultado, essa tarefa não é capaz de puxar para baixo o construtor Oryx para criar imagens de aplicativo executáveis a partir da fonte de aplicativo fornecida.

Consulte a seção de pré-requisitos do Docker abaixo para obter mais informações.

Aviso de Recolha de Dados/Telemetria

Por padrão, essa Tarefa de DevOps do Azure coleta as seguintes partes de dados para a Microsoft:

• O cenário de compilação e implantação do Aplicativo de Contêiner direcionado pelo usuário
  • exemplo,, usou o Oryx++ Builder, usou um Dockerfile fornecido/encontrado ou forneceu uma imagem construída anteriormente
  • Nota: o nome da imagem não está recolhido
• O tempo de processamento da tarefa, em milissegundos
• O resultado da tarefa
  • ou seja,, bem-sucedido ou fracassado
• Se o Oryx++ Builder for usado, eventos e métricas relacionados à criação do aplicativo fornecido usando o Oryx

Se você quiser desativar a coleta de dados, defina o argumento disableTelemetry como true.

Pré-requisitos

Antes de executar essa tarefa, os recursos do Azure e uma conexão de serviço do Azure DevOps são necessários ou opcionais, dependendo dos argumentos fornecidos para essa tarefa.

Conexão do Serviço Azure DevOps

Para implantar no Azure, uma assinatura do Azure deve ser vinculada ao Team Foundation Server ou ao Azure Pipelines usando a guia Serviços na seção de configurações. Adicione a assinatura do Azure para usar na definição de Build ou Release Management abrindo a tela Administração de Conta (ícone de engrenagem no canto superior direito da tela) e clique na guia Serviços.

Crie o ponto de extremidade do serviço ARM e use o 'Azure Resource Manager' tipo de ponto de extremidade; Para obter mais informações sobre como criar conexões de serviço, siga este documento.

Azure CLI

Esta tarefa requer que a CLI do Azure esteja instalada no agente do Azure Pipelines para executar uma variedade de comandos durante a execução da tarefa. Para obter mais informações sobre como instalar a CLI do Azure no agente, consulte este documento. Se um agente já estiver em execução na máquina na qual a CLI do Azure está instalada, certifique-se de reiniciar o agente para que todas as variáveis de ambiente relevantes sejam atualizadas.

Docker

Esta tarefa requer que o Docker esteja instalado no agente do Azure Pipelines para enviar imagens por push para o Registro de Contêiner do Azure fornecido. Para obter mais informações sobre como instalar o Docker no agente, consulte este documento.

Além disso, os usuários que executam essa tarefa com um agente do Windows podem encontrar um problema por não serem capazes de extrair imagens baseadas em Linux; Para resolver isso, visite este site ou localize o arquivo DockerCli.exe em seu agente (normalmente na pasta Program Files\Docker\Docker) e execute

& `.\DockerCli.exe` -SwitchDaemon

Se o Docker não estiver instalado no agente que executa essa tarefa, os seguintes cenários ainda estarão habilitados:

• Fornecer uma imagem criada anteriormente para o previamente criado para o argumento que o Aplicativo de Contêiner implanta com

Se o Docker estiver no agente, mas não puder trabalhar com imagens baseadas em Linux, os seguintes cenários ainda estarão habilitados:

• Fornecer uma imagem criada anteriormente para o previamente criado para o argumento que o Aplicativo de Contêiner implanta com
• Fornecendo um Dockerfile como parte da origem do aplicativo que será criado e implantado com o aplicativo de contêiner
  • Nota: o Dockerfile não pode ter camadas de imagem baseadas em Linux

pacote CLI

O CLI do pacote é mantido pelo projeto Cloud Native Buildpacks e é usado por essa tarefa para criar imagens de aplicativo executáveis para o usuário quando o código-fonte do aplicativo é fornecido e nenhum Dockerfile adicional é fornecido ou encontrado. Um construtor de foi criado pela Oryx para receber o código-fonte do aplicativo fornecido para essa tarefa e produzir uma imagem que poderia ser enviada por push para um registro de imagem e usada dentro de um aplicativo de contêiner para criar e executar o aplicativo.

Uma versão estável da CLI do pacote é instalada no agente do Azure Pipelines que executa a tarefa e, dependendo do sistema operacional base desse agente, diferentes ferramentas serão aproveitadas para ajudar na instalação:

• Em corredores do Windows:
  • Um conjunto de comandos do PowerShell é executado para fazer o seguinte:
    • Cria uma pasta pack na pasta temporária do agente, se a pasta pack ainda não existir
    • Baixa o pacote CLI .zip para esta pasta pack
    • Descompacta o conteúdo desse .zip e os coloca na pasta pack
    • Exclui o .zip
• Em corredores que não são do Windows:
  • curl será usado para puxar para baixo o .tgz que contém o executável pack
  • tar será usado para descompactar o .tgz e colocar o executável pack em /usr/local/bin

Azure Container Registry

Deve existir um Registro de Contêiner do Azure para o qual o usuário possa enviar imagens de contêiner por push. Essa tarefa aproveitará o Registro de Contêiner do Azure para enviar por push uma imagem de aplicativo executável criada para e/ou implantar um Aplicativo de Contêiner.

O nome do Registro de Contêiner do Azure é necessário por meio do argumento acrName.

O usuário também pode fornecer valores para os argumentos acrUsername e acrPassword que autenticarão chamadas para a instância do Registro de Contêiner do Azure; se não for fornecido, um token de acesso será gerado por meio da CLI do Azure que autenticará as chamadas.

Ambiente do Aplicativo de Contêiner do Azure

Recomenda-se que um de ambiente do Aplicativo de Contêiner do Azure do tenha sido criado anteriormente pelo usuário para melhorar o desempenho da tarefa. Se nenhum ambiente tiver sido criado antes, ou se um ambiente não puder ser encontrado no grupo de recursos que está sendo usado para hospedar o Aplicativo de Contêiner criado, um ambiente será criado por como parte do comando az containerapp up, o que pode levar tempo adicional.

Exemplos

Os exemplos a seguir descrevem como usar o AzureContainerApps em diferentes cenários.

Minimal - Criar imagem de aplicativo para Container App

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    connectedServiceNameARM: 'azure-subscription-service-connection'
    appSourcePath: '$(System.DefaultWorkingDirectory)'
    acrName: 'mytestacr'

Isso criará um novo Aplicativo de Contêiner chamado ado-task-app-<build-id>-<build-number> em um novo grupo de recursos chamado <container-app-name>-rg. O Container App será baseado em uma imagem que foi criada a partir do appSourcePath fornecido e enviada por push para a instância ACR fornecida. Um token de acesso será gerado para autenticar o push para a instância ACR fornecida.

Mínimo - Use a imagem publicada anteriormente para o Container App

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    connectedServiceNameARM: 'azure-subscription-service-connection'
    imageToDeploy: mcr.microsoft.com/<existing-image>:latest

Isso criará um novo Aplicativo de Contêiner chamado ado-task-app-<build-id>-<build-number> em um novo grupo de recursos chamado <container-app-name>-rg onde nenhuma nova imagem é criada, mas uma imagem existente chamada mcr.microsoft.com/<existing-image>:latest será usada para o Aplicativo de Contêiner.

Mínimo - Use o arquivo de configuração YAML com imagem publicada anteriormente para o Container App

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    yamlConfigPath: simple-image-container-app.yaml

Isso criará um novo Aplicativo de Contêiner chamado ado-task-app-<build-id>-<build-number> em um novo grupo de recursos chamado <container-app-name>-rg onde nenhuma nova imagem é criada, mas uma imagem existente chamada mcr.microsoft.com/<existing-image>:latest será usada para o Aplicativo de Contêiner. Propriedades adicionais sobre o Aplicativo de Contêiner serão extraídas do arquivo de simple-image-container-app.yaml e substituirão quaisquer valores adicionais que teriam sido fornecidos à tarefa como argumentos exclusão resourceGroup.

O arquivo simple-image-container-app.yaml tem a seguinte estrutura:

properties:
  managedEnvironmentId: /subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.App/managedEnvironments/CONTAINER_APP_ENVIRONMENT
  configuration:
    ingress:
      external: true
      allowInsecure: false
      targetPort: 80
  template:
    containers:
      - image: mcr.microsoft.com/<existing-image>:latest
        name: mysampleimagecontainer

Os valores para SUBSCRIPTION_ID, RESOURCE_GROUP e CONTAINER_APP_ENVIRONMENT devem ser atualizados para apontar para a ID de recurso completa do ambiente existente do Container App que o Container App usará.

Usando credenciais ACR para autenticar

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    connectedServiceNameARM: 'azure-subscription-service-connection'
    appSourcePath: '$(System.DefaultWorkingDirectory)'
    acrName: 'mytestacr'
    acrUsername: $(ACR_USERNAME_SECRET)
    acrPassword: $(ACR_PASSWORD_SECRET)

Isso criará um novo Aplicativo de Contêiner chamado ado-task-app-<build-id>-<build-number> em um novo grupo de recursos chamado <container-app-name>-rg. O Container App será baseado em uma imagem que foi criada a partir do appSourcePath fornecido e enviada por push para a instância ACR fornecida. As credenciais ACR fornecidas serão usadas para autenticar chamadas para a instância ACR.

Nome do aplicativo de contêiner fornecido

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    connectedServiceNameARM: 'azure-subscription-service-connection'
    appSourcePath: '$(System.DefaultWorkingDirectory)'
    acrName: 'mytestacr'
    containerAppName: 'my-test-container-app'

Isso criará um novo Aplicativo de Contêiner chamado my-test-container-app em um novo nome de grupo de recursos my-test-container-app-rg.

Grupo de recursos fornecido

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    connectedServiceNameARM: 'azure-subscription-service-connection'
    appSourcePath: '$(System.DefaultWorkingDirectory)'
    acrName: 'mytestacr'
    resourceGroup: 'my-test-rg'

Isso criará um novo Aplicativo de Contêiner chamado ado-task-app-<build-id>-<build-number> em um grupo de recursos chamado my-test-rg. Se o grupo de recursos my-test-rg não existir, ele será criado como parte dessa tarefa.

Nome do aplicativo de contêiner e grupo de recursos fornecidos

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    connectedServiceNameARM: 'azure-subscription-service-connection'
    appSourcePath: '$(System.DefaultWorkingDirectory)'
    acrName: 'mytestacr'
    containerAppName: 'my-test-container-app'
    resourceGroup: 'my-test-rg'

Isso criará um novo Aplicativo de Contêiner chamado my-test-container-app em um grupo de recursos chamado my-test-rg. Se o grupo de recursos my-test-rg não existir, ele será criado como parte dessa tarefa.

Ambiente de aplicativo de contêiner fornecido

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    connectedServiceNameARM: 'azure-subscription-service-connection'
    appSourcePath: '$(System.DefaultWorkingDirectory)'
    acrName: 'mytestacr'
    containerAppEnvironment: 'my-test-container-app-env'

Isso criará um novo Aplicativo de Contêiner chamado ado-task-app-<build-id>-<build-number> em um novo grupo de recursos chamado <container-app-name>-rg com um novo ambiente de Aplicativo de Contêiner chamado my-test-container-app-env.

Pilha de tempo de execução fornecida

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    connectedServiceNameARM: 'azure-subscription-service-connection'
    appSourcePath: '$(System.DefaultWorkingDirectory)'
    acrName: 'mytestacr'
    runtimeStack: 'dotnetcore:7.0'

Isso criará um novo Aplicativo de Contêiner chamado ado-task-app-<build-id>-<build-number> em um novo grupo de recursos chamado <container-app-name>-rg onde a imagem do aplicativo executável está usando a pilha de tempo de execução do .NET 7.

Dockerfile fornecido

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    connectedServiceNameARM: 'azure-subscription-service-connection'
    appSourcePath: '$(System.DefaultWorkingDirectory)'
    acrName: 'mytestacr'
    dockerfilePath: 'test.Dockerfile'

Isso criará um novo Aplicativo de Contêiner chamado ado-task-app-<build-id>-<build-number> em um novo grupo de recursos chamado <container-app-name>-rg onde a imagem do aplicativo executável foi criada a partir do arquivo de test.Dockerfile encontrado no diretório de caminho de origem do aplicativo fornecido.

Nota: para valores fornecidos a dockerfilePath, nenhum prefixo de arquivo deve ser incluído (por exemplo,, ./test.Dockerfile deve ser passado como apenas test.Dockerfile). Os argumentos appSourcePath e dockerfilePath fornecidos serão concatenados dentro da tarefa.

Imagem a construir fornecida

steps:
- task: AzureContainerApps@1
  displayName: Build and deploy Container App
  inputs:
    connectedServiceNameARM: 'azure-subscription-service-connection'
    appSourcePath: '$(System.DefaultWorkingDirectory)'
    acrName: 'mytestacr'
    imageToBuild: 'mytestacr.azurecr.io/app:latest'

Isso criará um novo Aplicativo de Contêiner chamado ado-task-app-<build-id>-<build-number> em um novo grupo de recursos chamado <container-app-name>-rg onde a imagem criada e enviada por push para ACR é nomeada mytestacr.azurecr.io/app:latest.

Requerimentos

Ver também

• Implantar em aplicativos de contêiner do Azure a partir do Azure Pipelines