Partilhar via


definição pool.demands

Exigências (para uma piscina privada).

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

Implementações

Execução Descrição
demandas: string Especifique uma demanda para um pool privado.
demandas: lista de cadeias de caracteres Especifique uma lista de demandas para um pool privado.

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

Observação

As exigências e capacidades são projetadas para uso com agentes autoalojados, para que as tarefas possam ser atribuídas a um agente que atenda aos requisitos da tarefa. 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, não é necessário usar recursos com agentes hospedados pela Microsoft.

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)

demandas: string

Especifique uma demanda para um pool privado.

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

demands string.

Especifique uma demanda para um pool privado.

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

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

Ver também