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

Neste artigo, você aprenderá a usar a CLI do desenvolvedor Azure (azd) para criar um pipeline de CI/CD GitHub Actions para um modelo de azd. 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 de Azure.

Prerequisites

• Instale a Azure Developer CLI
• Visual Studio Code (opcional, para editar arquivos)
• Uma conta GitHub
• Uma assinatura de 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 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 de Azure desejadas.

4. Quando solicitado a configurar seu repositório remoto, escolha Criar um novo repositório de GitHub privado. Se você tiver um projeto existente que gostaria de usar, também poderá escolher Selecione 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 solicitado a confirmar e enviar por push as alterações locais para iniciar uma nova execução de GitHub Actions, insira y.

7. Examine a saída no terminal. O comando azd pipeline config 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 GitHub Actions para implantar a atualização.

   

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

   • Sua confirmação
   • A confirmação de 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 de GitHub

Você pode instalar azd como uma ação de 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 de Azure criados neste artigo, execute o seguinte comando:

azd down

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

Próximas Etapas