Compartilhar via


definição de pool

A palavra-chave pool especifica qual pool deve ser usado para um trabalho do pipeline. Uma especificação 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: pipeline, jobs.job

Implementações

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

Comentários

No Azure DevOps Server 2019, você pode especificar um pool no nível do trabalho no YAML e no nível do pipeline na interface do usuário das configurações do pipeline. No Azure DevOps Server 2019.1, você também poderá especificar um pool no nível do pipeline no YAML ,se tiver um único trabalho implícito.

Você pode especificar um pool no nível de pipeline, fase ou 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 String.

Especifique um pool privado por nome.

Comentários

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 String.
Nome de um pool.

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

vmImage String.
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 String.
Nome de um pool.

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

Comentários

Especifique um pool hospedado pela Microsoft usando a vmImage propriedade .

Se o nome do pool de agentes auto-hospedado tiver um espaço, 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 disponíveis:

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 se há uma cadeia de caracteres específica em uma funcionalidade (igual a) são as duas únicas operações com suporte para demandas.

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)

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

Confira também