Partilhar via


definição pool.demands

Exigências (para um conjunto privado).

Definições que referenciam esta definição: conjunto

Implementações

Implementação Descrição
exigências: cadeia Especifique uma procura de um conjunto privado.
demands: string list Especifique uma lista de exigências de um conjunto privado.

Observações

Utilize as exigências para se certificar de que as capacidades de que o pipeline precisa estão presentes nos agentes que o executam. As exigências são afirmadas automaticamente por tarefas ou manualmente por si.

Nota

As exigências e as capacidades foram concebidas para utilização com agentes autoalojados para que as tarefas possam ser correspondidas a um agente que cumpra os requisitos da tarefa. Ao utilizar agentes alojados na Microsoft, seleciona uma imagem para o agente que corresponde aos requisitos da tarefa, pelo que, embora seja possível adicionar capacidades a um agente alojado pela Microsoft, não precisa de utilizar capacidades com agentes alojados na Microsoft.

Pode verificar a presença de uma capacidade (operação Existe) ou pode verificar se existe uma cadeia específica numa capacidade (Operação igual). Verificar a existência de uma capacidade (existe) e verificar a existência de uma cadeia específica numa capacidade (igual a) são as duas únicas operações suportadas para pedidos.

Exigências de tarefas

Algumas tarefas não serão executadas a menos que uma ou mais exigências sejam satisfeitas pelo agente. Por exemplo, a tarefa Compilação do Visual Studio exige isso msbuild e visualstudio está instalada no agente.

Exigências de agente introduzidas manualmente

Poderá ter de utilizar agentes autoalojados com capacidades especiais. Por exemplo, o pipeline pode necessitar de SpecialSoftware em agentes no Default conjunto. Em alternativa, se tiver vários agentes com sistemas operativos diferentes no mesmo conjunto, poderá ter um pipeline que requer um agente Linux.

Existe operação

A operação existente verifica a presença de uma capacidade com o nome específico. A comparação não é sensível a maiúsculas e minúsculas.

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

É igual a operação

A operação de igual verifica a existência de uma capacidade e, se estiver presente, verifica o respetivo valor com o valor especificado. Se a capacidade não estiver presente ou os valores não corresponderem, a operação será avaliada como falsa. As comparações não são sensíveis a maiúsculas e 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 capacidades de sistema

Os agentes autoalojados têm as seguintes capacidades de sistema com nomes semelhantes às variáveis de agente, mas não são variáveis e não necessitam de sintaxe variável ao verificar se existe ou é igual a uma procura.

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

exigências: cadeia

Especifique uma procura de um conjunto privado.

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

demands cadeia.

Especifique uma procura de um conjunto privado.

Exemplos

Para adicionar uma única procura ao pipeline de compilação YAML, adicione a demands: linha à pool secção.

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

demands: string list

Especifique uma lista de exigências de um conjunto privado.

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

Tipos de lista

Tipo Description
cadeia (de carateres) Especifique uma lista de exigências de um conjunto privado.

Exemplos

Para especificar múltiplas exigências, 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