Ange krav

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Anteckning

I Microsoft Team Foundation Server (TFS) 2018 och tidigare versioner kallas bygg- och versionspipelinesdefinitioner, körningar kallas builds, tjänstanslutningar kallas tjänstslutpunkter, faser kallas miljöer och jobb kallas faser.

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 hävdas automatiskt av uppgifter eller manuellt av dig.

Anteckning

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.

Uppgiftskrav

Vissa aktiviteter 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 för 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.

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

Anteckning

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.

Mer information och exempel finns i YAML-schema – krav.

YAML-pipelines stöds i Azure DevOps Server 2019 och senare.

Registrera varje agent som har funktionen .

  1. I webbläsaren navigerar du till Agentpooler:

    1. Välj Azure DevOps, Organisationsinställningar.

      Välj Organisationsinställningar.

    2. Välj Agentpooler.

      Välj fliken Agentpooler.

    1. Välj Azure DevOps, Samlingsinställningar.

      Välj Samlingsinställningar.

    2. Välj Agentpooler.

      Välj Agentpooler.

    1. Välj Azure DevOps, Samlingsinställningar.

      Samlingsinställningar, 2019.

    2. Välj Agentpooler.

      Välj Agentpooler, 2019.

    1. Gå till projektet och välj Inställningar (kugghjulsikon) >Agentköer.

      Välj Inställningar, Agentköer, 2018.

    2. Välj Hantera pooler.

      Välj Hantera pooler, 2018.

  2. Gå till fliken Funktioner för agenten:

    1. Välj önskad agentpool på fliken Agentpooler .

      Välj önskad agentpool från Agentpooler.

    2. Välj Agenter och välj önskad agent.

      Välj Agenter och välj agenten.

    3. Välj fliken Funktioner .

      Välj fliken Funktioner.

      Anteckning

      Microsoft-värdbaserade agenter visar inte systemfunktioner. En lista över programvara som är installerad på Microsoft-värdbaserade agenter finns i Använda en Microsoft-värdbaserad agent.

    1. Välj önskad pool på fliken Agentpooler .

      Välj önskad pool.

    2. Välj Agenter och välj önskad agent.

      Välj Agenter och välj önskad agent.

    3. Välj fliken Funktioner .

      Fliken Agentfunktioner.

    1. Välj önskad pool på fliken Agentpooler .

      Välj önskad flik, 2019.

    2. Välj Agenter och välj önskad agent.

      Välj önskad agent, 2019.

    3. Välj fliken Funktioner .

      Välj fliken Funktioner, 2019.

    Välj önskad agent och välj fliken Funktioner .

    Fliken Agentfunktioner, 2018.

  3. Lägg till något som liknar följande post:

Första rutan Andra rutan
SpecialSoftware C:\Program Files (x86)\SpecialSoftware

Tips

För klassiska icke-YAML-versionsdefinitioner kan du ändra kraven på körningen när du manuellt köar en version.