Delen via


pooldefinitie

Het pool trefwoord geeft aan welke pool moet worden gebruikt voor een taak van de pijplijn. Een pool specificatie bevat ook informatie over de strategie van de taak voor het uitvoeren.

Definities die naar deze definitie verwijzen: pipeline, jobs.job

Implementaties

Implementatie Beschrijving
pool: tekenreeks Geef een privégroep op naam op.
pool: naam, eisen, vmImage Volledige syntaxis voor het gebruik van vereisten en door Microsoft gehoste pools.
Implementatie Beschrijving
pool: tekenreeks Geef een privégroep op naam op.
pool: naam, eisen Welke pool moet worden gebruikt voor een taak van de pijplijn.

Opmerkingen

In Azure DevOps Server 2019 kunt u een pool opgeven op taakniveau in YAML en op pijplijnniveau in de gebruikersinterface van de pijplijninstellingen. In Azure DevOps Server 2019.1 kunt u ook een pool opgeven op pijplijnniveau in YAML als u één impliciete taak hebt.

U kunt een pool opgeven op pijplijn-, fase- of taakniveau.

De pool die is opgegeven op het laagste niveau van de hiërarchie, wordt gebruikt om de taak uit te voeren.

pool: tekenreeks

Geef een privégroep op met de naam die moet worden gebruikt voor een taak van de pijplijn.

pool: string # Specify a private pool by name.

pool Tekenreeks.

Geef een privégroep op naam op.

Opmerkingen

Gebruik deze syntaxis om een privégroep op naam op te geven.

Notitie

Als de naam van uw pool een spatie bevat, plaatst u de naam van de pool tussen enkele aanhalingstekens, zoals pool: 'My pool'.

Voorbeelden

Een privé zwembad zonder vereisten gebruiken:

pool: MyPool

pool: naam, eisen, vmImage

Volledige syntaxis voor het gebruik van vereisten en door Microsoft gehoste 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.

Eigenschappen

name Tekenreeks.
Naam van een groep.

demandszwembad.eisen.
Eisen (voor een privé zwembad).

vmImage Tekenreeks.
Naam van de VM-installatiekopieën die u wilt gebruiken; alleen geldig in de door Microsoft gehoste pool.

pool: naam, eisen

Welke pool moet worden gebruikt voor een taak van de pijplijn.

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

Eigenschappen

name Tekenreeks.
Naam van een groep.

demandszwembad.eisen.
Eisen (voor een privé zwembad).

Opmerkingen

Geef een door Microsoft gehoste pool op met behulp van de vmImage eigenschap .

Als de naam van de zelf-hostende agentpool een spatie bevat, plaatst u de naam van de pool tussen enkele aanhalingstekens, zoals name: 'My pool'.

Voorbeelden

Als u een door Microsoft gehoste pool wilt gebruiken, laat u de naam weg en geeft u een van de beschikbare gehoste installatiekopieën op:

pool:
  vmImage: ubuntu-latest

U kunt eisen voor een privégroep opgeven met behulp van de volledige syntaxis.

Als u één vraag wilt toevoegen aan uw YAML-build-pijplijn, voegt u de demands: regel toe aan de pool sectie.

pool:
  name: Default
  demands: SpecialSoftware # exists check for SpecialSoftware

Of als u meerdere vereisten wilt toevoegen, voegt u er één per regel toe.

pool:
  name: MyPool
  demands:
  - myCustomCapability   # exists check for myCustomCapability
  - Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Controleren op het bestaan van een mogelijkheid (bestaat) en controleren op een specifieke tekenreeks in een mogelijkheid (is gelijk aan) zijn de enige twee ondersteunde bewerkingen voor vereisten.

Bestaat-bewerking

De exists-bewerking controleert op de aanwezigheid van een mogelijkheid met de specifieke naam. De vergelijking is niet hoofdlettergevoelig.

pool:
  name: MyPool
  demands: myCustomCapability # exists check for myCustomCapability

Is gelijk aan bewerking

De bewerking is gelijk aan controleert op het bestaan van een mogelijkheid en, indien aanwezig, controleert de waarde ervan met de opgegeven waarde. Als de mogelijkheid niet aanwezig is of als de waarden niet overeenkomen, wordt de bewerking geëvalueerd als onwaar. De vergelijkingen zijn niet hoofdlettergevoelig.

pool:
  name: MyPool
  demands: Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Agentvariabelen als systeemmogelijkheden

Zelf-hostende agents hebben de volgende systeemmogelijkheden met vergelijkbare namen als agentvariabelen, maar ze zijn geen variabelen en vereisen geen syntaxis van variabelen wanneer wordt gecontroleerd op bestaat of gelijk is aan in een vraag.

  • Agent.Name
  • Agent.Version
  • Agent.ComputerName
  • Agent.HomeDirectory
  • Agent.OS
  • Agent.OSArchitecture
  • Agent.OSVersion (alleen Windows-agents)

Zie Vereisten opgeven voor meer informatie.

Zie ook