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

Neste artigo, irá aprender a usar a Azure Developer CLI (azd) para criar um pipeline de CI/CD do 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 automaticamente provisionadas e implantadas em seu ambiente do Azure.

Prerequisites

• Instalar a CLI do Desenvolvedor do Azure
• Visual Studio Code (opcional, para edição de 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 ).

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 as Ações do GitHub

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 provedor, escolha GitHub.

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

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

4. Quando solicitado a configurar seu repositório remoto, escolha Create a new private GitHub repository. 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 de Ações do GitHub, digite y.

7. Revise 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 OpenID Connect (OIDC), também chamado de credenciais federadas . Para usar credenciais de cliente em vez disso, execute azd pipeline config --auth-type client-credentials.

   As credenciais OIDC/federated não são suportadas para o Terraform.

   Saiba mais sobre o suporte OIDC em azd.

8. Em seu 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 perto da parte superior do arquivo.

3. Altere o texto para Hello, pipeline!.

4. Salve o arquivo.

5. Comprometa-se e impulsione a sua mudança. Essa ação aciona o pipeline de Ações do GitHub 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 de Ações do GitHub

   

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

   

8. Para visualizar a atualização implementada, visite a URL de front-end web fornecida na saída do azd.

Use 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 seu .github/workflows/azure-dev.yml arquivo:

on: [push]

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

Limpeza de recursos

Quando não precisar mais 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.

Next steps