Tutorial: Implantar ambientes em CI/CD usando o 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.

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

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 Repositórios do Azure
  • 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 Repositórios do Azure

  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. Na lista suspensa do repositório, selecione Importar repositório.

  5. Em Importar um repositório Git, selecione ou introduza o seguinte:

    • Tipo de fonte: Git
    • Clone de URL: https://github.com/Azure/deployment-environments.git

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. Navegue para os Ambientes de Implementação do Azure. Em Centros de desenvolvimento, selecione seu centro de desenvolvimento.

  3. Em Configuração do Ambiente, no menu lateral, selecione Tipos de Ambiente e depois selecione Criar.

  4. Use os seguintes passos 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 que o seu novo tipo de ambiente aparece na lista.

Para criar tipos de ambiente de projeto:

  1. Em Gerir no menu lateral, selecione Projetos e depois selecione o projeto que quer usar.

  2. No projeto, em Configuração de Ambiente, selecione Tipos de Ambiente e depois selecione Adicionar.

  3. Use os seguintes passos 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 ao nível do centro de desenvolvimento para ativar o projeto.
      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.
      Função(s) de criador de ambientes Selecione as funções para dar acesso aos recursos do 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 que o seu novo 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

    Pode usar uma de três opções para identidade: registo de aplicações, identidade gerida atribuída pelo utilizador ou identidade gerida 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 mais informações, consulte Azure Resource Manager casos especiais de ligação de serviço.

  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 projeto. Em Pipelines, selecione Ligações de serviço>Criar uma ligaçã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 Escolha 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. No separador Função, procure e selecione Deployment Environments User na lista de funções profissionais. Selecione Seguinte.

  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. No separador Função, procure e selecione Leitor de Ambientes de Implementação na lista de funções. Selecione Seguinte.

  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 Repositórios do Azure 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 ficheiro 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.
      <DevCenterProjectName> O nome do seu projeto.
      <DevCenterCatalogName> O nome do seu catálogo.
      <environment-definition-name> Não altere. Define a definição de ambiente usada.
      <DevCenterProjectEnvironmentTypeName> O tipo de ambiente.
      <DeploymentEnvironmentInstanceToCreateName> 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. Para saber mais sobre a criação e gestão de pipelines, consulte a documentação Azure 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-name <DevCenterName> --project-name <DevCenterProjectName> --name <DeploymentEnvironmentInstanceToCreateName> --yes

Conteúdo relacionado

  • Last updated on