Dela via


pool.demands-definition

Krav (för en privat pool).

Definitioner som refererar till den här definitionen: pool

Implementeringar

Implementering Description
krav: sträng Ange ett krav för en privat pool.
krav: stränglista Ange en lista över krav för en privat pool.

Kommentarer

Använd krav för att se till att de funktioner som din pipeline behöver finns på de agenter som kör den. Krav utförs automatiskt av uppgifter eller manuellt av dig.

Anteckning

Krav och funktioner är utformade för användning med lokalt installerade agenter så att jobben kan matchas med en agent som uppfyller kraven för jobbet. När du använder Microsoft-värdbaserade agenter väljer du en avbildning för agenten som matchar kraven för jobbet, så även om det är möjligt att lägga till funktioner i en Microsoft-värdbaserad agent behöver du inte använda funktioner med Microsoft-värdbaserade agenter.

Du kan söka efter förekomsten av en funktion (finns åtgärd) eller så kan du söka efter en specifik sträng i en funktion (lika med-åtgärd). Att kontrollera om det finns en funktion (finns) och att söka efter en specifik sträng i en funktion (lika med) är de enda två åtgärder som stöds för krav.

Uppgiftskrav

Vissa uppgifter körs inte om inte ett eller flera krav uppfylls av agenten. Visual Studio Build-uppgiften kräver till exempel att msbuild och visualstudio är installerade på agenten.

Manuellt angivna agentkrav

Du kan behöva använda lokalt installerade agenter med särskilda funktioner. Din pipeline kan till exempel kräva SpecialSoftware på agenter i Default poolen. Om du har flera agenter med olika operativsystem i samma pool kan du ha en pipeline som kräver en Linux-agent.

Åtgärden Finns

Den existerande åtgärden 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ärd

Åtgärden är lika med 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 på begäran.

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

krav: sträng

Ange ett krav för en privat pool.

demands: string # Specify a demand for a private pool.

demands Sträng.

Ange ett krav för en privat pool.

Exempel

Lägg till raden i demands: avsnittet om du vill lägga till ett enskilt behov i yaml-bygg-pipelinen pool .

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

krav: stränglista

Ange en lista över krav för en privat pool.

demands: [ string ] # Specify a list of demands for a private pool.

Listtyper

Typ Description
sträng Ange en lista över krav för en privat pool.

Exempel

Om du vill ange 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

Se även