Usar grupos de implantação em pipelines de lançamento clássicos

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Semelhante a um pool de agentes, um grupo de implantação é um conjunto lógico de computadores de destino que têm um agente de implantação instalado. Os grupos de implantação podem representar ambientes como "Desenvolvimento", "Teste" ou "Produção". Cada VM (máquina virtual) física ou virtual no grupo de implantação interage com o Azure Pipelines para coordenar as tarefas de implantação. Os grupos de implantação são diferentes dos trabalhos de implantação, que são coleções de etapas relacionadas à tarefa definidas em pipelines YAML.

Observação

Os grupos de implantação só estão disponíveis para pipelines de versão clássica.

Usando grupos de implantação, você pode:

• Especifique o contexto de segurança e os destinos de tempo de execução para agentes.
• Adicione usuários e conceda a eles as permissões apropriadas para administrar, gerenciar, exibir e usar o grupo.
• Visualize logs dinâmicos para cada servidor enquanto uma implantação ocorre e baixe logs para rastrear implantações para servidores individuais.
• Use marcas para limitar as implantações a conjuntos específicos de servidores de destino.

Pré-requisitos

• Uma organização e um projeto do Azure DevOps. Para criar uma organização e um projeto, consulte Criar uma nova organização ou Criar um projeto no Azure DevOps.
• Acesso administrativo a pelo menos uma máquina física ou virtual Windows ou Linux para usar como destino de implantação.

Criar um grupo de implantação

1. No projeto do Azure DevOps, selecione Grupos de implantação de pipelines>.

   

2. Na tela Grupos de implantação, selecione Novo ou selecione Adicionar um grupo de implantação se esse grupo de implantação for o primeiro no projeto.

   

3. Insira um Nome do grupo de implantação e selecione Criar.

4. Na próxima tela, selecione Windows ou Linux para o Tipo de destino a ser registrado. Um script de registro será gerado.

5. Selecione Usar um token de acesso pessoal no script para autenticação e, em seguida, selecione Copiar script para a área de transferência.

6. Salve o script copiado para ser executado em todos os computadores de destino em seu grupo de implantação.

   

Registrar servidores de destino

Para registrar cada servidor de destino no grupo de implantação:

1. Entre no computador com uma conta administrativa e execute o script copiado. Para computadores Windows, use um prompt de comando do PowerShell com privilégios elevados.

   

2. Para atribuir tags que permitem limitar implantações a determinados servidores em um trabalho de grupo de implantação, insira Y quando solicitado a inserir tags e, em seguida, insira uma tag ou tags.

   As tags são limitadas a 256 caracteres cada, não diferenciam maiúsculas de minúsculas e não há limite para o número de tags que você pode usar.

Depois de configurar um servidor de destino, o script deve retornar a mensagem Service vstsagent.{organization-name}.{computer-name} started successfully.

Instalar e atualizar agentes

Cada servidor de destino no grupo de implantação requer um agente de implantação. O script de registro gerado para servidores de destino instala um agente. Como alternativa, você pode usar o seguinte método para instalar agentes:

• Se os servidores de destino forem VMs do Azure, você poderá configurar facilmente seus servidores instalando a extensão do agente do Azure Pipelines em cada VM.

• Você pode usar a tarefa AzureResourceGroupDeploymentV2 em seu pipeline de lançamento para criar e registrar um grupo de implantação dinamicamente.

Para obter mais informações sobre esses métodos, consulte Provisionar agentes para grupos de implantação.

Para atualizar os agentes nos servidores de destino para a versão mais recente sem precisar reimplantá-los, selecione as reticências Mais ações ao lado do grupo de implantação na página Grupos de implantação e selecione Atualizar destinos. Para obter mais informações, confira Agentes do Azure Pipelines.

Pools de implantação

Um pool de implantação é um conjunto de servidores de destino que estão disponíveis para toda a organização do Azure DevOps. Para criar e atualizar pools de implantação, você precisa de permissões de Administrador de Coleção de Projetos na organização do Azure DevOps.

Ao criar um novo pool de implantação para uma organização, você pode provisionar automaticamente os grupos de implantação correspondentes para projetos selecionados ou todos os projetos na organização. Esses grupos de implantação têm os mesmos servidores de destino que o pool de implantação.

Você pode disparar manualmente uma atualização de versão do agente para todos os servidores no pool selecionando as reticências Mais ações ao lado do pool de implantação em Pools de implantação e selecionando Atualizar destinos.

Monitorar o status da versão

Enquanto um pipeline de lançamento está em execução, você pode exibir os logs dinâmicos de cada servidor de destino em seu grupo de implantação. Quando a implantação for concluída, você poderá baixar os arquivos de log de cada servidor para examinar as implantações e depurar quaisquer problemas.

Compartilhar um grupo de implantação

Você pode compartilhar grupos de implantação com outros projetos na organização. Para provisionar seu grupo de implantação para outros projetos:

1. No projeto do Azure DevOps, selecione Grupos de implantação de pipelines>.

2. Selecione o grupo de implantação e selecione Gerenciar.

   

3. Selecione projetos na lista para compartilhar e selecione Salvar.

   

Os projetos incluídos agora têm o grupo de implantação compartilhado listado em Grupos de implantação.

implantar automaticamente em novos servidores de destino

Quando novos servidores de destino são adicionados a um grupo de implantação, você pode configurar o ambiente para implantar automaticamente a última versão bem-sucedida nos novos destinos.

1. Na definição do pipeline de lançamento, selecione o ícone pós-implantação.

2. Na tela Condições pós-implantação, habilite o gatilho de reimplantação automática.

3. Em Selecionar eventos, selecione Novo destino com tags obrigatórias fica disponível.

4. Em Selecionar ação, selecione Reimplantar a última implantação bem-sucedida neste ambiente.

   

Artigos relacionados

• Trabalhos do grupo de implantação
• Implantar em VMs do Azure usando grupos de implantação
• Provisionar agentes para grupos de implantação