Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022 | Azure DevOps Server 2020
Um pool de agentes é uma coleção de agentes. Em vez de gerenciar cada agente individualmente, você organiza agentes em pools de agentes. Quando você configura um agente, ele é registrado com um único pool. Ao criar um pipeline, você especifica o pool em que o pipeline será executado. Quando você executa o pipeline, ele é executado em um agente desse pool que atende às demandas do pipeline.
Os pools de agentes gerenciados do DevOps são administrados no portal do Azure. Se você estiver usando Pools de DevOps Gerenciados, confira o início rápido para criar um pool.
No Azure Pipelines, os pools são definidos para toda a organização, permitindo que você compartilhe máquinas de agente entre projetos.
No Servidor do Azure DevOps, os pools de agentes têm escopo para todo o servidor, para que você possa compartilhar computadores de agente entre projetos e coleções.
Os trabalhos do pool de agentes executam um trabalho em apenas um agente. Se você precisar executar um trabalho em todos os agentes, como um grupo de implantação para pipelines de lançamento clássicos, consulte Provisionar grupos de implantação.
Se você for um administrador da organização, crie e gerencie pools de agentes na guia Pools do Agente nas configurações de administrador.
Entre em sua organização (
https://dev.azure.com/{yourorganization}).Selecioneas configurações da Organização>.
Selecione Pools de Agentes.
Entre na sua coleção de projetos (
http://your-server/DefaultCollection).Selecione Azure DevOps>Configurações da Coleção.
Selecione Pools de Agentes.
Se você for um membro da equipe de projeto, crie e gerencie pools de agentes na guia Pools do Agente nas configurações do projeto.
Vá para o seu projeto e selecione Configurações do Projeto>Pools do Agente.
Vá para o seu projeto e selecione Configurações do Projeto>Pools do Agente.
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.
- Azure Pipelines: esse pool hospedado vem com várias imagens do Windows, Linux e macOS. Para obter uma lista completa das imagens disponíveis e dos respectivos softwares instalados, confira Agentes hospedados pela Microsoft.
Por padrão, todos os colaboradores em um projeto são membros da função Usuário em pools hospedados. Essa designação permite que todos os colaboradores de um projeto criem e executem pipelines com agentes hospedados pela Microsoft.
Designar um pool em seu pipeline
Para escolher um agente hospedado pela Microsoft no pool do Azure Pipelines em seu pipeline YAML do Azure DevOps Services, especifique o nome da imagem usando o Rótulo de Imagem da VM YAMLdesta tabela.
pool:
vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.
Para usar um pool privado sem demandas:
pool: MyPool
Para obter mais informações, confira o esquema YAML para pools.
Gerenciar pools e filas
Os administradores da organização criam e gerenciam pools de agentes na guia Pools do Agente nas configurações de administrador.
Entre em sua organização (
https://dev.azure.com/{yourorganization}).Selecioneas configurações da Organização>.
Selecione Pools de Agentes.
Entre na sua coleção de projetos (
http://your-server/DefaultCollection).Selecione Azure DevOps>Configurações da Coleção.
Selecione Pools de Agentes.
Os membros da equipe do projeto criam e gerenciam pools de agentes na guia Pools do Agente nas configurações do projeto.
Vá para o seu projeto e selecione Configurações do Projeto>Pools do Agente.
Vá para o seu projeto e selecione Configurações do Projeto>Pools do Agente.
Para excluir um pool, vá para a lista de pools do Agente e selecione Mais opções>Excluir.
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 diferentes equipes ou finalidades, talvez você queira criar mais pools. Use as instruções a seguir.
Criar pools de agentes
Aqui estão algumas situações típicas em que talvez você queira criar pools de agentes auto-hospedados.
Você é membro de um projeto e deseja usar um conjunto de computadores que sua equipe possui para executar trabalhos de build e implantação:
- Verifique se você tem permissões para criar pools em seu projeto. Nas configurações do Project, vá para o painel Pools do Agente e selecione Segurança. Para criar novos pools, você deve ter a função administrador .
- Selecione Adicionar pool e, em seguida, selecione a opção para criar um novo pool.
- Instale e configure agentes para fazer parte do novo pool de agentes.
Você é membro da equipe de infraestrutura e deseja configurar um pool de agentes para usar em todos os projetos:
- Verifique se você tem permissões para criar pools em seu projeto. Nas configurações da Organização, vá para o painel Pools do Agente e selecione Segurança.
- Crie um pool de novos agentes e selecione a opção Provisionar automaticamente esse pool de agentes em todos os projetos ao criar o pool. Essa configuração garante que todos os projetos tenham acesso a esse pool de agentes.
- Instale e configure agentes para fazer parte do novo pool de agentes.
Você deseja compartilhar um conjunto de computadores de agente com alguns, mas não todos, de seus projetos:
- Vá para Configurações para um dos projetos. Adicione um pool de agentes e selecione a opção para criar um novo pool no nível da organização.
- Vá para os outros projetos e crie um pool em cada um deles. Selecione Usar um pool de agentes existente da organização.
- Instale e configure agentes para fazer parte do pool de agentes compartilhados.
Você é membro de um projeto e deseja usar um conjunto de computadores que sua equipe possui para executar trabalhos de build e implantação:
- Verifique se você tem permissões para criar pools em seu projeto. Nas configurações do Project, vá para o painel Pools do Agente e selecione Segurança. Para criar novos pools, você deve ter a função administrador .
- Selecione Adicionar pool e, em seguida, selecione a opção para criar um novo pool.
- Instale e configure agentes para fazer parte do novo pool de agentes.
Você é membro da equipe de infraestrutura e deseja configurar um pool de agentes para usar em todos os projetos:
- Verifique se você tem as permissões para criar pools em seu projeto. Nas configurações da Organização, vá para o painel Pools do Agente e selecione Segurança.
- Crie um pool de novos agentes e selecione a opção Provisionar automaticamente esse pool de agentes em todos os projetos ao criar o pool. Essa configuração garante que todos os projetos tenham acesso a esse pool de agentes.
- Instale e configure agentes para fazer parte do novo pool de agentes.
Você deseja compartilhar um conjunto de computadores de agente com alguns, mas não todos, de seus projetos:
- Vá para Configurações para um dos projetos. Adicione um pool de agentes e selecione a opção para criar um novo pool no nível da organização.
- Vá para os outros projetos e crie um pool em cada um deles. Selecione Usar um pool de agentes existente da organização.
- Instale e configure agentes para fazer parte do pool de agentes compartilhados.
Segurança dos pools de agentes
Quando você entende como a segurança funciona para pools de agentes, você pode controlar melhor o compartilhamento e o uso de agentes.
As funções são definidas em cada pool de agentes. Participação nessas funções determina quais operações você pode realizar 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 | Finalidade |
|---|---|
| Reader | Os membros dessa função podem exibir o pool de agentes e os agentes. Normalmente, você usa essa função 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 anteriores 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. Eles também podem gerenciar as associações para todos os papéis do conjunto de agentes da organização. Um usuário que cria um pool de agentes da organização recebe automaticamente a função de Administrador para esse pool. |
O nó Todos os pools de agentes na guia Pools de Agentes gerencia a segurança de todos os pools de agentes da organização. As associações de função para pools de agentes individuais da organização são herdadas automaticamente do nó Todos os pools de agentes. Por padrão, os administradores do Servidor do Azure DevOps também são administradores do nó Todos os pools de agentes ao usar o Servidor do Azure DevOps.
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. A associação nessas funções rege 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 | Finalidade |
|---|---|
| Reader | Os membros dessa função podem visualizar o pool de agentes do projeto. Normalmente, você usa essa função para adicionar operadores que monitoram os trabalhos de build e implantação nesse pool de agentes de projeto. |
| User | Os membros dessa função podem usar o pool de agentes do projeto ao criar pipelines. |
| Administrador | Além disso, para 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. Um usuário que cria um pool de agentes da organização recebe automaticamente a função de Administrador para esse 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 dos pipelines clássicos.
Escolha um dos seguintes processos:
- Permita que todos os pipelines usem o pool de agentes a partir das opções adicionais no canto superior direito da seção permissões de pipeline na guia de segurança de um pool de agentes.
- Bloqueie o pool de agentes e permita que somente pipelines YAML selecionados o usem. Se qualquer outro pipeline YAML se referir ao pool de agentes, uma solicitação de autorização será gerada, o que um administrador do pool de agentes deverá aprovar. Esse processo 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 está acessível a todos os pipelines por padrão.
A ação segurança na guia Pools do Agente controla 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 das configurações que você define aqui. Por padrão, os seguintes grupos são adicionados à função Administrador de Todos os pools de agentes: Administradores de Build, Administradores de Versão e Administradores de Projeto.
perguntas frequentes
Se eu não agendar uma janela de manutenção, quando os agentes executarão a manutenção?
Se você não agendar uma janela, os agentes nesse pool não executarão a tarefa de manutenção.
O que é um trabalho de manutenção?
Você pode configurar pools de agentes para limpar periodicamente diretórios de trabalho e repositórios obsoletos. Esse processo reduz 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 do Agente .
Definir configurações de trabalho de manutenção:
Entre em sua organização (
https://dev.azure.com/{yourorganization}).Selecioneas configurações da Organização>.
Selecione Pools de Agentes.
Entre na sua coleção de projetos (
http://your-server/DefaultCollection).Selecione Azure DevOps>Configurações da Coleção.
Selecione Pools de Agentes.
Selecione o pool desejado e, em seguida, selecione Configurações para definir as configurações do trabalho de manutenção para esse pool de agentes.
Importante
Você precisa ter a permissão Gerenciar filas de build para definir as configurações do trabalho de manutenção. Se você não vê as guias Configurações ou Histórico de Manutenção, não possui a permissão que o papel de Administrador possui por padrão. Para saber mais, confira Segurança de pools de agentes.
Defina as configurações desejadas e selecione Salvar.
Selecione Histórico de Manutenção para ver o histórico de trabalhos de manutenção do pool de agentes atual. Você pode baixar e revisar os logs para ver as etapas e as ações de limpeza executadas.
A manutenção é feita por pool de agentes, não por computador. Se você tiver vários pools de agentes em um único computador, ainda poderá encontrar problemas de espaço em disco.
O trabalho de manutenção do meu pool de agentes auto-hospedados parece preso. Por quê?
Normalmente, um trabalho de manutenção fica travado quando está esperando para ser executado em um agente que não está mais no grupo de agentes. Por exemplo, um agente foi colocado offline propositalmente ou há problemas para se comunicar com ele.
Trabalhos de manutenção que estão na fila para executar esperam sete dias para serem executados. Se eles não forem executados durante esse tempo, eles estarão automaticamente em um estado com falha. Você não pode alterar esse limite de tempo.
O limite de sete dias é diferente da configuração de tempo limite do trabalho de manutenção. Esse último controla o número máximo de minutos que um agente pode gastar fazendo manutenção. O temporizador começa quando o trabalho é iniciado, não quando o trabalho está na fila de um agente.
Estou tentando criar um pool de agentes de projeto que usa um pool de agentes da organização existente, mas os controles não estão disponíveis. Por quê?
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 outro pool de agentes de projeto já fizer referência a ele. Cada pool de agentes da organização pode ser referenciado por apenas um pool de agentes de projeto em uma coleção de projetos.
Não consigo selecionar um pool hospedado pela Microsoft e não consigo enfileirar meu build. Como posso corrigir esse problema?
Peça ao proprietário da sua organização do DevOps do Azure para conceder a permissão para usar o pool. Consulte Segurança dos pools de agentes .
Preciso de mais recursos de build hospedados. O que posso fazer?
O pool do Azure Pipelines fornece a todas as organizações do Azure DevOps agentes de build hospedados na nuvem e minutos de build gratuitos todos os meses. Se você precisar de mais recursos de build hospedados pela Microsoft ou precisar executar mais trabalhos em paralelo, poderá: