Dela via


pooldefinition

Nyckelordet pool anger vilken pool som ska användas för ett jobb i pipelinen. En pool specifikation innehåller också information om jobbets strategi för körning.

Definitioner som refererar till den här definitionen: pipeline, jobs.job

Implementeringar

Implementering Description
pool: sträng Ange en privat pool efter namn.
pool: namn, krav, vmImage Fullständig syntax för användning av krav och Microsoft-värdbaserade pooler.
Implementering Description
pool: sträng Ange en privat pool efter namn.
pool: namn, krav Vilken pool som ska användas för ett jobb i pipelinen.

Kommentarer

I Azure DevOps Server 2019 kan du ange en pool på jobbnivå i YAML och på pipelinenivå i användargränssnittet för pipelineinställningar. I Azure DevOps Server 2019.1 kan du också ange en pool på pipelinenivå i YAML om du har ett enda implicit jobb.

Du kan ange en pool på pipeline-, fas- eller jobbnivå.

Poolen som anges på den lägsta nivån i hierarkin används för att köra jobbet.

pool: sträng

Ange en privat pool efter namn som ska användas för ett jobb i pipelinen.

pool: string # Specify a private pool by name.

pool Sträng.

Ange en privat pool efter namn.

Kommentarer

Använd den här syntaxen för att ange en privat pool efter namn.

Anteckning

Om poolnamnet innehåller ett blanksteg omger du poolnamnet med enkla citattecken, till exempel pool: 'My pool'.

Exempel

Så här använder du en privat pool utan krav:

pool: MyPool

pool: namn, krav, vmImage

Fullständig syntax för användning av krav och Microsoft-värdbaserade pooler.

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.

Egenskaper

name Sträng.
Namnet på en pool.

demandspool.demands.
Krav (för en privat pool).

vmImage Sträng.
Namnet på den VM-avbildning som du vill använda. endast giltigt i den Microsoft-värdbaserade poolen.

pool: namn, krav

Vilken pool som ska användas för ett jobb i pipelinen.

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

Egenskaper

name Sträng.
Namnet på en pool.

demandspool.demands.
Krav (för en privat pool).

Kommentarer

Ange en Microsoft-värdbaserad pool med hjälp av vmImage egenskapen .

Om namnet på din egen värdbaserade agentpool har ett utrymme i sig, omsluter du poolnamnet med enkla citattecken, till exempel name: 'My pool'.

Exempel

Om du vill använda en Microsoft-värdbaserad pool utelämnar du namnet och anger en av de tillgängliga värdbaserade avbildningarna:

pool:
  vmImage: ubuntu-latest

Du kan ange krav för en privat pool med hjälp av den fullständiga syntaxen.

Lägg till raden pool i demands: avsnittet om du vill lägga till en enda begäran i din YAML-byggpipeline.

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

Eller om du behöver lägga till flera krav lägger du till en per rad.

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

Kontroll av förekomsten av en funktion (finns) och kontroll av en specifik sträng i en funktion (lika med) är de enda två åtgärder som stöds för krav.

Åtgärden finns

Åtgärden exists söker efter förekomsten av en funktion med det specifika namnet. Jämförelsen är inte skiftlägeskänslig.

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

Lika med åtgärden

Lika med-åtgärden kontrollerar om det finns en funktion, och om den finns kontrollerar den dess värde med det angivna värdet. Om funktionen inte finns eller om värdena inte matchar utvärderas åtgärden till false. Jämförelserna är inte skiftlägeskänsliga.

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

Agentvariabler som systemfunktioner

Lokalt installerade agenter har följande systemfunktioner med liknande namn som agentvariabler, men de är inte variabler och kräver inte variabelsyntax när du söker efter finns eller är lika med i en efterfrågan.

  • Agent.Name
  • Agent.Version
  • Agent.ComputerName
  • Agent.HomeDirectory
  • Agent.OS
  • Agent.OSArchitecture
  • Agent.OSVersion (endast Windows-agenter)

Mer information finns i Ange krav.

Se även