Implantação contínua com contêineres personalizados no Serviço de Aplicativo do Azure

Selecione a fonte de código

No menu suspenso Origem, selecione a origem da implantação com base nos seguintes critérios:

• Os conjuntos de registros de contêiner configuram CI/CD entre seu registro de contêiner e o Serviço de Aplicativo.
• Selecione a opção GitHub Actions se você mantiver o código-fonte da imagem de contêiner no GitHub. Novos commits no seu repositório do GitHub acionam a ação de implantação, que pode ser executada docker build e docker push diretamente no seu registro de contêiner. Em seguida, ele atualiza seu aplicativo do Serviço de Aplicativo para executar a nova imagem. Para obter mais informações, consulte Como o CI/CD funciona com o GitHub Actions.
  • Para configurar o CI/CD com Azure Pipelines, consulte Implantar um contêiner de aplicativo Web do Azure a partir do Azure Pipelines.
  • Para um aplicativo Docker Compose, selecione Registro de Contêiner.

Se você selecionar o GitHub Actions, selecione Autorizar e siga os prompts de autorização. Se você tiver autorizado anteriormente com o GitHub, poderá implantar no repositório de um usuário diferente selecionando Alterar Conta.

Depois de autorizar sua conta do Azure com o GitHub, selecione a Organização, o Repositório e o Branch para implantar.

Definir configurações do Registro

Definir configurações do Registro

Para implantar um aplicativo de vários contêineres (Docker Compose), selecione Docker Compose no Tipo de Contêiner. Se você não vir a lista suspensa Tipo de Contêiner, role a tela até Fonte e selecione Registro de Contêiner.

Habilitar CI/CD

Habilitar CI/CD

Como o CI/CD funciona com o GitHub Actions

Se você selecionar GitHub Actions no menu suspenso Selecionar código-fonte, o Serviço de Aplicativo vai configurar a CI/CD das seguintes maneiras:

• Ele deposita um arquivo de fluxo de trabalho do GitHub Actions em seu repositório GitHub para lidar com tarefas de build e implantação no Serviço de Aplicativo.
• Ele adiciona credenciais do seu registro privado como segredos no GitHub. O arquivo de fluxo de trabalho gerado executa a Azure/docker-login ação para entrar com seu registro privado. Em seguida, ele executa docker push para implantação nele.
• Ele adiciona o perfil de publicação do seu app como um segredo do GitHub. O arquivo de fluxo de trabalho gerado usa esse segredo para autenticar com o Serviço de Aplicativo. Em seguida, ele executa a ação Azure/webapps-deploy para configurar a imagem atualizada, o que dispara uma reinicialização do aplicativo para carregar a imagem.
• Ele captura informações dos logs de execução do fluxo de trabalho e exibe-as na guia Logs no Centro de Implantação do aplicativo.

Você pode personalizar o provedor de compilação GitHub Actions como a seguir:

• Personalize o arquivo de fluxo de trabalho depois que ele for gerado em seu repositório GitHub. Para disparar uma reinicialização de aplicativo, o fluxo de trabalho deve terminar com a ação Azure/webapps-deploy . Para obter mais informações, acesse a sintaxe de fluxo de trabalho do GitHub Actions.
• Se o branch selecionado estiver protegido, você ainda poderá visualizar o arquivo de fluxo de trabalho sem salvar a configuração. Adicione-o e os segredos necessários do GitHub em seu repositório manualmente. Esse método não fornece integração de log com o portal do Azure.
• Em vez de um perfil de publicação, implante usando uma entidade de serviço no Microsoft Entra ID.

Autenticar com uma entidade de serviço

Essa configuração opcional substitui a autenticação padrão por perfis de publicação no arquivo de fluxo de trabalho gerado.

Gerar uma entidade de serviço usando o comando az ad sp create-for-rbac na CLI do Azure. No seguinte exemplo, substitua <subscription-id>, <group-name> e <app-name> por seus valores. Salve toda a saída JSON para a próxima etapa, incluindo o nível superior {}.

az ad sp create-for-rbac --name "myAppDeployAuth" --role contributor \
                            --scopes /subscriptions/<subscription-id>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name> \
                            --json-auth

No GitHub, vá para o repositório e selecione Segredos de Configurações>>Adicionar um novo segredo. Insira toda a saída JSON gerada pelo comando da CLI do Azure no campo de valor do segredo. Dê ao segredo um nome como AZURE_CREDENTIALS.

No arquivo de fluxo de trabalho gerado pelo Centro de Implantação, revise a azure/webapps-deploy etapa com um código semelhante ao seguinte exemplo:

- name: Sign in to Azure 
# Use the GitHub secret you added
- uses: azure/login@v1
    with:
    creds: ${{ secrets.AZURE_CREDENTIALS }}
- name: Deploy to Azure Web App
# Remove publish-profile
- uses: azure/webapps-deploy@v2
    with:
    app-name: '<app-name>'
    slot-name: 'production'
    images: '<registry-server>/${{ secrets.AzureAppService_ContainerUsername_... }}/<image>:${{ github.sha }}'
    - name: Sign out of Azure
    run: |
    az logout

Para configurar um aplicativo de vários contêineres (Docker Compose), prepare um arquivo do Docker Compose localmente e execute az webapp config container set com o --multicontainer-config-file parâmetro. Se o arquivo Docker Compose contiver imagens privadas, adicione --docker-registry-server-* parâmetros conforme mostrado no exemplo anterior.

az webapp config container set --resource-group <group-name> --name <app-name> --multicontainer-config-file <docker-compose-file>