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, stages.stage, jobs.job, jobs.deployment, preDeployHook, deployHook, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook
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.
demands
pool.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.
demands
pool.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
- Angeben von Anforderungen
- Erfahren Sie mehr über Bedingungen und Timeouts.