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.
Navigieren Sie in Ihrem Webbrowser zu Agentpools:
Wählen Sie Azure DevOps, Organisationseinstellungen aus.
Wählen Sie Agentpools aus.
Wählen Sie Azure DevOps, Sammlungseinstellungen aus.
Wählen Sie Agentpools aus.
Wählen Sie Azure DevOps, Sammlungseinstellungen aus.
Wählen Sie Agentpools aus.
Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnradsymbol) >Agent-Warteschlangen aus.
Wählen Sie Pools verwalten aus.
Navigieren Sie zur Registerkarte "Funktionen" für den Agent:
Wählen Sie auf der Registerkarte Agentpools den gewünschten Agentpool aus.
Wählen Sie Agents und dann den gewünschten Agent 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.
Wählen Sie auf der Registerkarte Agentpools den gewünschten Pool aus.
Wählen Sie Agents und dann den gewünschten Agent aus.
Wählen Sie die Registerkarte Funktionen aus.
Wählen Sie auf der Registerkarte Agentpools den gewünschten Pool aus.
Wählen Sie Agents und dann den gewünschten Agent aus.
Wählen Sie die Registerkarte Funktionen aus.
Wählen Sie den gewünschten Agent und dann die Registerkarte Funktionen aus.
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.