Freigeben über


Pooldefinition

Das schlüsselwort pool gibt an, welche Pool für einen Auftrag der Pipeline verwendet werden soll. Eine pool Spezifikation enthält auch Informationen zur Strategie des Auftrags für die Ausführung.

Definitionen, die auf diese Definition verweisen: Pipeline, stages.stage, jobs.job, jobs.deployment, preDeployHook, deployHoo, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook

Ausführungen

Implementierung BESCHREIBUNG
Pool: Zeichenfolgen- Geben Sie einen privaten Pool anhand des Namens an.
Pool: Name, Anforderungen, vmImage- Vollständige Syntax für die Verwendung von Anforderungen und von Microsoft gehosteten Pools.
Implementierung BESCHREIBUNG
Pool: Zeichenfolgen- Geben Sie einen privaten Pool anhand des Namens an.
Pool: Name, Anforderungen Welcher Pool für einen Auftrag der Pipeline verwendet werden soll.

Bemerkungen

Sie können einen Pool auf Pipeline-, Phasen- oder Auftragsebene angeben.

Der auf der niedrigsten Ebene der Hierarchie angegebene Pool wird verwendet, um den Auftrag auszuführen.

pool: string

Geben Sie einen privaten Pool anhand des Namens an, der für einen Auftrag der Pipeline verwendet werden soll.

pool: string # Specify a private pool by name.

pool Zeichenfolge.

Geben Sie einen privaten Pool anhand des Namens an.

Bemerkungen

Verwenden Sie diese Syntax, um einen privaten Pool anhand des Namens anzugeben.

Hinweis

Wenn ihr Poolname ein Leerzeichen enthält, schließen Sie den Poolnamen in einfache Anführungszeichen ein, z. B. pool: 'My pool'.

Beispiele

So verwenden Sie einen privaten Pool ohne Anforderungen:

pool: MyPool

Pool: Name, Anforderungen, vmImage

Vollständige Syntax für die Verwendung von Anforderungen und von Microsoft gehosteten Pools.

pool:
  name: string # Name of a pool.
  demands: string | [ string ] # Demands (for a private pool).
  vmImage: string # Name of the VM image you want to use; valid only in the Microsoft-hosted pool.

Eigenschaften

name Zeichenfolge.
Name eines Pools.

demands pool.anforderungen.
Anforderungen (für einen privaten Pool).

vmImage Zeichenfolge.
Name des vm-Images, das Sie verwenden möchten; nur im von Microsoft gehosteten Pool gültig.

Pool: Name, Anforderungen

Welcher Pool für einen Auftrag der Pipeline verwendet werden soll.

pool:
  name: string # Name of a pool.
  demands: string | [ string ] # Demands (for a private pool).

Eigenschaften

name Zeichenfolge.
Name eines Pools.

demands pool.anforderungen.
Anforderungen (für einen privaten Pool).

Bemerkungen

Geben Sie einen von Microsoft gehosteten Pool mithilfe der eigenschaft vmImage an.

Wenn ihr selbst gehosteter Agentpoolname ein Leerzeichen enthält, schließen Sie den Poolnamen in einfache Anführungszeichen ein, z. B. name: 'My pool'.

Beispiele

Wenn Sie einen von Microsoft gehosteten Pool verwenden möchten, geben Sie den Namen aus, und geben Sie einen der verfügbaren gehosteten Imagesan:

pool:
  vmImage: ubuntu-latest

Sie können Anforderungen für einen privaten Pool mithilfe der vollständigen Syntax angeben.

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

Oder wenn Sie mehrere Anforderungen hinzufügen müssen, 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

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.

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)

Weitere Informationen finden Sie unter Angeben von Anforderungen.

Siehe auch