Condividi tramite


definizione del pool

La parola chiave pool specifica quale pool da usare per un processo della pipeline. Una specifica pool contiene anche informazioni sulla strategia del processo per l'esecuzione.

Definizioni che fanno riferimento a questa definizione: pipeline, stages.stage, jobs.job, jobs.deployment, preDeployHook, deployHookok, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook

Implementazioni

Implementazione Descrizione
pool di : stringa Specificare un pool privato in base al nome.
pool : nome, richieste, vmImage Sintassi completa per l'uso di richieste e pool ospitati da Microsoft.
Implementazione Descrizione
pool di : stringa Specificare un pool privato in base al nome.
pool : nome, richieste Pool da usare per un processo della pipeline.

Osservazioni:

È possibile specificare un pool a livello di pipeline, fase o processo.

Il pool specificato al livello più basso della gerarchia viene usato per eseguire il processo.

pool: stringa

Specificare un pool privato in base al nome da usare per un processo della pipeline.

pool: string # Specify a private pool by name.

pool stringa.

Specificare un pool privato in base al nome.

Osservazioni:

Usare questa sintassi per specificare un pool privato in base al nome.

Nota

Se il nome del pool contiene uno spazio, racchiudere il nome del pool tra virgolette singole, ad esempio pool: 'My pool'.

Esempi

Per usare un pool privato senza richieste:

pool: MyPool

pool: nome, richieste, vmImage

Sintassi completa per l'uso di richieste e pool ospitati da 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.

Proprietà

name stringa.
Nome di un pool.

demands pool.demands.
richieste (per un pool privato).

vmImage stringa.
Nome dell'immagine della macchina virtuale da usare; valido solo nel pool ospitato da Microsoft.

pool: nome, richieste

Pool da usare per un processo della pipeline.

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

Proprietà

name stringa.
Nome di un pool.

demands pool.demands.
richieste (per un pool privato).

Osservazioni:

Specificare un pool ospitato da Microsoft usando la proprietà vmImage.

Se il nome del pool di agenti self-hosted contiene uno spazio, racchiudere il nome del pool tra virgolette singole, ad esempio name: 'My pool'.

Esempi

Per usare un pool ospitato da Microsoft, omettere il nome e specificare una delle immagini ospitate disponibili:

pool:
  vmImage: ubuntu-latest

È possibile specificare le richieste per un pool privato usando la sintassi completa.

Per aggiungere una singola richiesta alla pipeline di compilazione YAML, aggiungere la riga demands: alla sezione pool.

pool:
  name: Default
  demands: SpecialSoftware # exists check for SpecialSoftware

In alternativa, se è necessario aggiungere più richieste, aggiungere una per riga.

pool:
  name: MyPool
  demands:
  - myCustomCapability   # exists check for myCustomCapability
  - Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Verificare l'esistenza di una funzionalità (esistente) e verificare la presenza di una stringa specifica in una funzionalità (uguale a) sono le uniche due operazioni supportate per le richieste.

Operazione Exists

L'operazione esiste verifica la presenza di una funzionalità con il nome specifico. Il confronto non fa distinzione tra maiuscole e minuscole.

pool:
  name: MyPool
  demands: myCustomCapability # exists check for myCustomCapability

Operazione uguale a

L'operazione di uguale verifica l'esistenza di una funzionalità e, se presente, controlla il relativo valore con il valore specificato. Se la funzionalità non è presente o i valori non corrispondono, l'operazione restituisce false. I confronti non fanno distinzione tra maiuscole e minuscole.

pool:
  name: MyPool
  demands: Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Variabili dell'agente come funzionalità di sistema

Gli agenti self-hosted hanno le funzionalità di sistema seguenti con nomi simili alle variabili dell'agente, ma non sono variabili e non richiedono la sintassi delle variabili durante il controllo di esiste o è uguale a una richiesta.

  • Agent.Name
  • Agent.Version
  • Agent.ComputerName
  • Agent.HomeDirectory
  • Agent.OS
  • Agent.OSArchitecture
  • Agent.OSVersion (solo agenti Windows)

Per altre informazioni, vedere Specificare le richieste.

Vedere anche