Freigeben über


Pooldefinition

Das pool-Schlüsselwort gibt an, welcher Pool für einen Auftrag der Pipeline verwendet werden soll. Eine pool-Spezifikation enthält auch Informationen zur Ausführungsstrategie des Auftrags.

Definitionen, die auf diese Definition verweisen: pipeline, jobs.job

Implementierungen

Implementierung Beschreibung
Pool: Zeichenfolge 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: Zeichenfolge Geben Sie einen privaten Pool anhand des Namens an.
Pool: Name, Anforderungen Welcher Pool für einen Auftrag der Pipeline verwendet werden soll.

Hinweise

In Azure DevOps Server 2019 können Sie einen Pool auf Auftragsebene in YAML und auf Pipelineebene in der Benutzeroberfläche der Pipelineeinstellungen angeben. In Azure DevOps Server 2019.1 können Sie auch einen Pool auf Pipelineebene in YAML angeben, wenn Sie über einen einzelnen impliziten Auftrag verfügen.

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

Der Pool, der auf der niedrigsten Ebene der Hierarchie angegeben ist, wird zum Ausführen des Auftrags verwendet.

Pool: Zeichenfolge

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 Schnur.

Geben Sie einen privaten Pool anhand des Namens an.

Hinweise

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

Hinweis

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

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 Schnur.
Name eines Pools.

demandspool.demands.
Anforderungen (für einen privaten Pool).

vmImage Schnur.
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 Schnur.
Name eines Pools.

demandspool.demands.
Anforderungen (für einen privaten Pool).

Hinweise

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

Wenn der Name Ihres selbstgehosteten Agentpools ein Leerzeichen enthält, schließen Sie den Poolnamen in einfache Anführungszeichen ein, z. B name: 'My pool'. .

Beispiele

Um einen von Microsoft gehosteten Pool zu verwenden, lassen Sie den Namen weg, und geben Sie eines der verfügbaren gehosteten Images an:

pool:
  vmImage: ubuntu-latest

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

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

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.

Exists-Vorgang

Der exists-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

Equals-Vorgang

Der Equals-Vorgang überprüft, ob eine Funktion vorhanden ist, und wenn vorhanden, wird deren 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

Selbstgehostete Agents verfügen über die folgenden Systemfunktionen mit ähnlichen Namen wie Agentvariablen, aber sie sind keine Variablen und erfordern keine Variablensyntax, wenn nach vorhanden oder gleich in einem Bedarf gesucht wird.

  • 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.

Weitere Informationen