Freigeben über

definition "pool.demands"

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

Siehe auch