Criar um pipeline de CI/CD do GitHub Actions usando a CLI do Desenvolvedor do Azure

Neste artigo, você aprenderá a usar a CLI do Desenvolvedor do Azure (azd) para criar um pipeline de CI/CD do GitHub Actions para um azd modelo. Esse pipeline permite que você envie atualizações de modelo por push para um repositório de código e tenha suas alterações provisionadas e implantadas automaticamente em seu ambiente do Azure.

Prerequisites

• Instalar a CLI do Desenvolvedor do Azure
• Visual Studio Code (opcional, para editar arquivos)
• Uma conta do GitHub
• Uma assinatura do Azure

Inicializar o modelo

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

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

   azd init -t hello-azd
   

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

Criar um pipeline usando o GitHub Actions

Siga estas etapas para criar e configurar um pipeline:

1. Em um terminal na raiz do modelo, execute:

   azd pipeline config
   

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

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

3. Selecione sua assinatura e região desejadas do Azure.

4. Quando solicitado a configurar seu repositório remoto, escolha Criar um novo repositório Privado do GitHub. Se você tiver um projeto existente que gostaria de usar, também poderá escolher Selecionar um projeto existente do GitHub.

   ? 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 solicitado a confirmar e enviar por push suas alterações locais para iniciar uma nova execução do GitHub Actions, insira y.

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

   Note

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

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

   Saiba mais sobre o suporte ao OIDC em azd.

8. No navegador, abra o repositório GitHub para 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. Localize o texto do Hello AZD! cabeçalho próximo à parte superior do arquivo.

3. Altere o texto para Hello, pipeline!.

4. Salve o arquivo.

5. Confirme e envie sua alteração por push. Essa ação dispara o pipeline do GitHub Actions para implantar a atualização.

   

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

   • Your commit
   • A confirmação da configuração do GitHub Actions

   

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

   

8. Para exibir a atualização implantada, visite a URL do front-end da Web fornecida na azd saída.

Usar azd como uma ação do GitHub

Você pode instalar azd como uma ação do GitHub usando a ação setup-azd. Para usá-lo, adicione o seguinte ao arquivo .github/workflows/azure-dev.yml :

on: [push]

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

Limpar os recursos

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

azd down

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

Next steps