Angeben von Anforderungen

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

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.

YAML

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.

Klassisch

Fügen Sie auf der Registerkarte Aufgaben der Pipeline den Bedarf zu Ihrem Agentauftrag hinzu.

Name	Bedingung	Wert
SpecialSoftware	exists	–
Agent.OS	equals	Linux

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.

      

   2. Wählen Sie Agentpools aus.

      

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

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

      

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

      

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

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.

---