Partilhar via

Tutorial: Implantar ambientes em CI/CD usando o Azure Pipelines

Neste tutorial, você aprenderá a integrar os Ambientes de Implantação do Azure ao seu pipeline de CI/CD do Azure Pipelines.

A integração contínua e a entrega contínua (CI/CD) são uma abordagem de desenvolvimento de software que ajuda as equipes a automatizar o processo de criação, teste e implantação de alterações de software. O CI/CD permite-lhe lançar alterações de software com mais frequência e com maior confiança.

Antes de iniciar este tutorial, familiarize-se com os recursos e conceitos dos Ambientes de Implantação examinando os principais conceitos dos Ambientes de Implantação do Azure.

Neste tutorial, aprenderás como:

  • Criar e configurar um repositório do Azure Repos
  • Configurar tipos de ambiente
  • Configurar uma conexão de serviço
  • Criar uma canalização
  • Criar um ambiente

Pré-requisitos

Criar e configurar um repositório do Azure Repos

  1. Entre na sua organização do Azure DevOps (https://dev.azure.com/<your-organization>). Substitua <your-organization> pelo identificador do projeto.
  2. Selecione o seu projeto.
  3. Selecione Repos>Arquivos.
  4. Em Importar um repositório, selecione Importar.
  5. Em Importar um repositório Git, selecione ou insira o seguinte:

Configurar tipos de ambiente

Os tipos de ambiente definem os tipos de ambientes que suas equipes de desenvolvimento podem implantar. Você pode aplicar configurações diferentes para cada tipo de ambiente. Você pode criar tipos de ambiente no nível do centro de desenvolvimento e no nível do projeto.

Para criar tipos de ambiente de centro de desenvolvimento:

  1. Inicie sessão no portal Azure.

  2. Em Centros de desenvolvimento, selecione seu centro de desenvolvimento.

  3. No menu à esquerda, em Configuração do ambiente, selecione Tipos de ambiente e, em seguida, selecione Criar.

  4. Use as etapas a seguir para criar três tipos de ambiente: Sandbox, FunctionApp e WebApp.

    1. Em Criar tipo de ambiente, insira as seguintes informações e selecione Adicionar.

      Nome Valor
      Nome Insira um nome para o tipo de ambiente.
      Etiquetas Insira um nome e um valor de tag.

    2. Confirme se o tipo de ambiente aparece na lista.

Para criar tipos de ambiente de projeto:

  1. No menu à esquerda, em Gerir, selecione Projetos e, em seguida, selecione o projeto que pretende utilizar.
  2. No menu à esquerda, em Configuração do ambiente, selecione Tipos de ambiente e, em seguida, selecione Adicionar.
  3. Use as etapas a seguir para adicionar os três tipos de ambiente: Sandbox, FunctionApp e WebApp.

    1. Em Adicionar tipo de ambiente ao <nome> do projeto, insira ou selecione as seguintes informações:

      Nome Valor
      Tipo Selecione um tipo de ambiente de nível de centro de desenvolvimento para habilitar para o projeto específico.
      Subscrição de distribuição Selecione a assinatura na qual o ambiente foi criado.
      Identidade de implantação Selecione uma identidade gerenciada atribuída pelo sistema ou pelo usuário para executar implantações em nome do usuário.
      Permissões sobre recursos de ambiente>Função(ões) de criador de ambiente Selecione as funções para dar acesso aos recursos do ambiente.
      Permissões em recursos de ambiente>Acesso adicional Selecione os usuários ou grupos do Microsoft Entra para atribuir a funções específicas nos recursos do ambiente.
      Etiquetas Insira um nome e um valor de tag. Essas tags são aplicadas em todos os recursos criados como parte do ambiente.

    2. Confirme se o tipo de ambiente aparece na lista.

Configurar uma conexão de serviço

No Azure Pipelines, você cria uma conexão de serviço em seu projeto do Azure DevOps para acessar recursos em sua assinatura do Azure.

  1. Se você não tiver uma identidade gerenciada atribuída pelo usuário para o projeto, adicione uma.

    Observação

    Você pode usar uma das três opções de identidade: registro de aplicativo, identidade gerenciada atribuída pelo usuário e identidade gerenciada atribuída pelo sistema. O registo na aplicação é a opção mais segura. Para usar o registro do aplicativo, você precisa ter as permissões apropriadas. Para obter mais informações, consulte Casos especiais de conexão de serviço do Azure Resource Manager.

  2. Entre na sua organização do Azure DevOps (https://dev.azure.com/<your-organization>). Substitua <your-organization> pelo identificador do projeto.

  3. Selecione o seu projeto.

  4. Selecione Configurações do> projetoConexões> de serviçoCriar conexão de serviço.

  5. No painel Nova conexão de serviço , selecione Gerenciador de Recursos do Azure e selecione Avançar.

  6. Insira os seguintes detalhes da conexão de serviço e selecione Salvar para criar a conexão de serviço.

    Campo Valor
    Tipo de identidade Identidade gerenciada
    Subscrição de identidade gerida Insira a assinatura do Azure que contém a identidade gerenciada.
    Grupo de recursos para identidade gerenciada Insira o grupo de recursos que contém a identidade gerenciada.
    Identidade gerenciada Insira o nome da identidade gerenciada.
    Nível de escopo para conexão de serviço Subscrição
    Subscrição para ligação ao serviço Insira a ID da assinatura do Azure que hospeda seu recurso do centro de desenvolvimento.
    Nome da conexão de serviço Insira um nome exclusivo para a conexão de serviço.
    Conceder permissão de acesso a todos os pipelines Marque essa caixa de seleção.

  7. Selecione Guardar.

Conceder acesso à conexão de serviço ao projeto Ambientes de Implantação

Os Ambientes de Implantação usam o controle de acesso baseado em função para conceder permissões para executar atividades específicas em seu recurso Ambientes de Implantação. Para fazer alterações a partir de um pipeline de CI/CD, conceda a função Utilizador de Ambientes de Implementação à identidade gerenciada.

  1. No portal do Azure, vá para seu projeto de Ambientes de Implantação.
  2. Selecione Controle de acesso (IAM)>Adicionar>Adicionar atribuição de função.
  3. Na guia Função, selecione Usuário de Ambientes de Implantação na lista de funções de função profissional.
  4. Na guia Membros , selecione Identidade gerenciada e Selecionar membros.
  5. Na guia Selecionar identidades gerenciadas , em Identidade gerenciada, selecione a identidade do projeto , selecione o nome do projeto e selecione Selecionar.
  6. No separador Revisão + atribuição, selecionar Revisão + atribuição para adicionar a atribuição de função.

Agora pode usar a ligação de serviço na sua definição de fluxo de trabalho do Azure Pipelines para aceder aos seus Ambientes de Implantação.

Conceda à sua conta acesso ao projeto Ambientes de Implantação

Para exibir ambientes criados por outros usuários, incluindo a conexão de serviço, você precisa conceder à sua conta acesso de leitura ao projeto Ambientes de Implantação.

  1. No portal do Azure, vá para seu projeto de Ambientes de Implantação.
  2. Selecione Controle de acesso (IAM)>Adicionar>Adicionar atribuição de função.
  3. Na guia Função, na lista de funções, selecione Leitor de Ambientes de Implementação.
  4. No separador Membros , selecione Selecionar membros e, em seguida, procure a sua própria conta.
  5. Selecione a sua conta na lista e, em seguida, selecione Selecionar.
  6. No separador Revisão + atribuição, selecionar Revisão + atribuição para adicionar a atribuição de função.

Agora você pode exibir os ambientes criados pelo seu fluxo de trabalho do Azure Pipelines.

Configurar um pipeline

Edite o arquivo azure-pipelines.yml em seu repositório do Azure Repos para personalizar seu pipeline.

No pipeline, você define as etapas para criar o ambiente. Nesse pipeline, você define as etapas para criar o ambiente como um trabalho, que é uma série de etapas que são executadas sequencialmente como uma unidade.

Para personalizar o pipeline, você:

  • Especifique a conexão de serviço a ser usada.
  • Use um script embutido para executar um comando da CLI do Azure que cria o ambiente.

A CLI do Azure é uma ferramenta de linha de comando que fornece um conjunto de comandos para trabalhar com recursos do Azure. Para saber mais sobre os comandos da CLI do Azure, consulte az devcenter.

  1. Em seu projeto do Azure DevOps, selecione Repos>Ficheiros.

  2. No painel Arquivos , na pasta .ado , selecione o arquivo azure-pipelines.yml .

  3. No arquivo azure-pipelines.yml, edite o conteúdo existente:

    • Substitua <AzureServiceConnectionName> pelo nome da conexão de serviço criada anteriormente.

    • Inline script Na entrada, substitua cada um dos seguintes espaços reservados por valores apropriados ao seu ambiente do Azure:

      Marcador de posição Valor
      <DevCenterName> O nome do seu centro de desenvolvimento.
      <project-name> O nome do seu projeto.
      <catalog-name> O nome do seu catálogo.
      <environment-definition-name> Não altere. Define a definição de ambiente usada.
      <environment-type> O tipo de ambiente.
      <environment-name> Especifique um nome para o novo ambiente.
      <parameters> Não altere. Faz referência ao arquivo JSON que define parâmetros para o ambiente.

  4. Selecione Consolidar para guardar as alterações.

  5. No painel Confirmar alterações , insira uma mensagem de confirmação e selecione Confirmar.

Crie um ambiente através de um pipeline

Em seguida, execute o pipeline para criar o ambiente Deployment Environments.

  1. No seu projeto do Azure DevOps, selecione Pipelines.
  2. Selecione o pipeline criado anteriormente e, em seguida, selecione Executar pipeline.
  3. Você pode verificar o progresso da execução do pipeline selecionando o nome do pipeline e, em seguida, selecionando Execuções. Selecione a execução para ver os detalhes da execução do pipeline.
  4. Você também pode verificar o progresso da criação do ambiente no portal do Azure selecionando seu centro de desenvolvimento, selecionando seu projeto e, em seguida, selecionando Ambientes.

Você pode inserir esse trabalho em qualquer lugar em um pipeline de CI e/ou CD. Consulte a documentação do Azure Pipelines para saber mais sobre como criar e gerenciar pipelines.

Limpeza de recursos

Quando terminar de usar os recursos criados neste tutorial, você poderá excluí-los para evitar incorrer em cobranças.

Use o seguinte comando para excluir o ambiente criado neste tutorial:

az devcenter dev environment delete --dev-center <DevCenterName> --project-name <DevCenterProjectName> --name <DeploymentEnvironmentInstanceToCreateName> --yes

Conteúdo relacionado

  • Last updated on