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