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, stages.stage, jobs.job, jobs.deployment, preDeployHook, deployHook, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook

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.

Kommentarer

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.

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

• Ange krav
• Läs mer om villkor och tidsgränser.