Skapa och hantera agent-pooler

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

En agentpool är en samling agenter. I stället för att hantera varje agent individuellt organiserar du agenter i agentpooler. När du konfigurerar en agent registreras den med en enda pool. När du skapar en pipeline anger du den pool där pipelinen körs. När du kör pipelinen körs den på en agent från poolen som uppfyller pipelinens krav .

Hanterade DevOps-pooler hanteras i Azure-portalen. Om du använder hanterade DevOps-pooler, se en snabbstart för att skapa en pool.

I Azure Pipelines är pooler begränsade till hela organisationen, så du kan dela agentdatorer mellan projekt.

Jobb från agentpoolen körs på en enda agent. Om du behöver köra ett jobb på alla agenter, till exempel en distributionsgrupp för klassiska versionspipelines, kan du läsa Etablera distributionsgrupper.

Om du är organisationsadministratör skapar och hanterar du agentpooler från fliken Agentpooler i administratörsinställningarna.

1. Logga in på organisationen (https://dev.azure.com/{yourorganization}).

2. VäljInställningar för>.

   

3. Välj Agentpooler.

   

Om du är medlem i projektteamet skapar och hanterar du agentpooler från fliken Agentpooler i projektinställningarna.

Gå till projektet och välj Projektinställningar>Agentpooler.

Förinställda agentpooler

Följande agentpooler tillhandahålls som standard:

• Standardpool: Använd den för att registrera lokalt installerade agenter som du har konfigurerat.

• Azure Pipelines: Den här värdbaserade poolen levereras med olika Windows-, Linux- och macOS-avbildningar. En fullständig lista över de tillgängliga avbildningarna och deras installerade programvara finns i Microsoft-hostade agenter.

Som standard är alla deltagare i ett projekt medlemmar i användarrollen i värdbaserade pooler. Med denna status kan varje bidragsgivare i ett projekt skapa och köra pipelines med agenter som tillhandahålls av Microsoft.

Ange en pool i er pipeline

YAML

För att välja en Microsoft-värdad agent från Azure Pipelines-poolen i pipelinan för YAML-Azure DevOps Services, ange namnet på avbildningen med hjälp av YAML VM Image Label från den här tabellen.

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

Så här använder du en privat pool utan krav:

pool: MyPool

Mer information finns i YAML-schemat för pooler.

Klassisk

Om du vill välja en pool och agent i den klassiska redigeraren går du till pipelineinställningarna. Välj önskat värde för agentpoolen och önskad bild i listrutan Agentspecifikation . Standardvalet agentspecifikation är windows-2019. Mer information om programvaran som är installerad på Microsoft-värdbaserade avbildningar finns i motsvarande post i kolumnen Klassisk redigeringspool från den här tabellen.

Hantera pooler och köer

Användargränssnitt för Azure Pipelines

Organisationsadministratörer skapar och hanterar agentpooler från fliken Agentpooler i administratörsinställningarna.

1. Logga in på organisationen (https://dev.azure.com/{yourorganization}).

2. VäljInställningar för>.

   

3. Välj Agentpooler.

   

Projektteamets medlemmar skapar och hanterar agentpooler från fliken Agentpooler i projektinställningarna.

Gå till projektet och välj Projektinställningar>Agentpooler.

Om du vill ta bort en pool går du till listan Agentpooler och väljer sedan Fler alternativ>Ta bort.

Azure DevOps CLI

Lista agentpooler | Visa agentpoolsinformation | Lista agentköer | Visa agentköinformation

Anteckning

Användare kan visa information om agentpooler och köer, men inte redigera dem, med hjälp av Azure CLI.

Om det här är första gången du använder az devops pipelines kommandon kan du läsa Kom igång med Azure DevOps CLI.

Lista över agentpooler

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

Parametrar

• action: Filtrera listan med användaråtgärden tillåten. Godkända värden är manage, noneoch use.
• detect: Identifiera organisationen automatiskt. Godkända värden är false och true.
• org eller organization: Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen genom att använda az devops configure -d organization=ORG_URL. Den här processen krävs om den inte är konfigurerad som standard eller hämtas via Git-konfiguration. Till exempel: https://dev.azure.com/MyOrganizationName/.
• pool-name: Filtrera listan med ett matchande poolnamn.
• pool-type: Filtrera listan med typen av pool. Godkända värden är automation och deployment.

Exempel

I följande exempel visas alla pooler i tabellformat. I det här exemplet används följande standardkonfiguration: 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

Visa agentpooldetaljer

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

Parametrar

• id eller pool-id: (Obligatoriskt) ID för poolen för att visa information.
• action: Filtrera listan med användaråtgärden tillåten. Godkända värden är manage, noneoch use.
• detect: Identifiera organisationen automatiskt. Godkända värden är false och true.
• org eller organization: Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen genom att använda az devops configure -d organization=ORG_URL. Den här processen krävs om den inte är konfigurerad som standard eller hämtas via Git-konfiguration. Till exempel: https://dev.azure.com/MyOrganizationName/.

Exempel

I följande exempel visas poolinformation för Hosted Windows 2019 med VS2019 pool. I det här exemplet används följande standardkonfiguration: 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
}

Du kan också använda --output table, som returnerar samma information som list kommandot.

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

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

Lista agentköer

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

Parametrar

• action: Filtrera listan med användaråtgärden tillåten. Godkända värden är manage, noneoch use.
• detect: Identifiera organisationen automatiskt. Godkända värden är false och true.
• org eller organization: Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med hjälp av az devops configure -d organization=ORG_URL. Den här processen krävs om den inte är konfigurerad som standard eller hämtas via Git-konfiguration. Till exempel: https://dev.azure.com/MyOrganizationName/.
• project eller p: Projektets namn eller ID. Du kan konfigurera standardprojektet med hjälp av az devops configure -d project=NAME_OR_ID. Den här processen krävs om den inte är konfigurerad som standard eller hämtas via Git-konfiguration.
• queue-name: Filtrera listan med ett matchande könamn regex (till exempel ubuntu för en kö med namnet Hosted Ubuntu 1604).

Exempel

I följande exempel visas alla köer i tabellformat. I det här exemplet används följande standardkonfiguration: 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 might 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

Visa information om agentkö

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

Parametrar

• id eller queue-id: ID för agentkön att hämta information om.
• action: Filtrera listan med användaråtgärden tillåten. Godkända värden är manage, noneoch use.
• detect: Identifiera organisationen automatiskt. Godkända värden är false och true.
• org eller organization: Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med hjälp av az devops configure -d organization=ORG_URL. Den här processen krävs om den inte är konfigurerad som standard eller hämtas via Git-konfiguration. Till exempel: https://dev.azure.com/MyOrganizationName/.
• project eller p: Projektets namn eller ID. Du kan konfigurera standardprojektet med hjälp av az devops configure -d project=NAME_OR_ID. Den här processen krävs om den inte är konfigurerad som standard eller hämtas via Git-konfiguration.

Exempel

I följande exempel visas köinformation för hostade Windows 2019-kön med VS2019. Den använder följande standardkonfiguration: 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"
}

