Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Een agentgroep is een verzameling agents. In plaats van elke agent afzonderlijk te beheren, organiseert u agents in agentgroepen. Wanneer u een agent configureert, wordt deze geregistreerd bij één groep. Wanneer u een pijplijn maakt, specificeert u de pool waarin de pijplijn wordt uitgevoerd. Wanneer u de pijplijn uitvoert, wordt deze uitgevoerd op een agent uit die pool die voldoet aan de vereisten van de pijplijn.
Beheerde DevOps Pools-agentgroepen worden beheerd in Azure Portal. Als u beheerde DevOps-pools gebruikt, raadpleegt u de quickstart voor het maken van een pool.
In Azure Pipelines zijn pools gericht op de hele organisatie, zodat u agentmachines kunt delen in projecten.
In Azure DevOps Server zijn agentpools gericht op de hele server, zodat u agentcomputers kunt delen tussen projecten en verzamelingen.
Taken voor agentpools voeren een taak uit op één agent. Als u een taak wilt uitvoeren op alle agents, zoals een implementatiegroep voor klassieke release-pijplijnen, zie Implementatiegroepen inrichten.
Als u een organisatiebeheerder bent, maakt en beheert u agentgroepen op het tabblad Agentpools in de beheerinstellingen.
Meld u aan bij uw organisatie (
https://dev.azure.com/{yourorganization}).Selecteer Azure>.
Selecteer Agentpools.
Meld u aan bij uw projectverzameling (
http://your-server/DefaultCollection).Selecteer Azure DevOps>verzamelingsinstellingen.
Selecteer Agentpools.
Als u lid bent van een projectteam, maakt en beheert u agentpools op het tabblad Agentpools in projectinstellingen.
Ga naar uw project en selecteer Projectinstellingen>Agentgroepen.
Ga naar uw project en selecteer Projectinstellingen>Agentgroepen.
Standaard agentenpools
De volgende agentpools worden standaard geleverd:
- Standaardgroep: Gebruik deze om zelfgehoste agents te registreren die u hebt ingesteld.
- Azure Pipelines: deze gehoste pool wordt geleverd met verschillende Windows-, Linux- en macOS-installatiekopieën. Zie Microsoft-hosted agents voor een volledige lijst van de beschikbare afbeeldingen en hun geïnstalleerde software.
Standaard zijn alle bijdragers in een project lid van de User-rol voor gehoste pools. Met deze aanduiding kan elke inzender in een project pijplijnen maken en uitvoeren met door Microsoft gehoste agents.
Een pool in uw pijplijn aanwijzen
Als u een door Microsoft gehoste agent wilt kiezen uit de Azure Pipelines-pool in uw YAML-pijplijn van Azure DevOps Services, geeft u de naam van de installatiekopie op met behulp van het YAML VM-installatiekopielabel uit deze tabel.
pool:
vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.
Als u een privépool wilt gebruiken zonder dat dit nodig is:
pool: MyPool
Zie het YAML-schema voor pools voor meer informatie.
Pools en wachtrijen beheren
Organisatiebeheerders maken en beheren agentpools op het tabblad Agentpools in beheerinstellingen.
Meld u aan bij uw organisatie (
https://dev.azure.com/{yourorganization}).Selecteer Azure>.
Selecteer Agentpools.
Meld u aan bij uw projectverzameling (
http://your-server/DefaultCollection).Selecteer Azure DevOps>verzamelingsinstellingen.
Selecteer Agentpools.
Projectteamleden maken en beheren agentgroepen op het tabblad Agentpools in projectinstellingen.
Ga naar uw project en selecteer Projectinstellingen>Agentgroepen.
Ga naar uw project en selecteer Projectinstellingen>Agentgroepen.
Als u een pool wilt verwijderen, gaat u naar de lijst met agentpools en selecteert u vervolgens Meer opties>Verwijderen.
Pools worden gebruikt om taken uit te voeren. Meer informatie over het opgeven van pools voor taken.
Als u veel zelf-gehoste agents hebt die voor verschillende teams of doeleinden bedoeld zijn, kunt u meer pools maken. Gebruik de volgende instructies.
Agentpools maken
Hier zijn enkele typische situaties waarin u zelf-beheerde agentpools wilt maken.
U bent lid van een project en wilt een set machines gebruiken waarvan uw team eigenaar is om build- en implementatietaken uit te voeren:
- Zorg ervoor dat u gemachtigd bent om pools in uw project te maken. Ga in Project-instellingen naar het deelvenster Agentpools en selecteer Beveiliging. Als u nieuwe pools wilt maken, moet u de rol Beheerder hebben.
- Selecteer Groep toevoegen en selecteer vervolgens de optie om een nieuwe pool te maken.
- Installeer en configureer agents die deel uitmaken van de nieuwe agentgroep.
U bent lid van het infrastructuurteam en wilt een groep agents instellen voor gebruik in alle projecten:
- Zorg ervoor dat u gemachtigd bent om pools in uw project te maken. Ga in de organisatie-instellingen naar het deelvenster Agentpools en selecteer Beveiliging.
- Maak een nieuwe agentgroep en selecteer de optie Deze agentpool automatisch inrichten in alle projecten wanneer u de pool maakt. Deze instelling zorgt ervoor dat alle projecten toegang hebben tot deze agentgroep.
- Installeer en configureer agents die deel uitmaken van de nieuwe agentgroep.
U wilt een set agent-machines delen met sommige, maar niet alle projecten:
- Ga naar Instellingen voor een van de projecten. Voeg een agentgroep toe en selecteer de optie om een nieuwe pool te maken op organisatieniveau.
- Ga naar de andere projecten en maak een pool in elk van deze projecten. Selecteer Een bestaande agentgroep uit de organisatie gebruiken.
- Installeer en configureer agents die deel uitmaken van de gedeelde agentgroep.
U bent lid van een project en wilt een set machines gebruiken waarvan uw team eigenaar is om build- en implementatietaken uit te voeren:
- Zorg ervoor dat u gemachtigd bent om pools in uw project te maken. Ga in Project-instellingen naar het deelvenster Agentpools en selecteer Beveiliging. Als u nieuwe pools wilt maken, moet u de rol Beheerder hebben.
- Selecteer Groep toevoegen en selecteer vervolgens de optie om een nieuwe pool te maken.
- Installeer en configureer agents die deel uitmaken van de nieuwe agentgroep.
U bent lid van het infrastructuurteam en wilt een groep agents instellen voor gebruik in alle projecten:
- Zorg ervoor dat u over de machtigingen beschikt om pools in uw project te maken. Ga in de organisatie-instellingen naar het deelvenster Agentpools en selecteer Beveiliging.
- Maak een nieuwe agentgroep en selecteer de optie Deze agentpool automatisch inrichten in alle projecten wanneer u de pool maakt. Deze instelling zorgt ervoor dat alle projecten toegang hebben tot deze agentgroep.
- Installeer en configureer agents die deel uitmaken van de nieuwe agentgroep.
U wilt een set agent-machines delen met sommige, maar niet alle projecten:
- Ga naar Instellingen voor een van de projecten. Voeg een agentgroep toe en selecteer de optie om een nieuwe pool te maken op organisatieniveau.
- Ga naar de andere projecten en maak een pool in elk van deze projecten. Selecteer Een bestaande agentgroep uit de organisatie gebruiken.
- Installeer en configureer agents die deel uitmaken van de gedeelde agentgroep.
Beveiliging van agentenpools
Wanneer u begrijpt hoe beveiliging werkt voor agentgroepen, kunt u het delen en gebruiken van agents beter beheren.
Rollen worden gedefinieerd voor elke agentgroep. Lidmaatschap van deze rollen bepaalt welke bewerkingen u kunt uitvoeren in een agentgroep.
Beveiligingsinstellingen op organisatieniveau
| Rol in een agentgroep in Organisatie-instellingen | Doel |
|---|---|
| Reader | Leden van deze rol kunnen de agent-pool en agenten bekijken. Doorgaans gebruikt u deze rol om operators toe te voegen die verantwoordelijk zijn voor het bewaken van de agents en hun gezondheid. |
| Serviceaccount | Leden van deze rol kunnen de organisatieagentgroep gebruiken om een projectagentgroep in een project te maken. Als u de vorige richtlijnen volgt om nieuwe projectagentgroepen te maken, hoeft u hier doorgaans geen leden toe te voegen. |
| Beheerder | Naast alle bovenstaande machtigingen kunnen leden van deze rol agents registreren of de registratie van agents uit de groep van de organisatieagent ongedaan maken. Ze kunnen ook verwijzen naar de organisatieagentgroep wanneer ze een projectagentgroep in een project maken. Ze kunnen ook lidmaatschap beheren voor alle rollen van de organisatieagentgroep. Aan een gebruiker die een organisatieagentgroep maakt, wordt automatisch de beheerdersrol voor die groep toegewezen. |
Het knooppunt Alle agentgroepen op het tabblad Agentgroepen bepaalt de beveiliging van alle organisatieagentgroepen. Roltoewijzingen voor individuele agentgroepen van de organisatie worden automatisch overgenomen van de knoop Alle agentgroepen. Standaard zijn Azure DevOps Server-beheerders ook beheerders van het knooppunt Alle agentpools bij het gebruik van Azure DevOps Server.
Beveiligingsinstellingen op projectniveau
Rollen worden ook gedefinieerd voor elke projectagentgroep. Lidmaatschap van deze rollen bepaalt welke bewerkingen u op projectniveau kunt uitvoeren op een agentgroep.
| Rol in een agentgroep in Projectinstellingen | Doel |
|---|---|
| Reader | Leden van deze rol kunnen de groep met projectagenten bekijken. Normaal gesproken gebruikt u deze rol om operators toe te voegen die de build- en implementatietaken in die projectagentgroep bewaken. |
| User | Leden van deze rol kunnen de projectagentgroep gebruiken wanneer ze pijplijnen maken. |
| Beheerder | Naast alle bovenstaande bewerkingen kunnen leden van deze rol lidmaatschap beheren voor alle rollen van de projectagentgroep. Aan een gebruiker die een organisatieagentgroep maakt, wordt automatisch de beheerdersrol voor die groep toegewezen. |
Pijplijnmachtigingen
Met pijplijnmachtigingen bepaalt u welke YAML-pijplijnen zijn gemachtigd om een agentgroep te gebruiken. Pijplijnmachtigingen beperken de toegang van klassieke pijplijnen niet.
Kies een van de volgende processen:
- Open toegang voor alle pijplijnen om de agentgroep te gebruiken vanuit de meer opties in de rechterbovenhoek van de sectie Pijplijnmachtigingen op het tabblad Beveiliging van een agentgroep.
- Vergrendel de agentgroep en sta alleen geselecteerde YAML-pijplijnen toe om deze te gebruiken. Als een andere YAML-pijplijn verwijst naar de agentgroep, wordt er een autorisatieaanvraag gegenereerd, die een agentgroepbeheerder moet goedkeuren. Dit proces beperkt de toegang van klassieke pijplijnen niet.
Pijplijnmachtigingen voor de Azure Pipelines-agentgroep kunnen niet worden geconfigureerd, omdat de pool standaard toegankelijk is voor alle pijplijnen.
Met de actie Beveiliging op het tabblad Agentgroepen bepaalt u de beveiliging van alle projectagentpools in een project. Roltoewijzingen voor individuele projectagentenpools worden automatisch overgenomen van wat u hier definieert. Standaard worden de volgende groepen toegevoegd aan de beheerdersrol van alle agentgroepen: Build Administrators, Release Administrators en Project Administrators.
Veelgestelde vragen
Als ik geen onderhoudsvenster plant, wanneer voeren de agents onderhoud uit?
Als u geen venster plant, voeren de agents in die pool de onderhoudstaak niet uit.
Wat is een onderhoudstaak?
U kunt agentgroepen configureren om verouderde werkmappen en opslagplaatsen periodiek op te schonen. Dit proces vermindert het risico dat agents onvoldoende schijfruimte hebben. Onderhoudstaken worden geconfigureerd op organisatieniveau in de instellingen van de agentgroep .
Instellingen voor onderhoudstaken configureren:
Meld u aan bij uw organisatie (
https://dev.azure.com/{yourorganization}).Selecteer Azure>.
Selecteer Agentpools.
Meld u aan bij uw projectverzameling (
http://your-server/DefaultCollection).Selecteer Azure DevOps>verzamelingsinstellingen.
Selecteer Agentpools.
Selecteer de gewenste pool en selecteer vervolgens Instellingen om de instellingen voor de onderhoudstaak voor die agentgroep te configureren.
Belangrijk
U moet de machtiging 'Buildwachtrijen beheren' hebben om de onderhoudstaken-instellingen te configureren. Als u de tabbladen Instellingen of Onderhoudsgeschiedenis niet ziet, beschikt u niet over die machtiging, die de rol Beheerder standaard heeft. Zie Beveiliging van agentpools voor meer informatie.
Configureer de gewenste instellingen en selecteer Opslaan.
Selecteer Onderhoudsgeschiedenis om de geschiedenis van de onderhoudstaak voor de huidige agentgroep weer te geven. U kunt logboeken downloaden en bekijken om de opschoonstappen en acties te bekijken die zijn uitgevoerd.
Het onderhoud wordt uitgevoerd per agentgroep, niet per machine. Als u meerdere agentpools op één computer hebt, kan het zijn dat er nog steeds schijfruimteproblemen zijn.
De onderhoudstaak van mijn zelf-hostende agentpool lijkt vastgelopen. Hoe komt dat?
Normaal gesproken loopt een onderhoudstaak vast wanneer deze wacht om te worden uitgevoerd op een agent die zich niet meer in de agentenpool bevindt. Een agent is bijvoorbeeld opzettelijk offline gehaald of er zijn problemen met de communicatie.
Onderhoudstaken die in de wachtrij staan om te worden uitgevoerd, wachten zeven dagen voordat ze worden uitgevoerd. Als ze gedurende die tijd niet worden uitgevoerd, hebben ze automatisch de status Mislukt. U kunt deze tijdslimiet niet wijzigen.
De limiet van zeven dagen verschilt van de timeout-instelling voor onderhoudstaken. Dat laatste bepaalt het maximale aantal minuten dat een agent kan besteden aan onderhoud. De timer begint wanneer de taak start, niet wanneer de taak in de rij wordt geplaatst bij een agent.
Ik probeer een projectagentgroep te maken die gebruikmaakt van een bestaande organisatieagentgroep, maar de besturingselementen zijn niet beschikbaar. Hoe komt dat?
In het dialoogvenster Een projectagentgroep maken kunt u geen bestaande organisatieagentgroep gebruiken als er al naar een andere projectagentgroep wordt verwezen. Elke organisatieagentgroep kan slechts worden verwezen door slechts één projectagentgroep binnen een projectverzameling.
Ik kan geen door Microsoft gehoste pool selecteren en ik kan mijn build niet in de wachtrij plaatsen. Hoe los ik dit probleem op?
Vraag de eigenaar van uw Azure DevOps-organisatie om u toestemming toe te kennen om de pool te gebruiken. Zie Beveiliging van agentpools.
Ik heb meer gehoste buildresources nodig. Wat kan ik doen?
De Azure Pipelines-pool biedt alle Azure DevOps-organisaties met in de cloud gehoste buildagents en gratis buildminuten elke maand. Als u meer door Microsoft gehoste buildresources nodig hebt of als u meer taken parallel moet uitvoeren, kunt u het volgende doen: