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, stages.stage, jobs.job, jobs.deployment, preDeployHook, deployHook, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook
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.
demands
zwembad.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.
demands
zwembad.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
- Vereisten opgeven
- Meer informatie over voorwaarden en time-outs.