Compartilhar via


Definição de pool.demands

Demandas (para um pool privado).

Definições que fazem referência a essa definição: pool

Implementações

Implementação Descrição
demandas: cadeia de caracteres Especifique uma demanda por um pool privado.
demandas: lista de cadeias de caracteres Especifique uma lista de demandas para um pool privado.

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ê.

Observação

As demandas e os recursos são criados para serem usados com agentes auto-hospedados para que os trabalhos possam ser correspondidos com um agente que atenda aos requisitos do trabalho. Ao usar agentes hospedados pela Microsoft, você seleciona uma imagem para o agente que corresponde aos requisitos do trabalho, portanto, embora seja possível adicionar recursos a um agente hospedado pela Microsoft, você não precisa usar recursos com agentes hospedados pela Microsoft.

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)

demandas: cadeia de caracteres

Especifique uma demanda por um pool privado.

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

demands cadeia de caracteres.

Especifique uma demanda por um pool privado.

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

demandas: lista de cadeias de caracteres

Especifique uma lista de demandas para um pool privado.

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

Tipos de lista

Tipo Descrição
corda Especifique uma lista de demandas para um pool privado.

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