definição pool.demands

Implementações

Observações

Use demandas para garantir que os recursos de que seu pipeline precisa estejam presentes nos agentes que o executam. As demandas são respondidas automaticamente por tarefas ou manualmente por você.

Você pode verificar a presença de uma capacidade (operação Existe) ou pode verificar uma cadeia de caracteres específica em uma capacidade (operação Equals). Verificar a existência de uma capacidade (existe) e verificar uma cadeia de caracteres específica em uma capacidade (igual) são as duas únicas operações suportadas para demandas.

Exigências de tarefas

Algumas tarefas não serão executadas a menos que uma ou mais demandas sejam atendidas pelo agente. Por exemplo, a tarefa Visual Studio Build exige isso msbuild e visualstudio são instaladas no agente.

Demandas de agente inseridas manualmente

Talvez seja necessário usar agentes auto-hospedados com recursos especiais. Por exemplo, seu pipeline pode exigir SpecialSoftware em agentes no Default pool. Ou, se você tiver vários agentes com sistemas operacionais diferentes no mesmo pool, poderá ter um pipeline que exija um agente Linux.

Existe operação

A operação existente verifica a presença de um recurso com o nome específico. A comparação não diferencia maiúsculas de minúsculas.

pool:
  name: MyPool
  demands: myCustomCapability # exists check for myCustomCapability

Igual a operação

A operação igual verifica a existência de um recurso e, se presente, verifica seu valor com o valor especificado. Se a capacidade não estiver presente ou os valores não corresponderem, a operação será avaliada como false. As comparações não diferenciam maiúsculas de minúsculas.

pool:
  name: MyPool
  demands: Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Variáveis de agente como recursos do sistema

Os agentes auto-hospedados têm os seguintes recursos de sistema com nomes semelhantes às variáveis de agente, mas não são variáveis e não exigem sintaxe de variável ao verificar se existe ou é igual em uma demanda.

• Agent.Name
• Agent.Version
• Agent.ComputerName
• Agent.HomeDirectory
• Agent.OS
• Agent.OSArchitecture
• Agent.OSVersion (somente agentes do Windows)

Varredura de capacidades de agentes

Quando o software do agente inicia, procura os seguintes softwares e ferramentas e regista as capacidades correspondentes.

demands: string # Specify a demand for a private pool.

Exemplos

Para adicionar uma única demanda ao seu pipeline de construção YAML, adicione a linha demands: à seção pool.

pool:
  name: Default
  demands: SpecialSoftware # exists check for SpecialSoftware

demands: [ string ] # Specify a list of demands for a private pool.

Exemplos

Para especificar várias demandas, adicione uma por linha.

pool:
  name: MyPool
  demands:
  - myCustomCapability   # exists check for myCustomCapability
  - Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Ver também

• Recursos do agente