pool.demands Definition

  • Artikel

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

Weitere Informationen