pool.demands Definition
Anforderungen (für einen privaten Pool).
Definitionen, die auf diese Definition verweisen: Pool
Implementierungen
| Implementierung | Beschreibung |
|---|---|
| Anforderungen: Zeichenfolge | Geben Sie eine Anforderung für einen privaten Pool an. |
| Anforderungen: Zeichenfolgenliste | Geben Sie eine Liste der Anforderungen für einen privaten Pool an. |
Hinweise
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, 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 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 bei von Microsoft gehosteten Agents keine Funktionen 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 nur ausgeführt, wenn der Agent eine oder mehrere Anforderungen erfüllt. Die Visual Studio-Buildaufgabe 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. Wenn Sie mehrere Agents mit unterschiedlichen Betriebssystemen im selben Pool haben, verfügen Sie möglicherweise über eine Pipeline, die einen Linux-Agent erfordert.
Vorhandener Vorgang
Der vorhandene Vorgang überprüft, ob eine Funktion mit dem spezifischen Namen vorhanden ist. Beim Vergleich wird die Groß- und Kleinschreibung nicht berücksichtigt.
pool:
name: MyPool
demands: myCustomCapability # exists check for myCustomCapability
Gleich Vorgang
Der Equals-Vorgang überprüft, ob eine Funktion vorhanden ist, und, falls vorhanden, wird deren Wert mit dem angegebenen Wert überprüft. Wenn die Funktion nicht vorhanden ist oder die Werte nicht übereinstimmen, wird der Vorgang auf 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
Selbstgehostete Agents verfügen über die folgenden Systemfunktionen mit ähnlichen Namen wie Agentvariablen, aber sie sind keine Variablen und erfordern keine Variablensyntax, wenn die Überprüfung auf vorhanden ist oder gleich in einer Anforderung ist.
- Agent.Name
- Agent.Version
- Agent.ComputerName
- Agent.HomeDirectory
- Agent.OS
- Agent.OSArchitecture
- Agent.OSVersion (nur Windows-Agents)
Anforderungen: Zeichenfolge
Geben Sie eine Anforderung für einen privaten Pool an.
demands: string # Specify a demand for a private pool.
demands Schnur.
Geben Sie eine Anforderung für einen privaten Pool an.
Beispiele
Um Ihrer YAML-Buildpipeline eine einzelne Anforderung hinzuzufügen, fügen Sie dem Abschnitt pool die Zeile demands: 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 |
|---|---|
| Zeichenfolge | 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