Angeben von Anforderungen

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

Hinweis

In Microsoft Team Foundation Server (TFS) 2018 und früheren Versionen werden Build- und Release-Pipelines als Definitionen bezeichnet, Ausführungen werden als Builds bezeichnet, Dienstverbindungen werden als Dienstendpunkte bezeichnet, Stages werden als Umgebungen bezeichnet und Aufträge werden als Phasen bezeichnet.

Verwenden Sie Anforderungen, um sicherzustellen, dass die Funktionen, die Ihre Pipeline benötigt, auf den Agents vorhanden sind, die sie ausführen. Anforderungen werden automatisch von Aufgaben oder manuell von Ihnen geltend gemacht.

Hinweis

Anforderungen und Funktionen sind für die Verwendung mit selbstgehosteten Agents konzipiert, sodass Aufträge mit einem Agent abgeglichen werden können, der die Anforderungen des Auftrags erfüllt. Wenn Sie von Microsoft gehostete Agents verwenden, wählen Sie ein Image für den Agent aus, das den Anforderungen des Auftrags entspricht. Obwohl es möglich ist, einem von Microsoft gehosteten Agent Funktionen hinzuzufügen, müssen Sie keine Funktionen mit von Microsoft gehosteten Agents verwenden.

Aufgabenanforderungen

Einige Aufgaben werden nur ausgeführt, wenn der Agent eine oder mehrere Anforderungen erfüllt. Der Visual Studio-Buildtask erfordert beispielsweise, dass msbuild und visualstudio auf dem Agent installiert sind.

Manuell eingegebene Agent-Anforderungen

Möglicherweise müssen Sie selbstgehostete Agents mit speziellen Funktionen verwenden. Für Ihre Pipeline kann beispielsweise SpecialSoftware für Agents im Default Pool erforderlich sein. Oder wenn Sie mehrere Agents mit unterschiedlichen Betriebssystemen im selben Pool haben, verfügen Sie möglicherweise über eine Pipeline, die einen Linux-Agent erfordert.

Um Ihrer YAML-Buildpipeline eine einzelne Anforderung hinzuzufügen, fügen Sie die demands: Zeile dem pool Abschnitt hinzu.

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

Wenn Sie mehrere Anforderungen hinzufügen müssen, fügen Sie eine pro Zeile hinzu.

pool:
  name: MyPool
  demands:
  - myCustomCapability   # exists check for myCustomCapability
  - Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Hinweis

Die Überprüfung auf das Vorhandensein einer Funktion (vorhanden) und die Überprüfung auf eine bestimmte Zeichenfolge in einer Funktion (gleich) sind die einzigen beiden unterstützten Vorgänge für Anforderungen.

Weitere Informationen und Beispiele finden Sie unter YAML-Schema – Anforderungen.

YAML-Pipelines werden in Azure DevOps Server 2019 und höher unterstützt.

Registrieren Sie jeden Agent, der über die -Funktion verfügt.

  1. Navigieren Sie in Ihrem Webbrowser zu Agentpools:

    1. Wählen Sie Azure DevOps, Organisationseinstellungen aus.

      Wählen Sie Organisationseinstellungen aus.

    2. Wählen Sie Agentpools aus.

      Wählen Sie die Registerkarte Agentpools aus.

    1. Wählen Sie Azure DevOps, Sammlungseinstellungen aus.

      Wählen Sie Sammlungseinstellungen aus.

    2. Wählen Sie Agentpools aus.

      Wählen Sie Agentpools aus.

    1. Wählen Sie Azure DevOps, Sammlungseinstellungen aus.

      Sammlungseinstellungen, 2019.

    2. Wählen Sie Agentpools aus.

      Wählen Sie Agentpools, 2019 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnradsymbol) >Agent-Warteschlangen aus.

      Wählen Sie Einstellungen, Agent-Warteschlangen, 2018 aus.

    2. Wählen Sie Pools verwalten aus.

      Wählen Sie Pools verwalten aus, 2018.

  2. Navigieren Sie zur Registerkarte "Funktionen" für den Agent:

    1. Wählen Sie auf der Registerkarte Agentpools den gewünschten Agentpool aus.

      Wählen Sie unter Agentpools den gewünschten Agentpool aus.

    2. Wählen Sie Agents und dann den gewünschten Agent aus.

      Wählen Sie Agents und dann den Agent aus.

    3. Wählen Sie die Registerkarte Funktionen aus.

      Wählen Sie die Registerkarte Funktionen aus.

      Hinweis

      Von Microsoft gehostete Agents zeigen keine Systemfunktionen an. Eine Liste der von Microsoft gehosteten Agents installierten Software finden Sie unter Verwenden eines von Microsoft gehosteten Agents.

    1. Wählen Sie auf der Registerkarte Agentpools den gewünschten Pool aus.

      Wählen Sie den gewünschten Pool aus.

    2. Wählen Sie Agents und dann den gewünschten Agent aus.

      Wählen Sie Agents und dann den gewünschten Agent aus.

    3. Wählen Sie die Registerkarte Funktionen aus.

      Registerkarte

    1. Wählen Sie auf der Registerkarte Agentpools den gewünschten Pool aus.

      Wählen Sie die gewünschte Registerkarte 2019 aus.

    2. Wählen Sie Agents und dann den gewünschten Agent aus.

      Wählen Sie den gewünschten Agent 2019 aus.

    3. Wählen Sie die Registerkarte Funktionen aus.

      Wählen Sie die Registerkarte Funktionen 2019 aus.

    Wählen Sie den gewünschten Agent und dann die Registerkarte Funktionen aus.

    Registerkarte

  3. Fügen Sie etwa den folgenden Eintrag hinzu:

Erstes Feld Zweites Feld
SpecialSoftware C:\Programme (x86)\SpecialSoftware

Tipp

Bei klassischen Nicht-YAML-Builddefinitionen können Sie die Anforderungen für diese Ausführung ändern, wenn Sie einen Build manuell in die Warteschlange stellen.