Compartilhar via

definição do pool

A palavra-chave pool especifica qual pool usar para um trabalho do pipeline. Uma especificação de pool também contém informações sobre a estratégia do trabalho para execução.

Definições que fazem referência a essa definição: de pipeline, stages.stage, jobs.job, jobs.deployment, preDeployHook, deployHdeook, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook

Implementações

Implementação Descrição
pool de : de cadeia de caracteres Especifique um pool privado por nome.
pool de : nome, demandas, vmImage Sintaxe completa para usar demandas e pools hospedados pela Microsoft.
Implementação Descrição
pool de : de cadeia de caracteres Especifique um pool privado por nome.
pool de : nome, demandas Qual pool usar para um trabalho do pipeline.

Observações

Você pode especificar um pool no pipeline, estágio ou nível de trabalho.

O pool especificado no nível mais baixo da hierarquia é usado para executar o trabalho.

pool: cadeia de caracteres

Especifique um pool privado por nome a ser usado para um trabalho do pipeline.

pool: string # Specify a private pool by name.

pool cadeia de caracteres.

Especifique um pool privado por nome.

Observações

Use essa sintaxe para especificar um pool privado por nome.

Observação

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

Exemplos

Para usar um pool privado sem demandas:

pool: MyPool

pool: nome, demandas, vmImage

Sintaxe completa para usar demandas e pools hospedados pela 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 de caracteres.
Nome de um pool.

demands pool.demands.
Demandas (para um pool privado).

vmImage cadeia de caracteres.
Nome da imagem da VM que você deseja usar; válido somente no pool hospedado pela Microsoft.

pool: nome, demandas

Qual pool usar para um trabalho do pipeline.

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

Propriedades

name cadeia de caracteres.
Nome de um pool.

demands pool.demands.
Demandas (para um pool privado).

Observações

Especifique um pool hospedado pela Microsoft usando a propriedade vmImage.

Se o nome do pool de agentes auto-hospedado tiver um espaço nele, coloque o nome do pool entre aspas simples, como name: 'My pool'.

Exemplos

Para usar um pool hospedado pela Microsoft, omita o nome e especifique uma das imagens hospedadas:

pool:
  vmImage: ubuntu-latest

Você pode especificar demandas para um pool privado usando a sintaxe completa.

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

Ou se você precisar adicionar 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

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.

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)

Para obter mais informações, consulte Especificar demandas.

Consulte também