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

Selecione a fonte do código

No menu desdobrável Origem, selecione a fonte de implantação com base nos seguintes critérios:

• O Registo de Contentores configura CI/CD entre o seu registo de contentores e o App Service.
• Selecione a opção Ações do GitHub se mantiver o código-fonte da imagem do seu contentor no GitHub. Novas confirmações no repositório GitHub acionam a ação de implantação, que pode ser executada docker build e docker push diretamente no registro do 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 as ações do GitHub.
  • Para configurar o CI/CD com o Azure Pipelines, consulte Implantar um contêiner do Azure Web App a partir do Azure Pipelines.
  • Para um aplicativo Docker Compose, selecione Registro de contêiner.

Se selecionares GitHub Actions, seleciona Autorizar e segue os prompts de autorização. Se você autorizou anteriormente com o GitHub, poderá implantar a partir do 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 a Ramificação a partir dos quais implantar.

Configurar definições do registo

Configurar definições do registo

Para implantar um aplicativo de vários contêineres (Docker Compose), selecione Docker Compose em Tipo de contêiner. Se não vires a lista suspensa Tipo de contentor, desliza para cima até Origem e seleciona Registo de contentores.

Ativar CI/CD

Ativar CI/CD

Como o CI/CD funciona com as ações do GitHub

Se selecionar GitHub Actions no menu suspenso Selecionar código fonte, o App Service configura o CI/CD das seguintes maneiras:

• Ele deposita um arquivo de fluxo de trabalho do GitHub Actions em seu repositório do GitHub para lidar com tarefas de compilação e implantação no Serviço de Aplicativo.
• Ele adiciona as credenciais para seu registro privado como segredos do GitHub. O ficheiro de workflow gerado executa a Azure/docker-login ação para iniciar sessão com o seu registo privado. Depois, é executado docker push para se instalar nela.
• Adiciona o perfil de publicação da sua aplicação como um segredo no GitHub. O ficheiro de workflow gerado utiliza este segredo para autenticar com o App Service. Depois, executa a Azure/webapps-deploy ação para configurar a imagem atualizada, o que desencadeia um reinício da aplicação para puxar a imagem atualizada.
• Captura informações dos registos de execução do fluxo de trabalho e mostra-as no separador Registos no Centro de Implementação da sua aplicação.

Você pode personalizar o provedor de compilação do GitHub Actions das seguintes maneiras:

• Personalize o arquivo de fluxo de trabalho depois que ele for gerado no repositório do GitHub. Para desencadear um reinício da aplicação, o fluxo de trabalho tem de terminar com a Azure/webapps-deploy ação. Para mais informações, consulte Sintaxe de fluxo de trabalho para GitHub Actions.
• Se a ramificação selecionada estiver protegida, você ainda poderá visualizar o arquivo de fluxo de trabalho sem salvar a configuração. Adicione-o e os segredos necessários do GitHub ao seu repositório manualmente. Esse método não oferece 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 um principal do serviço

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

Gere uma entidade de serviço utilizando o comando az ad sp create-for-rbac na CLI do Azure. No exemplo a seguir, substitua <subscription-id>, <group-name>, e <app-name> pelos seus próprios valores. Salve toda a saída JSON para a próxima etapa, incluindo o elemento de 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 Configurações>Segredos>Adicionar um novo segredo. Cole toda a saída JSON do comando CLI do Azure no campo de valor associado ao 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 código semelhante ao exemplo a seguir:

- 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 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 como mostrado no exemplo anterior.

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