Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Anforderungen (für einen privaten Pool).
Definitionen, die auf diese Definition verweisen: Pool
Ausführungen
Implementierung | BESCHREIBUNG |
---|---|
anforderungen: string | Geben Sie eine Anforderung für einen privaten Pool an. |
Anforderungen: Zeichenfolgenliste | Geben Sie eine Liste der Anforderungen für einen privaten Pool an. |
Bemerkungen
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 Vorgängen oder manuell von Ihnen bestätigt.
Hinweis
Anforderungen und Funktionen sind für die Verwendung mit selbstgehosteten Agents konzipiert, damit Aufträge einem Agent zugewiesen werden können, der die Anforderungen des Auftrags erfüllt. Wenn Sie von Microsoft gehostete Agents verwenden, wählen Sie ein Bild für den Agent aus, der 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.
Sie können überprüfen, ob eine Funktion vorhanden ist (Exists-Vorgang) oder sie können eine bestimmte Zeichenfolge in einer Funktion (Equals-Vorgang) überprüfen. 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.
Aufgabenanforderungen
Einige Aufgaben werden nicht ausgeführt, es sei denn, eine oder mehrere Anforderungen werden vom Agent erfüllt. Die Visual Studio Build-Aufgabe erfordert beispielsweise, dass msbuild
sie auf dem Agent installiert und visualstudio
installiert sind.
Manuell eingegebene Agentanforderungen
Möglicherweise müssen Sie selbst gehostete Agents mit speziellen Funktionen verwenden. Ihre Pipeline kann z. B. SpecialSoftware für Agents im Default
Pool erfordern. Oder wenn Sie über mehrere Agents mit unterschiedlichen Betriebssystemen im selben Pool verfügen, verfügen Sie möglicherweise über eine Pipeline, die einen Linux-Agent erfordert.
Vorhandener Vorgang
Der Vorgang "Exists" sucht nach dem Vorhandensein einer Funktion mit dem spezifischen Namen. Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.
pool:
name: MyPool
demands: myCustomCapability # exists check for myCustomCapability
Gleich Vorgang
Der Gleiche Vorgang überprüft das Vorhandensein einer Funktion, und wenn vorhanden, wird der Wert mit dem angegebenen Wert überprüft. Wenn die Funktion nicht vorhanden ist oder die Werte nicht übereinstimmen, wird der Vorgang als "false" ausgewertet. Bei den Vergleichen wird die Groß-/Kleinschreibung nicht beachtet.
pool:
name: MyPool
demands: Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0
Agentvariablen als Systemfunktionen
Selbst gehostete Agents verfügen über die folgenden Systemfunktionen mit ähnlichen Namen wie Agentvariablen, aber sie sind keine Variablen und erfordern keine Variablesyntax, wenn die Überprüfung vorhanden oder gleich einer Anforderung ist.
- Agent.Name
- Agent.Version
- Agent.ComputerName
- Agent.HomeDirectory
- Agent.OS
- Agent.OSArchitecture
- Agent.OSVersion (nur Windows-Agents)
anforderungen: string
Geben Sie eine Anforderung für einen privaten Pool an.
demands: string # Specify a demand for a private pool.
demands
Zeichenfolge.
Geben Sie eine Anforderung für einen privaten Pool an.
Beispiele
Um Ihrer YAML-Buildpipeline eine einzelne Anforderung hinzuzufügen, fügen Sie die demands:
Zeile zum Abschnitt pool
hinzu.
pool:
name: Default
demands: SpecialSoftware # exists check for SpecialSoftware
Anforderungen: Zeichenfolgenliste
Geben Sie eine Liste der Anforderungen für einen privaten Pool an.
demands: [ string ] # Specify a list of demands for a private pool.
Listentypen
Typ | BESCHREIBUNG |
---|---|
Schnur | Geben Sie eine Liste der Anforderungen für einen privaten Pool an. |
Beispiele
Um mehrere Anforderungen anzugeben, 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