Angeben von Anforderungen

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 bestätigt.

Hinweis

Anforderungen und Funktionen sind für die Verwendung mit selbstgehosteten Agents konzipiert, sodass Aufträge mit einem Agent abgegleichen 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 mindestens eine Anforderung vom Agent erfüllt wird. Beispielsweise erfordert der Visual Studio Buildtask, dass und auf dem Agent installiert visualstudio sind.

Manuell eingegebene Anforderungen

Möglicherweise müssen Sie selbstgehostete Agents mit speziellen Funktionen verwenden. Ihre Pipeline kann z. B. SpecialSoftware für Agents im Pool erfordern. Wenn Sie über mehrere Agents mit unterschiedlichen Betriebssystemen im selben Pool verfügen, verfügen Sie möglicherweise über eine Pipeline, für die ein Linux-Agent erforderlich ist.

Um Ihrer YAML-Buildpipeline einen einzelnen Bedarf hinzuzufügen, fügen Sie dem demands: Abschnitt die Zeile pool 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 (ist 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.

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

  1. Navigieren Sie in Ihrem Webbrowser zu Agentpools:

    1. Wählen Sie Azure DevOps, Organisationseinstellungenaus.

      Wählen Sie Organisationseinstellungen aus.

    2. Wählen Sie Agentpools aus.

      Wählen Sie die Registerkarte Agentpools aus.

    1. Wählen Sie Azure DevOps, Sammlungseinstellungenaus.

      Wählen Sie Sammlungseinstellungen aus.

    2. Wählen Sie Agentpools aus.

      Wählen Sie Agentpools aus.

    1. Wählen Sie Azure DevOps, Sammlungseinstellungenaus.

      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 verwaltenaus.

      Wählen Sie Pools verwalten, 2018 aus.

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

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

    2. Wählen Sie Pools verwaltenaus.

      Wählen Sie Pools verwalten, 2017 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Projekt verwalten (Zahnradsymbol) aus.

      Projekt verwalten, 2015.

    2. Wählen Sie Systemsteuerungaus.

      Wählen Sie Systemsteuerung, 2015 aus.

    3. Wählen Sie Agentpools aus.

      Wählen Sie Agentpools, 2015 aus.

  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 auf von Microsoft gehosteten Agents installierte 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

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

    Registerkarte

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

    Wählen Sie die Registerkarte Agentfunktionen 2015 aus.

  3. Fügen Sie etwas wie 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.