Dela via

pool.demands definition

Krav (för en privat pool).

Definitioner som refererar till den här definitionen: pool

Implementeringar

Genomförande Beskrivning
krav: sträng Ange ett krav för en privat pool.
krav: stränglista Ange en lista över krav för en privat pool.

Anmärkningar

Använd kraven för att se till att de funktioner som dina pipelinebehov finns på de agenter som kör den. Krav hävdas automatiskt av uppgifter eller manuellt av dig.

Anmärkning

Krav och funktioner är utformade för användning med lokalt installerade agenter så att jobb 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 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 installeras 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. Eller 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

Åtgärden finns 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

Å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 vid sökning 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

Om du vill lägga till en enda begäran i yaml-bygg-pipelinen lägger du till demands: raden i avsnittet 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 Beskrivning
snöre 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