Pooler används för att köra uppgifter. Lär dig mer om att ange pooler för jobb.

Om du har många lokalt installerade agenter som är avsedda för olika team eller syften kanske du vill skapa fler pooler. Använd följande instruktioner.

Skapa agentpooler

Här följer några vanliga situationer när du kanske vill skapa agentpooler med egen värd.

Du är medlem i ett projekt och vill använda en uppsättning datorer som ditt team äger för att köra bygg- och distributionsjobb:

1. Kontrollera att du har behörighet att skapa pooler i projektet. I Projektinställningar går du till fönstret Agentpooler och väljer Säkerhet. Om du vill skapa nya pooler måste du ha rollen Administratör .
2. Välj Lägg till pool och välj sedan alternativet för att skapa en ny pool.
3. Installera och konfigurera agenter som en del av den nya agentpoolen.

Du är medlem i infrastrukturteamet och vill konfigurera en pool med agenter som ska användas i alla projekt:

1. Kontrollera att du har behörighet att skapa pooler i projektet. I Organisationsinställningar går du till fönstret Agentpooler och väljer Säkerhet.
2. Skapa en ny agentpool och välj alternativet Etablera agentpoolen automatiskt i alla projekt när du skapar poolen. Den här inställningen säkerställer att alla projekt har åtkomst till den här agentpoolen.
3. Installera och konfigurera agenter som en del av den nya agentpoolen.

