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