Partilhar via


definição do conjunto

A pool palavra-chave especifica o conjunto a utilizar para uma tarefa do pipeline. Uma pool especificação também contém informações sobre a estratégia da tarefa para execução.

Definições que referenciam esta definição: pipeline, jobs.job

Implementações

Implementação Descrição
conjunto: cadeia Especifique um conjunto privado por nome.
pool: name, demands, vmImage Sintaxe completa para utilizar exigências e conjuntos alojados na Microsoft.
Implementação Descrição
conjunto: cadeia Especifique um conjunto privado por nome.
conjunto: nome, exigências Que conjunto utilizar para uma tarefa do pipeline.

Observações

No Azure DevOps Server 2019, pode especificar um conjunto ao nível da tarefa no YAML e ao nível do pipeline na IU das definições do pipeline. No Azure DevOps Server 2019.1, também pode especificar um conjunto ao nível do pipeline no YAML se tiver uma única tarefa implícita.

Pode especificar um conjunto ao nível do pipeline, da fase ou da tarefa.

O conjunto especificado no nível mais baixo da hierarquia é utilizado para executar a tarefa.

conjunto: cadeia

Especifique um conjunto privado por nome a utilizar para uma tarefa do pipeline.

pool: string # Specify a private pool by name.

pool cadeia.

Especifique um conjunto privado por nome.

Observações

Utilize esta sintaxe para especificar um conjunto privado por nome.

Nota

Se o nome do conjunto tiver um espaço, coloque o nome do conjunto entre plicas, como pool: 'My pool'.

Exemplos

Para utilizar um conjunto privado sem necessidades:

pool: MyPool

pool: name, demands, vmImage

Sintaxe completa para utilizar exigências e conjuntos alojados na Microsoft.

pool:
  name: string # Name of a pool.
  demands: string | [ string ] # Demands (for a private pool).
  vmImage: string # Name of the VM image you want to use; valid only in the Microsoft-hosted pool.

Propriedades

name cadeia.
Nome de um conjunto.

demandspool.demands.
Exigências (para um conjunto privado).

vmImage cadeia.
Nome da imagem da VM que pretende utilizar; válido apenas no conjunto alojado pela Microsoft.

conjunto: nome, exigências

Que conjunto utilizar para uma tarefa do pipeline.

pool:
  name: string # Name of a pool.
  demands: string | [ string ] # Demands (for a private pool).

Propriedades

name cadeia.
Nome de um conjunto.

demandspool.demands.
Exigências (para um conjunto privado).

Observações

Especifique um conjunto alojado pela Microsoft com a vmImage propriedade .

Se o nome do conjunto de agentes autoalojado tiver um espaço, coloque o nome do conjunto entre plicas, como name: 'My pool'.

Exemplos

Para utilizar um conjunto alojado pela Microsoft, omita o nome e especifique uma das imagens alojadas disponíveis:

pool:
  vmImage: ubuntu-latest

Pode especificar as exigências de um conjunto privado com a sintaxe completa.

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

Em alternativa, se precisar de adicionar várias 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

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.

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 é 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 do sistema

Os agentes autoalojados têm as seguintes capacidades de sistema com nomes semelhantes às variáveis do 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)

Para obter mais informações, veja Especificar exigências.

Ver também