Du vill dela en uppsättning agentdatorer med vissa, men inte alla, av dina projekt:

1. Gå till Inställningar för ett av projekten. Lägg till en agentpool och välj alternativet för att skapa en ny pool på organisationsnivå.
2. Gå till de andra projekten och skapa en pool i var och en av dem. Välj Använd en befintlig agentpool från organisationen.
3. Installera och konfigurera agenter som en del av den delade agentpoolen.

Säkerhet för agentpooler

När du förstår hur säkerhet fungerar för agentpooler kan du bättre styra delning och användning av agenter.

Roller definieras i varje agentpool. Medlemskap i dessa roller styr vilka åtgärder du kan utföra på en agentpool.

Säkerhetsinställningar på organisationsnivå

Roll i en agentpool i Organisationsinställningar	Syfte
Reader	Medlemmar i den här rollen kan visa agentpoolen och agenterna. Du använder vanligtvis den här rollen för att lägga till operatorer som ansvarar för att övervaka agenterna och deras hälsa.
Servicekonto	Medlemmar i den här rollen kan använda organisationsagentpoolen för att skapa en projektagentpool i ett projekt. Om du följer de tidigare riktlinjerna för att skapa nya projektagentpooler behöver du vanligtvis inte lägga till några medlemmar här.
Administratör	Förutom alla ovanstående behörigheter kan medlemmar i den här rollen registrera eller avregistrera agenter från organisationens agentpool. De kan också referera till organisationsagentpoolen när de skapar en projektagentpool i ett projekt. De kan också hantera medlemskap för alla roller i organisationens agentpool. En användare som skapar en organisationsagentpool tilldelas automatiskt rollen Administratör för poolen.

Noden Alla agentpooler på fliken Agentpooler styr säkerheten för alla organisationsagentpooler. Rollmedlemskap för enskilda organisationsagentpooler ärvs automatiskt från noden Alla agentpooler . Som standard är Azure DevOps Server-administratörer även administratörer för noden Alla agentpooler när de använder Azure DevOps Server.

Säkerhetsinställningar på projektnivå

Roller definieras också för varje projektagentpool. Medlemskap i dessa roller styr vilka åtgärder du kan utföra på en agentpool på projektnivå.

Roll i en agentpool i Projektinställningar	Syfte
Reader	Medlemmar i den här rollen kan visa projektagentpoolen. Du använder vanligtvis den här rollen för att lägga till operatorer som övervakar bygg- och distributionsjobben i den projektagentpoolen.
User	Medlemmar i den här rollen kan använda projektagentpoolen när de skapar pipelines.
Administratör	Förutom alla ovanstående åtgärder kan medlemmar i den här rollen hantera medlemskap för alla roller i projektagentpoolen. En användare som skapar en organisationsagentpool tilldelas automatiskt rollen Administratör för poolen.

Pipelinebehörigheter

Pipelinebehörigheter styr vilka YAML-pipelines som har behörighet att använda en agentpool. Pipelinebehörigheter begränsar inte åtkomsten från de klassiska pipelines.

Välj någon av följande processer:

• Öppna åtkomsten för alla pipelines för att använda agentpoolen från de fler alternativen i det övre högra hörnet i avsnittet Pipelinebehörigheter på fliken Säkerhet i en agentpool.
• Lås agentpoolen och tillåt endast valda YAML-pipelines att använda den. Om någon annan YAML-pipeline refererar till agentpoolen genereras en auktoriseringsbegäran som en agentpooladministratör måste godkänna. Den här processen begränsar inte åtkomsten från klassiska pipelines.

