definition "pool.demands"

Ausführungen

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.

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)

Agentenfähigkeits-Scannen

Wenn die Agentensoftware startet, scannt sie nach folgender Software und Tools und registriert die entsprechenden Funktionen.

demands: string # Specify a demand for a private pool.

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

demands: [ string ] # Specify a list of demands for a private pool.

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

• Agent-Funktionen