Configurar um pipeline e atualizações por push

  • Artigo

Neste artigo, você aprenderá a usar a CLI do Desenvolvedor do Azure (azd) para enviar alterações de modelo por meio de um pipeline de CI/CD, como Ações do GitHub ou DevOps do Azure. Para este exemplo, você usará o React Web App com Node.js API e o modelo MongoDB no Azure, mas poderá aplicar os princípios aprendidos neste artigo a qualquer um dos modelos da CLI do Desenvolvedor do Azure.

Observação

O azd pipeline config comando ainda está em beta. Leia mais sobre o suporte a recursos alfa e beta na página de controle de versão e estratégia de lançamento de recursos.

Pré-requisitos

Todos os azd modelos incluem um arquivo de configuração de pipeline padrão do GitHub Actions e do Azure DevOps chamado azure-dev.yml, que é necessário para configurar o CI/CD. Esse arquivo de configuração provisiona seus recursos do Azure e implanta seu código na ramificação principal. Você pode encontrar azure-dev.yml:

  • Para ações do .github/workflow GitHub: no diretório.
  • Para Azure DevOps: no .azdo/pipelines diretório.

Para configurar um pipeline de CI/CD, você usará o azd pipeline config comando, que lida com as seguintes tarefas:

  • Cria e configura uma entidade de serviço para o aplicativo na assinatura do Azure.
  • Orienta você por um fluxo de trabalho para criar e configurar um repositório do GitHub e confirmar o código do projeto nele. Você também pode optar por usar um repositório GitHub existente.
  • Cria uma conexão segura entre o Azure e seu repositório usando segredos do GitHub.
  • Executa a ação GitHub quando você faz check-in do arquivo de fluxo de trabalho.

Para obter um controle mais granular sobre esse processo, você também pode configurar manualmente um pipeline.

Todos os modelos incluem um arquivo de configuração de pipeline padrão do GitHub Actions e do Azure DevOps chamado azure-dev.yml. Esse arquivo de configuração provisiona seus recursos do Azure e implanta seu código na ramificação principal. Você pode encontrar azure-dev.yml:

  • Para ações do .github/workflow GitHub: no diretório.
  • Para Azure DevOps: no .azdo/pipelines diretório.

Você pode usar o arquivo de configuração como está ou modificá-lo para atender às suas necessidades.

Selecione seu provedor de pipeline preferido para continuar:

Autorizar o GitHub a implantar no Azure

Para configurar o fluxo de trabalho, você precisa dar permissão ao GitHub para implantar no Azure em seu nome. Autorize o GitHub criando uma entidade de serviço do Azure armazenada em um segredo do GitHub chamado AZURE_CREDENTIALS.

  1. Execute o seguinte comando para criar a entidade de serviço do Azure e configurar o pipeline:

    azd pipeline config

    Esse comando também cria um repositório privado do GitHub e envia código para o novo repositório.

    Observação

    Por padrão, azd pipeline config usa o OpenID Connect (OIDC), chamado credenciais federadas . Se você preferir não usar o OIDC, execute azd pipeline config --auth-type client-credentials.

    Não há suporte para credenciais OIDC/federadas para o Terraform.

    Saiba mais sobre o suporte a OIDC no azd.

  2. Forneça as informações solicitadas do GitHub.

  3. Quando solicitado sobre como confirmar e enviar suas alterações locais para iniciar uma nova execução de Ações do GitHub, especifique y.

  4. Na janela do terminal, exiba os azd pipeline config resultados do comando. O azd pipeline config comando produzirá o nome do repositório GitHub para seu projeto.

  5. Usando seu navegador, abra o repositório do GitHub para seu projeto.

  6. Selecione Ações para ver o fluxo de trabalho em execução.

    Captura de tela do fluxo de trabalho do GitHub em execução.

Fazer e enviar por push uma alteração de código

  1. No diretório do /src/web/src/layout projeto, abra header.tsx.

  2. Localize a linha <Text variant="xLarge">ToDo</Text>.

  3. Altere o literal ToDo para myTodo.

  4. Salve o arquivo.

  5. Confirme a alteração. A confirmação da alteração inicia o pipeline de Ação do GitHub para implantar a atualização.

    Captura de tela das etapas necessárias para fazer e confirmar a alteração no arquivo de teste.

  6. Usando seu navegador, abra o repositório GitHub do seu projeto para ver ambos:

    • Seu compromisso
    • A confirmação das Ações do GitHub que está sendo configurada.

    Captura de tela da alteração confirmada no GitHub.

  7. Selecione Ações para ver a atualização de teste refletida no fluxo de trabalho.

    Captura de tela do fluxo de trabalho do GitHub em execução após a atualização de teste.

  8. Visite a URL do front-end da Web para inspecionar a atualização.

azd como uma ação do GitHub

Adicionar azd como uma ação do GitHub. Esta ação instalará azdo . Para usá-lo, você pode adicionar o seguinte a .github\workflows\azure-dev.yml:

on: [push]

jobs:
   build:
      runs-on: ubuntu-latest
      steps:
         - name: Install azd
         uses: Azure/setup-azd@v0.1.0

Limpar os recursos

Quando você não precisar mais dos recursos do Azure criados neste artigo, execute o seguinte comando:

azd down

Solicitar ajuda

Para obter informações sobre como registrar um bug, solicitar ajuda ou propor um novo recurso para a CLI do Desenvolvedor do Azure, visite a página de solução de problemas e suporte .

Próximas etapas

Monitorar seu aplicativo usando a CLI do Desenvolvedor do Azure (azd)