Partilhar via

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 automaticamente provisionadas e implantadas em seu ambiente do Azure.

Observação

O azd pipeline config comando está em beta. Para obter detalhes, consulte o controle de versão do recurso e a estratégia de lançamento.

Pré-requisitos

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 ).

  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 o serviço Azure Pipelines

Observação

Se você estiver usando o Azure Pipelines para um modelo Java no Windows, consulte o guia de solução de problemas.

Criar ou usar uma organização do Azure Pipelines

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

Criar um token de acesso pessoal (PAT)

A CLI do Desenvolvedor do Azure requer um PAT (Personal Access Token) para configurar os Pipelines do Azure. Crie uma nova PAT com os seguintes âmbitos:

  • Grupos de agentes (ler, gerir)
  • Compilar (ler e executar)
  • Código (completo)
  • Projeto e equipe (ler, escrever e gerenciar)
  • Liberar (ler, gravar, executar e gerenciar)
  • Conexões de serviço (ler, consultar e gerenciar)

Configurar a linha de processamento

  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 o Azure Pipelines usa credenciais de cliente. Atualmente, não há suporte para credenciais OIDC/federadas. Saiba mais sobre o suporte OIDC em azd.

  2. Responda às solicitações:

    • Token de Acesso Pessoal (PAT):

      • Cole o seu PAT.

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

        export AZURE_DEVOPS_EXT_PAT=<PAT>

    • Nome da Organização do Azure Pipelines:

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

    • Um controle remoto chamado "origem" não foi encontrado. Gostaria de configurar um?

      • Sim

    • Como gostaria de configurar o seu projeto?

      • Criar um novo projeto do Azure Pipelines

    • Insira o nome do seu novo projeto do Azure Pipelines OU Hit enter para usar este nome: ( {default name} )

      • Selecione Enter ou crie um nome de projeto exclusivo.

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

      • Sim

  3. Para verificar a compilação, vá para seu projeto no portal do Azure Pipelines (https://dev.azure.com).

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

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

  2. Altere o texto do cabeçalho para Hello AZD! e guarde o ficheiro.

  3. Crie uma ramificação e confirme sua alteração. O ramo main está protegido, portanto, envie as suas alterações de um novo ramo e crie um Pull Request no Azure Pipelines. O pull request inicia o pipeline e bloqueia a fusão se o pipeline falhar.

  4. Aprove e faça o merge do seu pull request para iniciar o pipeline novamente.

    Captura de tela das etapas necessárias para fazer e confirmar alterações no arquivo de teste.

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

    Captura de tela do fluxo de trabalho do GitHub em execução após a atualização de teste.

  6. Visite o URL do frontend 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

Limpeza de recursos

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

azd down

Próximos passos

Monitorar seu aplicativo usando a CLI do Desenvolvedor do Azure (azd)

  • Last updated on