Share via


definizione del pool

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

Definizioni che fanno riferimento a questa definizione: pipeline,jobs.job

Implementazioni

Implementazione Descrizione
pool: 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: stringa Specificare un pool privato in base al nome.
pool: nome, richieste Pool da usare per un processo della pipeline.

Commenti

In Azure DevOps Server 2019 è possibile specificare un pool a livello di processo in YAML e a livello di pipeline nell'interfaccia utente delle impostazioni della pipeline. In Azure DevOps Server 2019.1 è anche possibile specificare un pool a livello di pipeline in YAML se si dispone di un singolo processo implicito.

È 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.

Commenti

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'.

Esempio

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.

demandspool.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.

demandspool.demands.
Richieste (per un pool privato).

Commenti

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

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'.

Esempio

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 demands: riga alla pool sezione .

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. Per il confronto non viene effettuata alcuna distinzione tra maiuscole e minuscole.

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

Operazione uguale a

L'operazione equals 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.

Vedi anche