Criar e gerir conjuntos de agentes

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Um pool de agentes é uma coleção de agentes. Em vez de gerenciar cada agente individualmente, você organiza os agentes em pools de agentes. Quando você configura um agente, ele é registrado com um único pool e, ao criar um pipeline, especifica o pool no qual o pipeline é executado. Quando você executa o pipeline, ele é executado em um agente desse pool que atende às demandas do pipeline.

No Azure Pipelines, os pools têm escopo para toda a organização; para que você possa compartilhar as máquinas do agente entre projetos.

Nota

Os trabalhos do pool de agentes executam um trabalho em um único agente. Se você precisar executar um trabalho em todos os agentes, como um grupo de implantação para pipelines de versão clássicos, consulte Provisionar grupos de implantação.

Se você for um administrador da organização, criará e gerenciará pools de agentes na guia Pools de agentes nas configurações de administrador.

1. Inicie sessão na sua organização (https://dev.azure.com/{yourorganization}).

2. Escolha Azure DevOps, Configurações da organização.

   

3. Escolha Pools de agentes.

   

Se você for um membro da equipe de projeto, criará e gerenciará pools de agentes na guia Pools de agentes nas configurações do projeto.

Navegue até seu projeto e escolha Configurações do projeto, Pools de agentes.

Pools de agentes padrão

Os seguintes pools de agentes são fornecidos por padrão:

• Pool padrão : use-o para registrar agentes auto-hospedados que você configurou.

• Pool hospedado do Azure Pipelines com várias imagens do Windows, Linux e macOS. Para obter uma lista completa das imagens disponíveis e do software instalado, consulte Agentes hospedados pela Microsoft.

  Nota

  O pool hospedado do Azure Pipelines substitui os pools hospedados anteriores que tinham nomes mapeados para as imagens correspondentes. Todos os trabalhos que você tinha nos pools hospedados anteriores são automaticamente redirecionados para a imagem correta no novo pool hospedado do Azure Pipelines. Em algumas circunstâncias, você ainda pode ver os nomes do pool antigo, mas nos bastidores os trabalhos hospedados são executados usando o pool do Azure Pipelines. Para obter mais informações, consulte as notas de versão do Single hosted pool das notas de versão de 1º de julho de 2019 - Sprint 154.

Por padrão, todos os colaboradores em um projeto são membros da função Usuário em pools hospedados. Isso permite que cada colaborador em um projeto crie e execute pipelines usando agentes hospedados pela Microsoft.

Designar um pool em seu pipeline

YAML

Para escolher um agente hospedado pela Microsoft no pool de Pipelines do Azure em seu pipeline YAML dos Serviços de DevOps do Azure, especifique o nome da imagem, usando o Rótulo de Imagem de VM YAML desta tabela.

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

Para usar uma piscina privada sem exigências:

pool: MyPool

Para obter mais informações, consulte o esquema YAML para pools.

Clássico

Para escolher um pool e um agente no editor clássico, navegue até as configurações do pipeline, selecione o pool de agentes desejado e, em seguida, a imagem desejada na lista suspensa Especificação do agente. A especificação padrão do agente é windows-2019. Para obter mais informações sobre o software instalado nas imagens hospedadas pela Microsoft, consulte a entrada correspondente na coluna Pool de editores clássicos desta tabela.

Gerenciar pools e filas

Browser

Se você for um administrador da organização, criará e gerenciará pools de agentes na guia Pools de agentes nas configurações de administrador.

1. Inicie sessão na sua organização (https://dev.azure.com/{yourorganization}).

2. Escolha Azure DevOps, Configurações da organização.

   

3. Escolha Pools de agentes.

   

Se você for um membro da equipe de projeto, criará e gerenciará pools de agentes na guia Pools de agentes nas configurações do projeto.

Navegue até seu projeto e escolha Configurações do projeto, Pools de agentes.

CLI do Azure DevOps

Listar pools de | agentes Mostrar detalhes | do pool de agentes Listar filas de | agentes Mostrar detalhes da fila de agentes

Nota

Neste momento, você pode exibir informações sobre pools de agentes e filas, mas não editá-las, usando a CLI do Azure.

Se esta for a primeira vez que utiliza az devops pipelines comandos, consulte Introdução à CLI do Azure DevOps.

Listar pools de agentes

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

Parâmetros

• action: Filtre a lista com a ação do usuário permitida. Valores aceitos: gerenciar, nenhum, usar
• detetar: detetar automaticamente a organização. Valores aceites: false, true
• org ou organização: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
• pool-name: filtre a lista com o nome do pool correspondente.
• pool-type: filtre a lista com o tipo de pool. Valores aceitos: automação, implantação

Exemplo

O exemplo a seguir lista todos os pools em formato de tabela. Este exemplo usa a seguinte configuração padrão: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool list --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

Mostrar detalhes do pool de agentes

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

Parâmetros

• id ou pool-id: ID (obrigatório) do pool para listar os detalhes.
• action: Filtre a lista com a ação do usuário permitida. Valores aceitos: gerenciar, nenhum, usar
• detetar: detetar automaticamente a organização. Valores aceites: false, true
• org ou organização: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

Exemplo

O exemplo a seguir exibe detalhes do pool para o Windows Hospedado 2019 com pool VS2019. Este exemplo usa a seguinte configuração padrão: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

Você também pode usar --output table que retorna as mesmas informações que o list comando.

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

Listar filas de agentes

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

Parâmetros

• action: Filtre a lista com a ação do usuário permitida. Valores aceitos: gerenciar, nenhum, usar
• detetar: detetar automaticamente a organização. Valores aceites: false, true
• org ou organização: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
• projeto ou p: Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Necessário se não configurado como padrão ou captado via git config.
• queue-name: Filtre a lista com o nome da fila correspondente regex, por exemplo, ubuntu para fila com o nome 'Hosted Ubuntu 1604'.

Exemplo

O exemplo a seguir lista todas as filas em formato de tabela. Este exemplo usa a seguinte configuração padrão: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue list --output table
This command group is in preview. It may be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

Mostrar detalhes da fila do agente

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

Parâmetros

• id ou queue-id: ID da fila do agente sobre a qual obter informações.
• action: Filtre a lista com a ação do usuário permitida. Valores aceitos: gerenciar, nenhum, usar
• detetar: detetar automaticamente a organização. Valores aceites: false, true
• org ou organização: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.
• projeto ou p: Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Necessário se não configurado como padrão ou captado via git config.

Exemplo

O exemplo a seguir exibe detalhes da fila para a fila Hosted Windows 2019 with VS2019. Este exemplo usa a seguinte configuração padrão: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

Os pools são usados para executar trabalhos. Saiba mais sobre como especificar pools para trabalhos.

Se você tiver muitos agentes auto-hospedados destinados a equipes ou finalidades diferentes, convém criar pools adicionais, conforme explicado abaixo.

Criar pools de agentes

Aqui estão algumas situações típicas em que você pode querer criar pools de agentes auto-hospedados:

• Você é membro de um projeto e deseja usar um conjunto de máquinas de propriedade de sua equipe para executar trabalhos de compilação e implantação. Primeiro, verifique se você tem as permissões para criar pools em seu projeto selecionando Segurança na página Pools de agentes nas configurações do projeto. Você deve ter a função de Administrador para poder criar novos pools. Em seguida, selecione Adicionar pool e selecione a opção para criar um novo pool. Finalmente, instale e configure os agentes para fazer parte desse pool de agentes.

• Você é um membro da equipe de infraestrutura e gostaria de configurar um pool de agentes para uso em todos os projetos. Primeiro, verifique se você tem as permissões para criar pools em seu projeto selecionando Segurança na página Pools de agentes nas configurações da sua organização. Em seguida, crie um Novo pool de agentes e selecione a opção para provisionar automaticamente esse pool de agentes em todos os projetos durante a criação do pool. Essa configuração garante que todos os projetos tenham acesso a esse pool de agentes. Finalmente, instale e configure os agentes para fazer parte desse pool de agentes.

• Você deseja compartilhar um conjunto de máquinas de agente com vários projetos, mas não todos. Primeiro, navegue até as configurações de um dos projetos, adicione um pool de agentes e selecione a opção para criar um novo pool no nível da organização. Em seguida, vá para cada um dos outros projetos e crie um pool em cada um deles enquanto seleciona a opção Usar um pool de agentes existente da organização. Por fim, instale e configure os agentes para fazerem parte do pool de agentes compartilhados.

Segurança dos conjuntos de agentes

Compreender como a segurança funciona para pools de agentes ajuda a controlar o compartilhamento e o uso de agentes.

As funções são definidas em cada pool de agentes, e a associação a essas funções controla quais operações você pode executar em um pool de agentes.

Configurações de segurança no nível da organização

Função em um pool de agentes nas configurações da organização	Propósito
Leitor	Os membros dessa função podem exibir o pool de agentes, bem como os agentes. Normalmente, você usa isso para adicionar operadores responsáveis por monitorar os agentes e sua integridade.
Conta de Serviço	Os membros dessa função podem usar o pool de agentes da organização para criar um pool de agentes de projeto em um projeto. Se você seguir as diretrizes acima para criar novos pools de agentes de projeto, normalmente não precisará adicionar nenhum membro aqui.
Administrador	Além de todas as permissões acima, os membros dessa função podem registrar ou cancelar o registro de agentes do pool de agentes da organização. Eles também podem se referir ao pool de agentes da organização ao criar um pool de agentes de projeto em um projeto. Finalmente, eles também podem gerenciar a associação para todas as funções do pool de agentes da organização. O usuário que criou o pool de agentes da organização é adicionado automaticamente à função Administrador desse pool.

O nó Todos os pools de agentes na guia Pools de agentes é usado para controlar a segurança de todos os pools de agentes da organização. As associações de função para pools de agentes de organizações individuais são herdadas automaticamente daquelas do nó 'Todos os pools de agentes'. Por padrão, os administradores do TFS e do Azure DevOps Server também são administradores do nó 'Todos os pools de agentes' ao usar o TFS ou o Azure DevOps Server.

Configurações de segurança no nível do projeto

As funções também são definidas em cada pool de agentes de projeto, e as associações a essas funções controlam quais operações você pode executar em um pool de agentes no nível do projeto.

Função em um pool de agentes nas configurações do projeto	Propósito
Leitor	Os membros dessa função podem exibir o pool de agentes de projeto. Normalmente, você usa isso para adicionar operadores que são responsáveis por monitorar os trabalhos de compilação e implantação nesse pool de agentes de projeto.
User	Os membros dessa função podem usar o pool de agentes de projeto ao criar pipelines.
Administrador	Além de todas as operações acima, os membros dessa função podem gerenciar a associação para todas as funções do pool de agentes de projeto. O usuário que criou o pool é adicionado automaticamente à função de Administrador desse pool.

Permissões de pipeline

As permissões de pipeline controlam quais pipelines YAML estão autorizados a usar um pool de agentes. As permissões de pipeline não restringem o acesso de pipelines clássicos.

Pode escolher entre as seguintes opções:

• Acesso aberto para todos os pipelines usarem o pool de agentes a partir de mais opções no canto superior direito da seção Permissões de pipeline na guia segurança de um pool de agentes.

• Bloqueie o pool de agentes e permita que apenas pipelines YAML selecionados o utilizem. Se qualquer outro pipeline YAML se referir ao pool de agentes, uma solicitação de autorização será gerada, que deverá ser aprovada por um Administrador do pool de agentes. Isso não limita o acesso de pipelines clássicos.

As permissões de pipeline para o pool de agentes do Azure Pipelines não podem ser configuradas, pois o pool é acessível, por padrão, a todos os pipelines.

A ação Segurança na guia Pools de agentes é usada para controlar a segurança de todos os pools de agentes de projeto em um projeto. As associações de função para pools de agentes de projeto individuais são herdadas automaticamente do que você define aqui. Por padrão, os seguintes grupos são adicionados à função de Administrador de 'Todos os pools de agentes': Administradores de Compilação, Administradores de Versão, Administradores de Projeto.

FAQ

Se eu não agendar uma janela de manutenção, quando os agentes executarão a manutenção?

Se nenhuma janela for agendada, os agentes desse pool não executarão o trabalho de manutenção.

O que é um trabalho de manutenção?

Você pode configurar pools de agentes para limpar periodicamente diretórios e repositórios de trabalho obsoletos. Isso deve reduzir o potencial de os agentes ficarem sem espaço em disco. Os trabalhos de manutenção são configurados no nível da organização nas configurações do pool de agentes.

Para definir as configurações do trabalho de manutenção:

1. Inicie sessão na sua organização (https://dev.azure.com/{yourorganization}).

2. Escolha Azure DevOps, Configurações da organização.

   

3. Escolha Pools de agentes.

   

Escolha o pool desejado e escolha Configurações para definir as configurações do trabalho de manutenção para esse pool de agentes.

Importante

Você deve ter a permissão Gerenciar filas de compilação para definir as configurações do trabalho de manutenção. Se não vir o separador Definições ou o separador Histórico de Manutenção, não tem essa permissão, que é concedida por predefinição à função de Administrador. Para obter mais informações, consulte Segurança de pools de agentes.

Configure as configurações desejadas e escolha Salvar.

Selecione Histórico de manutenção para ver o histórico de trabalhos de manutenção do pool de agentes atual. Pode transferir e rever os registos para ver os passos de limpeza e as ações tomadas.

A manutenção é feita por pool de agentes, não por máquina; Portanto, se você tiver vários pools de agentes em uma única máquina, ainda poderá ter problemas de espaço em disco.

O trabalho de manutenção do meu conjunto do agente autoalojado parece estar bloqueado. Porquê?

Normalmente, um trabalho de manutenção fica “bloqueado” quando está à espera de ser executado num agente que já não se encontra no conjunto de agentes. Tal ocorre quando, por exemplo, o agente foi colocado offline propositadamente ou quando existem problemas de comunicação com o mesmo.

Os trabalhos de manutenção que foram colocados em fila para serem executados aguardarão sete dias para serem executados. Posteriormente, serão automaticamente definidos para o estado falhado se não forem executados. Não é possível alterar este limite de tempo.

O limite de sete dias é diferente da definição do tempo limite do trabalho de manutenção. O último controla o número máximo de minutos que um agente pode passar a realizar a manutenção. O temporizador é iniciado quando o trabalho é iniciado, não quando o trabalho está em fila num agente.

Estou tentando criar um pool de agentes de projeto que usa um pool de agentes da organização existente, mas os controles estão acinzentados. Porquê?

Na caixa de diálogo 'Criar um pool de agentes de projeto', você não poderá usar um pool de agentes da organização existente se ele já estiver referenciado por outro pool de agentes de projeto. Cada pool de agentes da organização pode ser referenciado por apenas um pool de agentes de projeto dentro de uma determinada coleção de projetos.

Não consigo selecionar um conjunto alojado na Microsoft e não consigo colocar a minha compilação em fila. Como devo proceder para corrigir este problema?

Peça ao proprietário da sua organização do Azure DevOps que lhe conceda permissão para utilizar o conjunto. Veja Segurança dos conjuntos de agentes.

Preciso de mais recursos de compilação hospedados. O que posso fazer?

R: O pool do Azure Pipelines fornece a todas as organizações do Azure DevOps agentes de compilação hospedados na nuvem e minutos de compilação gratuitos todos os meses. Se você precisar de mais recursos de compilação hospedados pela Microsoft ou precisar executar mais trabalhos em paralelo, poderá:

• Hospede seus próprios agentes na infraestrutura que você gerencia
• Comprar trabalhos paralelos adicionais