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
demands: string Especifique uma demanda por um pool privado.
demands: string list Especifique uma lista de demandas para um pool privado.

Comentários

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 marcar para a presença de uma funcionalidade (operação Existe) ou pode marcar para uma cadeia de caracteres específica em uma funcionalidade (operação Equals). Verificar a existência de uma funcionalidade (existe) e verificar se há uma cadeia de caracteres específica em uma funcionalidade (igual a) são as duas únicas operações com suporte para demandas.

Demandas de tarefas

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 que msbuild e visualstudio sejam instalados 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 pool do Default. 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 existente 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 equals

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 se 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

Os 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)

demands: string

Especifique uma demanda por um pool privado.

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

demands String.

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

demands: string list

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
string 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

Confira também