Crie um pipeline de CI/CD do GitHub Actions utilizando o Azure Developer CLI

Neste artigo, vai aprender a usar a CLI de Desenvolvedor Azure (azd) para criar um pipeline de CI/CD GitHub Actions para um modelo azd. Este pipeline permite-lhe enviar atualizações de modelos para um repositório de código e ter as suas alterações provisionadas e implementadas automaticamente no seu ambiente Azure.

Prerequisites

• Instala a CLI de Desenvolvimento Azure
• Visual Studio Code (opcional, para editar ficheiros)
• Uma conta no GitHub
• Uma subscrição do Azure

Inicializar o modelo

Este exemplo usa o modelo Hello-AZD, mas pode seguir estes passos para qualquer modelo azd que inclua um ficheiro de definição de pipeline (normalmente encontrado nas pastas .github ou .azdo).

1. Num diretório vazio, inicialize o hello-azd modelo:

   azd init -t hello-azd
   

2. Quando solicitado, introduza um nome para o ambiente, como helloazd.

Crie um pipeline usando o GitHub Actions

Siga estas etapas para criar e configurar um pipeline:

1. Em um terminal de comando na raiz do teu modelo, executa:

   azd pipeline config
   

2. Quando solicitado a selecionar um fornecedor, escolha GitHub.

   ? Select a provider:  [Use arrows to move, type to filter]
   > GitHub
     Azure DevOps
   

3. Selecione a subscrição e a região do Azure que deseja.

4. Quando solicitado a configurar o seu repositório remoto, escolha Criar um novo repositório privado de GitHub. Se tiver um projeto existente que gostaria de usar, pode também escolher Selecionar um projeto GitHub existente.

   ? How would you like to configure your git remote to GitHub?  [Use arrows to move, type to filter]
     Select an existing GitHub project
   > Create a new private GitHub repository
     Enter a remote URL directly
   

5. Insira um nome para o novo repositório.

6. Quando for solicitado a efetuar commit e a fazer push das alterações locais para iniciar uma nova execução do GitHub Actions, introduza y.

7. Revise a saída no terminal. O comando azd pipeline config mostra o nome GitHub repositório do seu projeto.

   Note

   Por padrão, azd pipeline config configura OpenID Connect (OIDC), também chamado de credenciais federadas. Para usar as credenciais do cliente, execute azd pipeline config --auth-type client-credentials.

   Credenciais OIDC/federadas não são suportadas para o Terraform.

   Saiba mais sobre o suporte OIDC em azd.

8. No seu navegador, abra o repositório GitHub do seu projeto.

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

   

Testar o pipeline com uma alteração de código

1. No diretório do /src/components/pages projeto, abra Home.razor.

2. Localiza o Hello AZD! texto do cabeçalho perto do topo do ficheiro.

3. Muda o texto para Hello, pipeline!.

4. Salve o arquivo.

5. Comprometa-se e impulsione a sua mudança. Esta ação desencadeia o pipeline GitHub Actions para implementar a atualização.

   

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

   • O teu compromisso
   • O commit da configuração do GitHub Actions

   

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

   

8. Para visualizar a atualização implementada, visite o endereço URL do frontend web fornecido na azd saída.

Usar azd como Ação do GitHub

Podes instalar azd como uma ação GitHub usando a ação setup-azd. Para o usar, adicione o seguinte ao seu .github/workflows/azure-dev.yml ficheiro:

on: [push]

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

Limpeza de recursos

Quando já não precisar dos recursos do Azure criados neste artigo, execute o seguinte comando:

azd down

Este comando remove todos os recursos do Azure associados ao seu projeto.

Próximos passos