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, stages.stage, jobs.job, jobs.deployment, preDeployHook, deployHook, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook
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.
demands
pool.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.
demands
pool.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
- Especificar demandas
- Saiba mais sobre condições e tempos limite.