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

Este artigo mostra como usar a CLI do Desenvolvedor do Azure (azd) para criar um pipeline de CI/CD com o Azure DevOps Pipelines (Azure Pipelines) para um azd modelo. O pipeline permite que você envie atualizações por push para um repositório de código e tenha suas alterações provisionadas e implantadas automaticamente em seu ambiente do Azure.

Pré-requisitos

• Instalar a CLI do Desenvolvedor do Azure.
• Visual Studio Code instalado.

Inicializar o modelo

Este exemplo usa o modelo Hello-AZD , mas você pode seguir estas etapas para qualquer modelo que inclua um arquivo de definição de pipeline (encontrado nas .github pastas ou .azdo nas 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 (por exemplo, hello-azd).

Configurar Azure Pipelines

Criar ou usar uma organização do Azure Pipelines

Para usar o Azure Pipelines, você precisa de uma organização. Caso ainda não tenha um, crie um em https://dev.azure.com.

Criar um PAT (Token de Acesso Pessoal)

A CLI do Desenvolvedor do Azure requer um PAT (Token de Acesso Pessoal) para configurar o Azure Pipelines. Crie um novo PAT com os seguintes escopos:

• Pools de agentes (ler, gerenciar)
• Build (leitura e execução)
• Código (completo)
• Projeto e equipe (ler, escrever e gerenciar)
• Liberação (ler, gravar, executar e gerenciar)
• Conexões de Serviço (ler, consultar e gerenciar)

Configurar o pipeline

1. Execute o seguinte comando para configurar um projeto e repositório do Azure Pipelines com um pipeline de implantação:

   azd pipeline config --provider azdo
   

   Observação

   Por padrão, azd pipeline config para o Azure Pipelines usa credenciais de cliente. Atualmente, não há suporte para credenciais OIDC/federadas. Saiba mais sobre o suporte ao OIDC em azd.

2. Responda às solicitações:

   • PAT (token de acesso pessoal):

     • Cole seu Token de Acesso Pessoal (PAT).

     • Opcionalmente, exporte seu PAT como uma variável de ambiente do sistema para evitar prompts repetidos:

       export AZURE_DEVOPS_EXT_PAT=<PAT>
       

   • Nome da organização do Azure Pipelines:

     • Insira o nome da sua organização. Esse valor é salvo no .env arquivo para o ambiente atual.

   • Uma "origem" remota chamada não foi encontrada. Deseja configurar um?

     • Sim

   • Como você gostaria de configurar seu projeto?

     • Criar um novo projeto do Azure Pipelines

   • Insira o nome do novo Projeto do Azure Pipelines OU o Hit enter para usar este nome: ( {nome padrão} )

     • Selecione Enter ou crie um nome de projeto exclusivo.

   • Deseja confirmar e enviar por push suas alterações locais para iniciar o pipeline de CI configurado?

     • Sim

3. Para verificar o build, acesse seu projeto no portal do Azure Pipelines (https://dev.azure.com).

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

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

2. Altere o texto do Hello AZD! cabeçalho para Hello, pipeline! e salve o arquivo.

3. Crie uma ramificação e confirme sua alteração. O main branch é protegido, portanto, envie suas alterações por push de um novo branch e crie uma solicitação pull no Azure Pipelines. A solicitação de pull dispara o pipeline e bloqueia a mesclagem se o pipeline falhar.

4. Aprove e integre seu pull request para iniciar o pipeline novamente.

   

5. No navegador, abra o repositório do projeto para ver a confirmação e a execução do Azure Pipeline.

   

6. Visite a URL de front-end da Web para inspecionar a atualização.

Usar azd como uma tarefa do Azure Pipelines

Adicione azd como uma tarefa do Azure Pipelines para instalar azd em seu pipeline. Adicione o seguinte a .azdo/pipelines/azure-dev.yml:

trigger:
  - main
  - branch

pool:
  vmImage: ubuntu-latest
  # vmImage: windows-latest

steps:
  - task: setup-azd@0
    displayName: Install azd

Limpar os recursos

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

azd down

Próximas etapas