Definição de pool.demands

Implementações

Observações

Use as demandas para garantir que as funcionalidades que seu pipeline precisa estejam presentes nos agentes que o executam. As demandas são declaradas automaticamente por tarefas ou manualmente por você.

Você pode verificar a presença de uma funcionalidade (operação Exists) ou verificar se há uma cadeia de caracteres específica em uma funcionalidade (operação Equals). Verificar a existência de uma funcionalidade (existe) e verificar uma cadeia de caracteres específica em uma funcionalidade (igual) são as duas únicas operações com suporte para demandas.

Demandas de tarefa

Algumas tarefas não serão executadas a menos que uma ou mais demandas sejam atendidas pelo agente. Por exemplo, a tarefa Build do Visual Studio exige isso msbuild e visualstudio está instalada 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 do Linux.

Operação Exists

A operação existe verifica a presença de uma funcionalidade 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

Operação de igual

A operação de igual verifica a existência de uma funcionalidade e, se presente, verifica seu valor com o valor especificado. Se a funcionalidade 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 funcionalidades do sistema

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

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

Escaneamento de capacidade de agentes

Quando o software agente inicia, ele escaneia os seguintes softwares e ferramentas e registra as capacidades correspondentes.

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

Exemplos

Para adicionar uma única demanda ao pipeline de build do 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

Consulte também

• Funcionalidades do agente