Agentpools maken en beheren

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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 pool en wanneer u een pijplijn maakt, geeft u de pool op 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.

In Azure Pipelines zijn pools gericht op de hele organisatie; zodat u de agentmachines kunt delen in projecten.

Notitie

Taken voor agentpools voeren een taak uit op één agent. Zie Implementatiegroepen inrichten als u een taak moet uitvoeren op alle agents, zoals een implementatiegroep voor klassieke release-pijplijnen.

Als u een organisatiebeheerder bent, maakt en beheert u agentgroepen op het tabblad Agentpools in de beheerinstellingen.

1. Meld u aan bij uw organisatie (https://dev.azure.com/{yourorganization}).

2. Kies Azure DevOps, organisatie-instellingen.

   

3. Kies Agentpools.

   

Als u lid bent van een projectteam, maakt en beheert u agentgroepen op het tabblad Agentpools in projectinstellingen.

Navigeer naar uw project en kies Projectinstellingen, Agentpools.

Standaardagentpools

De volgende agentpools worden standaard geleverd:

• Standaardgroep: gebruik deze om zelf-hostende agents te registreren die u hebt ingesteld.

• Azure Pipelines gehoste pool met verschillende Windows-, Linux- en macOS-installatiekopieën. Zie door Microsoft gehoste agents voor een volledige lijst met de beschikbare installatiekopieën en hun geïnstalleerde software.

  Notitie

  De gehoste Azure Pipelines-pool vervangt de vorige gehoste pools met namen die zijn toegewezen aan de bijbehorende installatiekopieën. Alle taken die u in de vorige gehoste pools had, worden automatisch omgeleid naar de juiste installatiekopie in de nieuwe gehoste Azure Pipelines-pool. In sommige gevallen ziet u mogelijk nog steeds de oude poolnamen, maar achter de schermen worden de gehoste taken uitgevoerd met behulp van de Azure Pipelines-pool. Zie de releaseopmerkingen voor één gehoste pool van 1 juli 2019 - Sprint 154 voor meer informatie.

Standaard zijn alle inzenders in een project leden van de gebruikersrol voor gehoste pools. Hierdoor kan elke inzender in een project pijplijnen maken en uitvoeren met behulp van door Microsoft gehoste agents.

Een pool in uw pijplijn aanwijzen

YAML

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.

Klassiek

Als u een pool en agent in de klassieke editor wilt kiezen, gaat u naar de pijplijninstellingen, selecteert u de gewenste agentgroep en vervolgens de gewenste afbeelding in de vervolgkeuzelijst Agentspecificatie . De standaardagentspecificatie is windows-2019. Zie de bijbehorende vermelding in de kolom Klassieke editorgroep uit deze tabel voor meer informatie over de software die is geïnstalleerd op de door Microsoft gehoste installatiekopieën.

Pools en wachtrijen beheren

Browser

Als u een organisatiebeheerder bent, maakt en beheert u agentgroepen op het tabblad Agentpools in de beheerinstellingen.

1. Meld u aan bij uw organisatie (https://dev.azure.com/{yourorganization}).

2. Kies Azure DevOps, organisatie-instellingen.

   

3. Kies Agentpools.

   

Als u lid bent van een projectteam, maakt en beheert u agentgroepen op het tabblad Agentpools in projectinstellingen.

Navigeer naar uw project en kies Projectinstellingen, Agentpools.

Azure DevOps CLI

Agentpools Lijst agentpoolgegevens | Agentwachtrijen lijst met agentwachtrijen | weergeven agentwachtrijen |

Notitie

Op dit moment kunt u informatie bekijken over agentpools en wachtrijen, maar deze niet bewerken met behulp van de Azure CLI.

Als dit de eerste keer az devops pipelines is dat u opdrachten gebruikt, raadpleegt u Aan de slag met Azure DevOps CLI.

Agentpools weergeven

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

Parameters

• actie: Filter de lijst met toegestane gebruikersactie. Geaccepteerde waarden: beheren, geen, gebruik
• detecteren: organisatie automatisch detecteren. Geaccepteerde waarden: onwaar, waar
• organisatie of organisatie: URL van Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.
• poolnaam: Filter de lijst met overeenkomende poolnaam.
• pooltype: Filter de lijst met het type pool. Geaccepteerde waarden: automatisering, implementatie

Opmerking

In het volgende voorbeeld worden alle pools in tabelindeling weergegeven. In dit voorbeeld wordt de volgende standaardconfiguratie gebruikt: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool list --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

Details van agentpool weergeven

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

Parameters

• id of pool-id: (vereist) id van de pool om de details weer te geven.
• actie: Filter de lijst met toegestane gebruikersactie. Geaccepteerde waarden: beheren, geen, gebruik
• detecteren: organisatie automatisch detecteren. Geaccepteerde waarden: onwaar, waar
• organisatie of organisatie: URL van Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.

Opmerking

In het volgende voorbeeld worden pooldetails weergegeven voor de gehoste Windows 2019-pool met VS2019. In dit voorbeeld wordt de volgende standaardconfiguratie gebruikt: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

U kunt ook --output table dezelfde informatie als de list opdracht retourneren.

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

Agentwachtrijen vermelden

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

Parameters

• actie: Filter de lijst met toegestane gebruikersactie. Geaccepteerde waarden: beheren, geen, gebruik
• detecteren: organisatie automatisch detecteren. Geaccepteerde waarden: onwaar, waar
• organisatie of organisatie: URL van Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.
• project of p: naam of id van het project. U kunt het standaardproject configureren met behulp van az devops configure -d project=NAME_OR_ID. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie.
• wachtrijnaam: filter de lijst met overeenkomende regex-wachtrijnaam, bijvoorbeeld ubuntu voor wachtrij met de naam 'Hosted Ubuntu 1604'.

Opmerking

In het volgende voorbeeld ziet u alle wachtrijen in tabelindeling. In dit voorbeeld wordt de volgende standaardconfiguratie gebruikt: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue list --output table
This command group is in preview. It may be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

Details van agentwachtrij weergeven

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

Parameters

• id of wachtrij-id: id van de agentwachtrij voor informatie over.
• actie: Filter de lijst met toegestane gebruikersactie. Geaccepteerde waarden: beheren, geen, gebruik
• detecteren: organisatie automatisch detecteren. Geaccepteerde waarden: onwaar, waar
• organisatie of organisatie: URL van Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.
• project of p: naam of id van het project. U kunt het standaardproject configureren met behulp van az devops configure -d project=NAME_OR_ID. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie.

Opmerking

In het volgende voorbeeld worden wachtrijdetails weergegeven voor de gehoste Windows 2019-wachtrij met VS2019. In dit voorbeeld wordt de volgende standaardconfiguratie gebruikt: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

Pools worden gebruikt om taken uit te voeren. Meer informatie over het opgeven van pools voor taken.

Als u veel zelf-hostende agents hebt die zijn bedoeld voor verschillende teams of doeleinden, kunt u extra pools maken, zoals hieronder wordt uitgelegd.

Agentpools maken

Hier volgen enkele typische situaties waarin u mogelijk zelf-hostende agentgroepen wilt maken:

• U bent lid van een project en u wilt een set machines gebruiken die eigendom zijn van uw team voor het uitvoeren van build- en implementatietaken. Zorg er eerst voor dat u over de machtigingen beschikt om pools in uw project te maken door Beveiliging te selecteren op de pagina agentgroepen in uw Project-instellingen. U moet de rol van Beheer istrator hebben om nieuwe pools te kunnen maken. Selecteer vervolgens Pool toevoegen en selecteer de optie om een nieuwe pool te maken. Installeer en configureer tot slot agents die deel uitmaken van die agentgroep.

• U bent lid van het infrastructuurteam en wilt een groep agents instellen voor gebruik in alle projecten. Zorg er eerst voor dat u over de machtigingen beschikt om pools in uw project te maken door Beveiliging te selecteren op de pagina agentgroepen in de instellingen van uw organisatie. Maak vervolgens een nieuwe agentgroep en selecteer de optie om deze agentgroep automatisch in te richten in alle projecten tijdens het maken van de pool. Deze instelling zorgt ervoor dat alle projecten toegang hebben tot deze agentgroep. Installeer en configureer tot slot agents die deel uitmaken van die agentgroep.

• U wilt een set agentmachines delen met meerdere projecten, maar niet allemaal. Navigeer eerst naar de instellingen voor een van de projecten, voeg een agentgroep toe en selecteer de optie om een nieuwe pool te maken op organisatieniveau. Ga vervolgens naar elk van de andere projecten en maak een pool in elk van deze projecten terwijl u de optie selecteert om een bestaande agentgroep uit de organisatie te gebruiken. Installeer en configureer tot slot agents die deel uitmaken van de gedeelde agentgroep.

Beveiliging van agentenpools

Informatie over de werking van beveiliging voor agentgroepen helpt u bij het beheren van delen en het gebruik van agents.

Rollen worden gedefinieerd voor elke agentgroep en het lidmaatschap van deze rollen bepaalt welke bewerkingen u kunt uitvoeren op een agentgroep.

Beveiligingsinstellingen op organisatieniveau

Rol in een agentgroep in organisatie-instellingen	Doel
Lezer	Leden van deze rol kunnen de agentgroep en agents bekijken. U gebruikt dit meestal om operators toe te voegen die verantwoordelijk zijn voor het bewaken van de agents en hun status.
Serviceaccount	Leden van deze rol kunnen de organisatieagentgroep gebruiken om een projectagentgroep in een project te maken. Als u de bovenstaande richtlijnen voor het maken van nieuwe projectagentgroepen volgt, 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 bij het maken van een projectagentgroep in een project. Ten slotte kunnen ze ook lidmaatschap beheren voor alle rollen van de organisatieagentgroep. De gebruiker die de organisatieagentgroep heeft gemaakt, wordt automatisch toegevoegd aan de rol Beheer istrator voor die pool.

Het knooppunt Alle agentgroepen op het tabblad Agentgroepen wordt gebruikt om de beveiliging van alle organisatieagentgroepen te beheren. Rollidmaatschappen voor afzonderlijke organisatieagentgroepen worden automatisch overgenomen van die van het knooppunt Alle agentgroepen. TFS- en Azure DevOps Server-beheerders zijn standaard ook beheerders van het knooppunt Alle agentpools bij gebruik van TFS of Azure DevOps Server.

Beveiligingsinstellingen op projectniveau

Rollen worden ook gedefinieerd voor elke projectagentgroep en lidmaatschappen in deze rollen bepalen welke bewerkingen u op projectniveau kunt uitvoeren op een agentgroep.

Rol in een agentgroep in projectinstellingen	Doel
Lezer	Leden van deze rol kunnen de groep met projectagenten bekijken. Doorgaans gebruikt u dit om operators toe te voegen die verantwoordelijk zijn voor het bewaken van de build- en implementatietaken in die projectagentpool.
User	Leden van deze rol kunnen de pool van de projectagent gebruiken bij het ontwerpen van pijplijnen.
Beheerder	Naast alle bovenstaande bewerkingen kunnen leden van deze rol lidmaatschap beheren voor alle rollen van de projectagentgroep. De gebruiker die de pool heeft gemaakt, wordt automatisch toegevoegd aan de rol Beheer istrator voor die pool.

Pijplijnmachtigingen

Met pijplijnmachtigingen bepaalt u welke YAML-pijplijnen zijn gemachtigd om een agentgroep te gebruiken. Pijplijnmachtigingen beperken de toegang van klassieke pijplijnen niet.

U kunt uit de volgende opties kiezen:

• Open toegang voor alle pijplijnen om de agentgroep te gebruiken 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 moet worden goedgekeurd door een agentgroep Beheer istrator. Hiermee wordt de toegang van klassieke pijplijnen niet beperkt.

Pijplijnmachtigingen voor de Azure Pipelines-agentpool kunnen niet worden geconfigureerd, omdat de pool standaard toegankelijk is voor alle pijplijnen.

De beveiligingsactie op het tabblad Agentgroepen wordt gebruikt om de beveiliging van alle projectagentgroepen in een project te beheren. Rollidmaatschappen voor afzonderlijke projectagentgroepen worden automatisch overgenomen van wat u hier definieert. Standaard worden de volgende groepen toegevoegd aan de Beheer istratorrol 'Alle agentgroepen': Build Beheer istrators, Release Beheer istrators, Project Beheer istrators.

Veelgestelde vragen

Als ik geen onderhoudsvenster plant, worden er onderhoud uitgevoerd door de agents?

Als er geen venster is gepland, worden de onderhoudstaken niet uitgevoerd door de agents in die pool.

Wat is een onderhoudstaak?

U kunt agentgroepen configureren om verouderde werkmappen en opslagplaatsen periodiek op te schonen. Dit vermindert het risico dat de agents onvoldoende schijfruimte hebben. Onderhoudstaken worden geconfigureerd op organisatieniveau in instellingen voor agentpools.

Ga als volgende te werk om de instellingen voor onderhoudstaken te configureren:

1. Meld u aan bij uw organisatie (https://dev.azure.com/{yourorganization}).

2. Kies Azure DevOps, organisatie-instellingen.

   

3. Kies Agentpools.

   

Kies de gewenste pool en kies Instellingen om de instellingen voor de onderhoudstaak voor die agentgroep te configureren.

Belangrijk

U moet de machtiging Buildwachtrijen beheren hebben om de instellingen voor onderhoudstaken te configureren. Als u het tabblad Instellingen of het tabblad Onderhoudsgeschiedenis niet ziet, hebt u die machtiging niet. Deze machtiging wordt standaard verleend aan de Beheer istrator-rol. Zie Beveiliging van agentpools voor meer informatie.

Configureer de gewenste instellingen en kies 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; Dus als u meerdere agentpools op één computer hebt, kan het zijn dat u nog steeds schijfruimteproblemen ondervindt.

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 agentpool bevindt. Dit gebeurt bijvoorbeeld wanneer de agent opzettelijk offline is gehaald of wanneer er problemen zijn met de communicatie ermee.

Onderhoudstaken die in de wachtrij zijn geplaatst om te worden uitgevoerd, wachten zeven dagen om te worden uitgevoerd. Daarna worden ze automatisch ingesteld op de status Mislukt als ze niet worden uitgevoerd. Deze tijdslimiet kan niet worden gewijzigd.

De limiet van zeven dagen verschilt van de instelling time-outinstelling voor onderhoudstaken. Dat laatste bepaalt het maximale aantal minuten dat een agent kan besteden aan onderhoud. De timer wordt gestart wanneer de taak wordt gestart, niet wanneer de taak in de wachtrij wordt geplaatst op een agent.

Ik probeer een projectagentgroep te maken die gebruikmaakt van een bestaande organisatieagentgroep, maar de besturingselementen worden grijs weergegeven. Waarom?

In het dialoogvenster Een projectagentgroep maken kunt u geen bestaande organisatieagentgroep gebruiken als er al naar wordt verwezen door een andere projectagentgroep. Elke organisatieagentgroep kan worden verwezen door slechts één projectagentgroep binnen een bepaalde projectverzameling.

Ik kan geen door Microsoft gehoste pool selecteren en ik kan mijn build niet in de wachtrij plaatsen. Hoe kan ik dit oplossen?

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?

A: 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 wilt uitvoeren, kunt u het volgende doen:

• Uw eigen agents hosten op infrastructuur die u beheert
• Aanvullende parallelle taken kopen