Det går inte att konfigurera pipelinebehörigheter för Azure Pipelines-agentpoolen eftersom poolen är tillgänglig för alla pipelines som standard.

Säkerhetsåtgärden på fliken Agentpooler styr säkerheten för alla projektagentpooler i ett projekt. Rollmedlemskap för enskilda projektagentpooler ärvs automatiskt från det du definierar här. Som standard läggs följande grupper till i administratörsrollenAlla agentpooler: Byggadministratörer, Versionsadministratörer och Projektadministratörer.

Vanliga frågor

Om jag inte schemalägger en underhållsperiod, när utför agenterna då underhåll?

Om du inte schemalägger en tidsperiod kör agenterna i den poolen inte underhållsjobbet.

Vad är ett underhållsjobb?

Du kan konfigurera agentpooler för att regelbundet rensa inaktuella arbetskataloger och lagringsplatser. Den här processen minskar risken för att agenter får slut på diskutrymme. Underhållsjobb konfigureras på organisationsnivå i inställningarna för agentpoolen .

Konfigurera inställningar för underhållsjobb:

1. Logga in på organisationen (https://dev.azure.com/{yourorganization}).

2. VäljInställningar för>.

   

3. Välj Agentpooler.

   

Välj önskad pool och välj sedan Inställningar för att konfigurera inställningar för underhållsjobb för agentpoolen.

Viktigt!

Du måste ha behörigheten Hantera byggköer för att konfigurera inställningar för underhållsjobb. Om du inte ser flikarna Inställningar eller Underhållshistorik har du inte den behörigheten, som administratörsrollen har som standard. Mer information finns i Säkerhet för agentpooler.

Konfigurera önskade inställningar och välj sedan Spara.

Välj Underhållshistorik för att se historiken för underhållsjobbet för den aktuella agentpoolen. Du kan ladda ned och granska loggar för att se de rensningssteg och åtgärder som vidtagits.

Underhållet utförs per agentpool, inte per dator. Om du har flera agentpooler på en enda dator kan du fortfarande stöta på diskutrymmesproblem.

Underhållsjobbet för min lokalt installerade agentpool verkar ha fastnat. Varför?

Ett underhållsjobb fastnar vanligtvis när det väntar på att köras på en agent som inte längre finns i agentpoolen. Till exempel togs en agent målmedvetet offline, eller så finns det problem med att kommunicera med den.

Underhållsjobb som står i kö för att köras väntar sju dagar på att köras. Om de inte körs under den tiden är de automatiskt i ett misslyckat tillstånd. Du kan inte ändra den här tidsgränsen.

Sjudagarsgränsen skiljer sig från tidsgränsinställningen för underhållsjobb. Den senare styr det maximala antalet minuter som en agent kan ägna åt underhåll. Timern startar när arbetet börjar, inte när det placeras i kö hos en agent.

Jag försöker skapa en projektagentpool som använder en befintlig organisationsagentpool, men kontrollerna är inte tillgängliga. Varför?

I dialogrutan Skapa en projektagentpool kan du inte använda en befintlig organisationsagentpool om en annan projektagentpool redan refererar till den. Varje organisationsagentpool kan bara refereras till av en projektagentpool i en projektsamling.

Jag kan inte välja en Microsoft-värdbaserad pool och jag kan inte ställa min version i kö. Hur löser jag det här problemet?

Be Azure DevOps-organisationens ägare att ge dig behörighet att använda poolen. Se Säkerhet för agentpooler.

Jag behöver fler värdbaserade byggresurser. Vad ska jag göra?

Azure Pipelines-poolen ger alla Azure DevOps-organisationer molnbaserade byggagenter och kostnadsfria byggminuter varje månad. Om du behöver fler Microsoft-värdbaserade byggresurser, eller om du behöver köra fler jobb parallellt, kan du antingen:

• Hosta dina egna agenter på din egna hanterade infrastruktur
• Köp fler parallella jobb