Konfigurera skalning

Du kan hantera prestanda och kostnader för instansen av hanterade DevOps-pooler genom att konfigurera skalningsinställningar. Information om priser och prestanda finns i Hantera kostnader och prestanda.

Agenttillstånd

Du kan konfigurera pooler som:

• Tillståndslös: Tillhandahåll en ny agent för varje jobb.
• Stateful: Tillåt delning av agenter mellan flera jobb.

Standardinställningen för en pool är stateless, vilket du kan uppnå genom att använda inställningen Varje gång ny agent. I vissa fall kanske teamen vill återanvända agenter för att återanvända paketen eller filerna som skapades under den föregående pipelinekörningen. Skapa arbetsbelastning är ett vanligt scenario där team vill bevara tillstånds- och återanvändningsagenter. Du kan uppnå tillståndskänsliga pooler via Hanterade DevOps-pooler samtidigt som du balanserar dem med bästa praxis för säkerhet. En agent kan återanvändas i högst sju dagar som standard, men du kan konfigurera den så att den återanvänds tidigare.

Kommentar

Säkerhetsagenter rekommenderar att användare använder tillståndslösa pooler som skydd mot leveranskedjeattacker. Använd agenttillståndsinställningen Fresh agent varje gång.

Tillståndslösa pooler

När du konfigurerar en tillståndslös agent skaffas en ny agent för varje jobb. Agenten tas bort när jobbet har slutförts.

Mer information om livscykeln för tillståndslösa agenter och hur de används i Azure Pipelines finns i avsnittet Livscykel för agenter och potentiella fördröjningar i allokering .

Azure-portalen

Skärmbild som visar en tillståndslös agent.

ARM-mall

Du kan konfigurera agenter med hjälp agentProfile av egenskapen i resursen Hanterade DevOps-pooler. I följande exempel anges en Stateless agent.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "agentProfile": {
                    "kind": "Stateless"
                }
            }
        }
    ]
}

Azure CLI

Du kan konfigurera agenter med hjälp av parametern agent-profile när du skapar eller uppdaterar en pool.

I följande exempel anges en Stateless agent utan standby-agenter.

az mdp pool create \
   --agent-profile agent-profile.json
   # other parameters omitted for space

I följande exempel visas innehållet i filen agent-profile.json .

{
    "Stateless": {}
}

Biceps

Du kan konfigurera agenter med hjälp agentProfile av egenskapen i resursen Hanterade DevOps-pooler. I följande exempel anges en Stateless agent.

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    agentProfile: {
      kind: 'Stateless'
    }
  }
}

När du anger Agenttillstånd till Fresh agent varje gång, anskaffas en ny agent för varje jobb. Agenten tas bort när jobbet har slutförts.

Tillståndskänsliga pooler

Azure-portalen

ARM-mall

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "agentProfile": {
                    "maxAgentLifetime": "7.00:00:00",
                    "gracePeriodTimeSpan": "00:30:00",
                    "kind": "Stateful"
                }
            }
        }
    ]
}

Azure CLI

Du kan konfigurera agenter med hjälp av parametern agent-profile när du skapar eller uppdaterar en pool.

I följande exempel anges en Stateful agent med en maximal livslängd på sju dagar och en respitperiod på trettio minuter.

az mdp pool create \
   --agent-profile agent-profile.json
   # other parameters omitted for space

I följande exempel visas innehållet i agent-profile.json filen.

{
    "Stateful":
    {
        "maxAgentLifetime": "7.00:00:00",
        "gracePeriodTimeSpan": "00:30:00"
    }
}

Biceps

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    agentProfile: {
      kind: 'Stateful'
      maxAgentLifetime: '7.00:00:00'
      gracePeriodTimeSpan:'00:30:00'
    }
  }
}

När du aktiverar Samma agent kan användas av flera versioner ( "kind": "stateful" inställningen i resursmallar eller { "stateful": {...} } inställningen i Azure CLI) är agenterna i poolen tillståndskänsliga. Du kan konfigurera tillståndskänsliga pooler med hjälp av följande inställningar:

• Maximal livstid för standby-agenter (maxAgentLifetime) konfigurerar den maximala varaktighet som en agent i en tillståndskänslig pool kan köra innan den stängs av och kasseras. Formatet för Max time to live för standby-agenter är dd.hh:mm:ss. Standardvärdet för Max time to live för väntelägesagenter är inställt på den maximala tillåtna varaktigheten på sju dagar (7.00:00:00).

• Grace Period (gracePeriodTimeSpan) konfigurerar hur länge en agent i en tillståndskänslig pool väntar på nya jobb innan den stängs av efter att alla aktuella och köade jobb har slutförts. Formatet för respitperiod är dd.hh:mm:ss och standardvärdet är ingen respitperiod.

  Viktigt!

  Om ett jobb körs när intervallet för maximal livslängd för standby-agenter upphör, stängs inte agenten av förrän jobbet slutförts, såvida inte jobbet tar mer än två dagar att genomföra. Enskilda jobb i Hanterade DevOps-pooler kan köras i högst två dagar, även om de körs på en standby-agent med mer än två dagar konfigurerade för Max tid att leva för standby-agenter. Kontakta supporten om arbetsflödet kräver att du kör ett enda jobb som tar mer än två dagar att slutföra.

Agenter i tillståndslösa pooler stängs av och kasseras efter varje jobb. Agenter i tillståndskänsliga pooler fortsätter att köras om något av följande villkor uppfylls:

• Om ett annat jobb placeras i kö när det första jobbet är klart skickar Managed DevOps Pools det köade jobbet till agenten som körde det första jobbet i stället för att stänga av det.
• Om det finns en respitperiod som konfigurerats för poolen väntar agenterna på nya jobb under den tid som anges av respitperioden innan de stängs av.
• Om standby-agenter är aktiverade och agentbilden uppfyller kriterierna för den aktiva etableringsperioden fortsätter agenten att köra och vänta på jobb.

Agenter som körs i tillståndsbevarande pooler stängs av och kasseras om de körs kontinuerligt under den tid som anges av Maximal livstid för standby-agenter, även om de tidigare villkoren är uppfyllda. Om maximal tid att leva för reservagenter till exempel har konfigurerats till tre dagar och reservagentläge är inställt på Manuellt, alla veckoschema (maskiner tillgängliga 24/7), startar agenterna om efter tre kontinuerliga dagar av drifttid.

Viktigt!

Agenter i tillståndskänsliga pooler kan fortfarande stängas av och kasseras när ett jobb har slutförts om det inte finns någon respitperiod, ingen aktiv etableringsperiod för standby-agenter och inga köade jobb som matchar agenten. När en agent kasseras går alla tillstånd förlorade.

Grace-perioder möjliggör det mest ekonomiska sättet att driva stateful pooler för pipelines med jämn belastning. Respitperioder kräver inte användning av standby-agentläge för att hålla agenter online och redo att acceptera jobb.

Standby-agentläge

När du skapar en pool är standby-agentläget inaktiverat som standard. När standbyagentläget är inaktiverat finns det inga standbyagenter att omedelbart tilldela till dina pipelines. Era pipelines kan behöva vänta från några minuter till 15 minuter för att en agent ska etableras på begäran. För bättre prestanda aktiverar du standby-agentläge och konfigurerar ett väntelägesagentschema som ger kapacitet för din arbetsbelastning.

När du konfigurerar ett väntelägesagentschema jämför Hanterade DevOps-pooler regelbundet antalet etablerade agenter med antalet standby-agenter som du anger i det aktuella etableringsschemat. Den startar nya agenter efter behov för att behålla antalet standby-agenter. Du kan visa aktuell status och antal agenter i poolen med hjälp av fönstret Agenter .

Viktigt!

Etableringsantalet i ett schema får inte vara större än värdet Maximalt antal agenter som du konfigurerar i Poolinställningar.

Du kan konfigurera standby-agentläge med hjälp av följande inställningar:

• Av: Vilolägesagent är inaktiverat och agenter tilldelas på begäran när jobb placeras i kö.
• Manuell: Konfigurera ett manuellt väntelägesschema.
• Automatisk: Använd ett automatiskt väntelägesschema baserat på agentanvändningshistorik. Du kan konfigurera den för kostnad och prestanda.

Azure-portalen

ARM-mall

Du kan konfigurera väntelägesagenter genom att använda resourcePredictionsProfile-sektionen i den agentProfile-egenskapen. Ange "kind": "Manual" för att konfigurera ett start från början, ett veckodagsschema eller ett schema för hela veckan och ange information om schemat i resourcePredictions avsnittet. Om du vill konfigurera automatiska standby-agenter anger du "kind": "Automatic". Inaktivera standby-agenter genom att utelämna avsnittet ResourcePredictionsProfile . Mer information om hur du konfigurerar varje skalningstyp finns i följande avsnitt.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "agentProfile": {
                    "kind": "Stateless",
                    "resourcePredictionsProfile": {
                        "kind": "Manual"
                    },
                    "resourcePredictions": {...}
                }
            }
        }
    ]
}

Azure CLI

Du kan konfigurera agenter med hjälp av parametern agent-profile när du skapar eller uppdaterar en pool.

Du kan konfigurera väntelägesagenter genom att använda resourcePredictionsProfile-sektionen av agent-profile-parametern. Använd inställningen "Manual": {} för att konfigurera ett schema för start från början, veckodag eller hela veckan och ange information om schemat i resourcePredictions avsnittet. Om du vill konfigurera automatiska väntelägesagenter använder du inställningen "Automatic": {} . Mer information om hur du konfigurerar varje skalningstyp finns i följande avsnitt.

az mdp pool create \
   --agent-profile agent-profile.json
   # other parameters omitted for space

I följande exempel visas innehållet i agent-profile.json filen:

{
    "Stateless": {},
    "resourcePredictionsProfile": {
        "Manual": {}
    },
    "resourcePredictions": {...}
}

Biceps

Du kan konfigurera väntelägesagenter genom sektionen resourcePredictionsProfile av agentProfile-egenskapen. Använd inställningen "kind": "Manual" för att konfigurera ett schema för start från början, veckodag eller hela veckan och ange information om schemat i resourcePredictions avsnittet. Om du vill konfigurera automatiska väntelägesagenter använder du inställningen kind: 'Automatic' . Inaktivera standby-agenter genom att utelämna avsnittet ResourcePredictionsProfile . Mer information om hur du konfigurerar varje skalningstyp finns i följande avsnitt.

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    agentProfile: {
      kind: 'Stateless'
      resourcePredictionsProfile: {
        kind: 'Manual'
      }
      resourcePredictions: {...}
    }
  }
}

Manuell

Manuellt läge passar bäst för team som känner till användningsmönster för kontinuerlig integrering och kontinuerlig leverans (CI/CD). När du använder det manuella alternativet måste du definiera ditt förberedelseschema. Du definierar ditt schema baserat på din förståelse av vilka agenter i poolen som mest sannolikt kommer att användas och hur många agenter som sannolikt kommer att användas. Du anger ett tilldelningsantal agenter som ska uppfylla den beräknade efterfrågan.

Du kan skapa ett eget distributionschema eller välja något av de fördefinierade schemana. Du kan konfigurera tidszonen som ska användas för att ange scheman. Standardvärdet för Pre-provisioning TimeZone är (UTC) Coordinated Universal Time.The default value for Pre-provisioning TimeZone is (UTC) Coordinated Universal Time.

Du kan konfigurera manuella standby-agenter på något av följande tre sätt:

• Börja från början: Konfigurera en uppsättning tilldelningsperioder för standby-agenter.
• Veckodagsschema (datorer som är tillgängliga under en viss tidsperiod varje veckodag): Konfigurera en start- och sluttid för väntelägesagenter som ska vara tillgängliga varje veckodag.
• Schema för hela veckan (datorer som är tillgängliga hela tiden): Konfigurera ett fast antal standby-agenter som ska vara kontinuerligt tillgängliga.

Var och en av snabbstarterna för företablering har följande vanliga inställningar (utöver de inställningar som är specifika för den snabbstarten):

• Tidszon för prekonfigurering: Så att du kan ställa in tidszonen för perioderna i din prekonfigureringsplan. Standardvärdet för Pre-provisioning TimeZone är (UTC) Coordinated Universal Time.The default value for Pre-provisioning TimeZone is (UTC) Coordinated Universal Time.
• Standbyagenters procentandel: Konfigurerar procentandelen Standby-agenter som du vill använda för varje bild. Du kan ange * för att se till att alla bilder etableras på samma sätt, eller så kan du ange ett heltal från 0 till 100 för att representera en procentandel. Om du anger en procentandel måste summan för alla bilder vara lika med 100. Om du har en enda bild anger du * eller 100. När du använder Azure Resource Manager-mallar (ARM-mallar) kan du konfigurera inställningen För standby-agentprocent i images avsnittet. Mer information finns i Konfigurera avbildningar.

Azure-portalen

ARM-mall

Du kan ange manuell etablering av standby-agent i resourcePredictionsProfile-avsnittet av agentProfile. Du kan konfigurera detaljerna i avsnittet resourcePredictions.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "agentProfile": {
                    "kind": "Stateless",
                    "resourcePredictionsProfile": {
                        "kind": "Manual"
                    },
                    "resourcePredictions": {
                        "timeZone": "Eastern Standard Time",
                        "daysData": [
                            {},
                            {
                                "00:00:00": 1,
                                "04:00:00": 0
                            },
                            {},
                            {},
                            {},
                            {},
                            {}
                        ]
                    }
                }
            }
        }
    ]
}

Ange önskad tidszon för schemat med hjälp timeZone av egenskapen . Standardvärdet är UTC. Information om hur du hämtar en lista över tidszonsnamn för den här egenskapen finns i TimeZoneInfo.GetSystemTimeZones-metoden.

Du kan definiera schemat för standby-agenter med hjälp av listan daysData . Listan daysData kan innehålla antingen ett eller sju objekt.

En daysData lista med sju objekt mappar till veckodagarna, från och med söndag. Var och en av dessa sju objekt kan ha noll eller fler "time": count posterningar, vilket anger en tid i 24-timmarsformat och ett antal standby-agenter. Det angivna antalet beredskapsagenter bibehålls fram till nästa "time": count post, vilket kan ske samma dag eller en följande dag.

En daysData lista med ett enda objekt definierar ett schema för hela veckan, där den enskilda posten motsvarar antalet "time": count för hela veckan.

Följande exempel är ett manuellt standby-agentschema. Det använder värdet Eastern Standard Time med en ensam agent som tilldelats måndag till fredag, från 09:00 (antal standby-agenter 1) till 17:00 (antal standby-agenter 0).

{
    "kind": "Stateless",
    "resourcePredictions": {
        "timeZone": "Eastern Standard Time",
        "daysData": [
            {},
            {
                "09:00:00": 1,
                "17:00:00": 0
            },
            {
                "09:00:00": 1,
                "17:00:00": 0
            },
            {
                "09:00:00": 1,
                "17:00:00": 0
            },
            {
                "09:00:00": 1,
                "17:00:00": 0
            },
            {
                "09:00:00": 1,
                "17:00:00": 0
            },
            {}
        ]
    },
    "resourcePredictionsProfile": {
        "kind": "Manual"
    }
}

Ett enskilt daysData objekt innehåller en ordlista över tider och antal väntelägesagenter. Varje "time" : count post anger antalet väntelägesagenter som ska schemaläggas från och med den angivna tiden, i 24-timmarsformat. Poster i följd "time" : count anger en sekvens med schemalagda agentantal för den dagen.

"daysData": [
    {}, # Schedule of standby agent count adjustments for Sunday
    {   # Schedule of standby agent count adjustments for Monday
        "09:00:00": 1, # Adjust standby agent count to 1
        "17:00:00": 0  # Adjust standby agent count to 0
    },
    {  # Schedule of standby agent count adjustments for Tuesday
        "09:00:00": 1,
        "17:00:00": 0
    },
    {  # Schedule of standby agent count adjustments for Wednesday
        "09:00:00": 1,
        "17:00:00": 0
    },
    {  # Schedule of standby agent count adjustments for Thursday
        "09:00:00": 1,
        "17:00:00": 0
    },
    {  # Schedule of standby agent count adjustments for Friday
        "09:00:00": 1,
        "17:00:00": 0
    },
    {} # Schedule of standby agent count adjustments for Saturday
]

Antalet standbyagenter återställs inte automatiskt till noll i slutet av en dag eller i slutet av veckan. Om du anger ett tomt daysData objekt inaktiveras inte väntelägesagenter för den dagen. Ett tomt daysData objekt innebär att det inte finns några ändringar i väntelägesagentens antalsschema för den dagen. Om du vill ställa in väntelägesagenten till noll från och med en viss tidsperiod måste du uttryckligen ange en "time" : count post med värdet count0.

Exempel

Om du inte vill göra någon justering av antalet väntelägesagenter som angavs i slutet av föregående dag (eller vecka om du konfigurerar den första perioden i veckan) anger du ett daysData objekt med noll poster:

{}

Om du vill schemalägga en enskild standby-agent att starta vid 09:00:00 och stoppa vid 17:00:00 (med hjälp av den tidszon som anges av resourcePredictions egenskapen) anger du följande konfiguration:

{
    "09:00:00": 1,
    "17:00:00": 0
}

Om du vill schemalägga en enda standby-agent från midnatt till och med 09:00:00, följt av 10 standby-agenter till 17:00:00, anger du följande konfiguration:

{
    "00:00:00": 1,
    "09:00:00": 10,
    "17:00:00": 0
}

Om du vill schemalägga att en standby-agent ska vara tillgänglig från och med 09:00:00 den angivna dagen och stoppa 17:00:00 följande dag använder du två på varandra följande daysData objekt:

{
    "09:00:00": 1
},
{
    "17:00:00": 0
}

Azure CLI

Du kan konfigurera agenter med hjälp av parametern agent-profile när du skapar eller uppdaterar en pool.

az mdp pool create \
   --agent-profile agent-profile.json
   # other parameters omitted for space

I följande exempel visas innehållet i filen agent-profile.json . Du kan ange manuell etablering av standby-agenten resourcePredictionsProfile i avsnittet i parametern agent-profile . Konfigurera informationen i avsnittet resourcePredictions :

{
    "Stateless": {},
    "resourcePredictionsProfile": {
        "Manual": {}
    },
    "resourcePredictions": {
        "timeZone": "Eastern Standard Time",
        "daysData": [
            {},
            {
                "00:00:00": 1,
                "04:00:00": 0
            },
            {},
            {},
            {},
            {},
            {}
        ]
    }
}

Ange tidszonen för ditt schema med hjälp timeZone av egenskapen . Standardvärdet är UTC. Information om hur du hämtar en lista över tidszonsnamn för den här egenskapen finns i TimeZoneInfo.GetSystemTimeZones-metoden.

Listan daysData definierar schemat för standby-agenterna. Listan daysData kan innehålla antingen ett eller sju objekt.

En daysData lista med sju objekt mappar till veckodagarna, från och med söndag. Var och en av dessa sju objekt kan ha noll eller fler "time": count poster, som anger en tid i 24-timmarsformat och ett antal agenter i standbyläge. Det angivna antalet reservagenter bibehålls till nästa "time": count inmatning, som kan ske samma dag eller följande dag.

En daysData lista med ett enskilt objekt definierar ett schema för hela veckan, där den enskilda posten motsvarar antalet "time": count för hela veckan.

Följande exempel är ett manuellt standby-agentschema. Schemat använder värdet Eastern Standard Time med en enda agent som är schemalagd från måndag till fredag, från 09:00 (antal standbyagenter 1) till 17:00 (antal standbyagenter 0):

{
    "Stateless": {},
    "resourcePredictionsProfile": {
        "Manual": {}
    },
    "resourcePredictions": {
        "timeZone": "Eastern Standard Time",
        "daysData": [
            {},
            {
                "09:00:00": 1,
                "17:00:00": 0
            },
            {
                "09:00:00": 1,
                "17:00:00": 0
            },
            {
                "09:00:00": 1,
                "17:00:00": 0
            },
            {
                "09:00:00": 1,
                "17:00:00": 0
            },
            {
                "09:00:00": 1,
                "17:00:00": 0
            },
            {}
        ]
    }
}

Ett enskilt daysData objekt innehåller en ordlista över tider och antal väntelägesagenter. Varje "time" : count post anger antalet väntelägesagenter som ska schemaläggas från och med den angivna tiden, i 24-timmarsformat. Poster i följd "time" : count anger en sekvens med schemalagda agentantal för den dagen.

"daysData": [
    {}, # Schedule of standby agent count adjustments for Sunday
    {   # Schedule of standby agent count adjustments for Monday
        "09:00:00": 1, # Adjust standby agent count to 1
        "17:00:00": 0  # Adjust standby agent count to 0
    },
    {  # Schedule of standby agent count adjustments for Tuesday
        "09:00:00": 1,
        "17:00:00": 0
    },
    {  # Schedule of standby agent count adjustments for Wednesday
        "09:00:00": 1,
        "17:00:00": 0
    },
    {  # Schedule of standby agent count adjustments for Thursday
        "09:00:00": 1,
        "17:00:00": 0
    },
    {  # Schedule of standby agent count adjustments for Friday
        "09:00:00": 1,
        "17:00:00": 0
    },
    {} # Schedule of standby agent count adjustments for Saturday
]

Antalet standbyagenter återställs inte automatiskt till noll i slutet av en dag eller i slutet av veckan. Att ange ett tomt daysData objekt avaktiverar inte väntelägesagenter för den dagen. Ett tomt daysData objekt innebär att det inte finns några ändringar i väntelägesagentens antalsschema för den dagen. Om du vill ställa in väntelägesagenten till noll från och med en viss tidsperiod måste du uttryckligen ange en "time" : count post med värdet count0.

Exempel

Om du inte vill justera det angivna antalet väntelägesagenter i slutet av föregående dag (eller vecka om du konfigurerar den första perioden i veckan) anger du ett daysData objekt med noll poster:

{}

Om du vill schemalägga en enda standby-agent att starta vid 09:00:00 och stoppa vid 17:00:00 (med hjälp av den tidszon som du anger i resourcePredictions egenskapen) anger du följande konfiguration:

{
    "09:00:00": 1,
    "17:00:00": 0
}

Om du vill schemalägga en enda standby-agent från midnatt till och med 09:00:00, följt av 10 standby-agenter till 17:00:00, anger du följande konfiguration:

{
    "00:00:00": 1,
    "09:00:00": 10,
    "17:00:00": 0
}

Om du vill schemalägga att en standby-agent ska vara tillgänglig från och med 09:00:00 den angivna dagen och avsluta vid 17:00:00 följande dag, använder du två daysData objekt i följd.

{
    "09:00:00": 1
},
{
    "17:00:00": 0
}

Biceps

Du kan ange manuell konfiguration av standby-agenter i resourcePredictionsProfile-avsnittet av agentProfile. Du kan konfigurera informationen i avsnittet resourcePredictions :

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    agentProfile: {
      kind: 'Stateless'
      resourcePredictionsProfile: {
        kind: 'Manual'
      }
      resourcePredictions: {
        timeZone: 'Eastern Standard Time'
        daysData: [
          {}
          {
            '00:00:00': 1
            '04:00:00': 0
          }
          {}
          {}
          {}
          {}
          {}
        ]
      }
    }
  }
}

Ange önskad tidszon för schemat med hjälp timeZone av egenskapen . Standardvärdet är UTC. Information om hur du hämtar en lista över tidszonsnamn för den här egenskapen finns i TimeZoneInfo.GetSystemTimeZones-metoden.

Listan daysData definierar schemat för standby-agenterna. Listan daysData kan innehålla antingen ett eller sju objekt.

En daysData lista med sju objekt mappar till veckodagarna, från och med söndag. Var och ett av dessa sju element kan ha noll eller fler 'time': count poster, vilket anger en tid i 24-timmarsformat och antalet standby-agenter. Det angivna antalet väntelägesagenter bibehålls till nästa 'time': count post, som kan vara samma dag eller en efterföljande dag.

En daysData lista med ett enskilt objekt definierar ett schema för hela veckan, där den enskilda posten motsvarar antalet 'time': count för hela veckan.

Följande exempel är ett manuellt standby-agentschema som använder värdet Eastern Standard Time, med en enda agent etablerad måndag till fredag, från 09:00 (antal standbyagenter 1) till 17:00 (antal standbyagenter 0):

{
    kind: 'Stateless'
    resourcePredictions: {
        timeZone: 'Eastern Standard Time'
        daysData: [
          {}
          {
            '09:00:00': 1
            '17:00:00': 0
          }
          {
            '09:00:00': 1
            '17:00:00': 0
          }
          {
            '09:00:00': 1
            '17:00:00': 0
          }
          {
            '09:00:00': 1
            '17:00:00': 0
          }
          {
            '09:00:00': 1
            '17:00:00': 0
          }
          {}
        ]
    }
    resourcePredictionsProfile: {
        kind: 'Manual'
    }
}

Ett enskilt daysData objekt innehåller en ordlista över tider och antal väntelägesagenter. Varje 'time' : count post anger antalet väntelägesagenter som ska schemaläggas i 24-timmarsformat, med start vid angiven tidpunkt. Poster i följd 'time' : count anger en sekvens med schemalagda agentantal för den dagen.

daysData: [
    {} // Schedule of standby agent count adjustments for Sunday
    {   // Schedule of standby agent count adjustments for Monday
        '09:00:00': 1 // Adjust standby agent count to 1
        '17:00:00': 0  // Adjust standby agent count to 0
    }
    {  // Schedule of standby agent count adjustments for Tuesday
        '09:00:00': 1
        '17:00:00': 0
    }
    {  // Schedule of standby agent count adjustments for Wednesday
        '09:00:00': 1
        '17:00:00': 0
    }
    {  // Schedule of standby agent count adjustments for Thursday
        '09:00:00': 1
        '17:00:00': 0
    }
    {  // Schedule of standby agent count adjustments for Friday
        '09:00:00': 1
        '17:00:00': 0
    }
    {} // Schedule of standby agent count adjustments for Saturday
]

Antal väntelägesagenter återställs inte automatiskt till noll i slutet av en dag eller i slutet av veckan, och om du anger ett tomt daysData objekt inaktiveras inte väntelägesagenter för den dagen. Ett tomt daysData objekt innebär att det inte finns några ändringar i väntelägesagentens antalsschema för den dagen. Om du vill ställa in väntelägesagenten till noll från och med en viss tidsperiod måste du uttryckligen ange en "time" : count post med värdet count0.

Exempel

Om du inte vill göra någon justering av antalet väntelägesagenter som angavs i slutet av föregående dag (eller vecka om du konfigurerar den första perioden i veckan) anger du ett daysData objekt med noll poster:

{}

Om du vill schemalägga en enskild standby-agent att starta vid 09:00:00 och stoppa vid 17:00:00 (med hjälp av den tidszon som anges i resourcePredictions egenskapen) anger du följande konfiguration:

{
    '09:00:00': 1
    '17:00:00': 0
}

Om du vill schemalägga en enda standby-agent från midnatt till och med 09:00:00, följt av 10 standby-agenter till 17:00:00, anger du följande konfiguration:

{
    '00:00:00': 1
    '09:00:00': 10
    '17:00:00': 0
}

Om du vill schemalägga att en standby-agent ska vara tillgänglig från och med 09:00:00 den angivna dagen och avsluta tillgängligheten vid 17:00:00 följande dag, använder du två på varandra följande daysData händelser.

{
    '09:00:00': 1
}
{
    '17:00:00': 0
}

Börja från början

Om du väljer att börja från början kan du lägga till en lista över etableringsperioder som ditt etableringsschema. Varje tilldelningsperiod består av en startdag, en slutdag, en tidszon, en starttid, en sluttid och ett antal. Etableringsperioder kan inte överlappa varandra.

Fastighet	beskrivning
Flerdagars	När du väljer det här alternativet kan du konfigurera både startdag och slutdag för ditt etableringsschema.
Till nästa period	När du väljer det här alternativet körs etableringsperioden från starttidsvärdet till början av nästa etableringsperiod.
Startdag	Dagen då etableringsperioden startar.
Slutdag	Dagen då provisioneringsperioden upphör. Krävs om flera dagar har valts.
Starttid	Den tid då tilldelningsperioden startar.
Sluttid	Den tidpunkt då etableringsperioden slutar. Krävs såvida inte Till nästa period har valts.
Räkna	Antalet standby-agenter som ska etableras. Det här talet måste vara större än noll och får inte vara större än värdet Maximalt antal agenter i Poolinställningar.

När du har skapat en etableringsperiod kan du ta bort eller redigera perioden från listan Företableringsschema .

I följande exempel visas hur du konfigurerar ett manuellt schema med en agent som etableras på måndagsmorgnar från 12:00 till 05:00 EST.

Azure-portalen

ARM-mall

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "agentProfile": {
                    "kind": "Stateless",
                    "resourcePredictionsProfile": {
                        "kind": "Manual"
                    },
                    "resourcePredictions": {
                        "timeZone": "Eastern Standard Time",
                        "daysData": [
                            {},
                            {
                                "00:00:00": 1,
                                "04:00:00": 0
                            },
                            {},
                            {},
                            {},
                            {},
                            {}
                        ]
                    }
                }
            }
        }
    ]
}

Azure CLI

{
    "Stateless": {},
    "resourcePredictionsProfile": {
        "Manual": {}
    },
    "resourcePredictions": {
        "timeZone": "Eastern Standard Time",
        "daysData": [
            {},
            {
                "00:00:00": 1,
                "04:00:00": 0
            },
            {},
            {},
            {},
            {},
            {}
        ]
    }
}

Biceps

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    agentProfile: {
      kind: 'Stateless'
      resourcePredictionsProfile: {
        kind: 'Manual'
      }
      resourcePredictions: {
        timeZone: 'Eastern Standard Time'
        daysData: [
          {}
          {
            '00:00:00': 1
            '04:00:00': 0
          }
          {}
          {}
          {}
          {}
          {}
        ]
      }
    }
  }
}

Veckodagsschema

Om du väljer veckodagsschemat kan du ange en starttid och sluttid, mellan vilken det angivna antalet standby-agenter är i vänteläge varje veckodag.

Fastighet	beskrivning
Starttid	Den tid då tilldelningsperioden startar.
Sluttid	Den tidpunkt då etableringsperioden slutar.
Antal provisioneringar	Antalet standby-agenter som ska etableras. Det här talet måste vara större än noll och får inte vara större än värdet Maximalt antal agenter som konfigurerats i Poolinställningar.

I följande exempel konfigureras fyra agenter som ska användas under arbetstid och inga agenter under lediga timmar och helger, med hjälp av Eastern Time (UTC-5).

Azure-portalen

ARM-mall

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "agentProfile": {
                    "kind": "Stateless",
                    "resourcePredictionsProfile": {
                        "kind": "Manual"
                    },
                    "resourcePredictions": {
                        "timeZone": "Eastern Standard Time",
                        "daysData": [
                            {},
                            {
                                "09:00:00": 4,
                                "17:00:00": 0
                            },
                            {
                                "09:00:00": 4,
                                "17:00:00": 0
                            },
                            {
                                "09:00:00": 4,
                                "17:00:00": 0
                            },
                            {
                                "09:00:00": 4,
                                "17:00:00": 0
                            },
                            {
                                "09:00:00": 4,
                                "17:00:00": 0
                            },
                            {}
                        ]
                    }
                }
            }
        }
    ]
}

Azure CLI

{
    "Stateless": {},
    "resourcePredictionsProfile": {
        "Manual": {}
    },
    "resourcePredictions": {
        "timeZone": "Eastern Standard Time",
        "daysData": [
            {},
            {
                "09:00:00": 4,
                "17:00:00": 0
            },
            {
                "09:00:00": 4,
                "17:00:00": 0
            },
            {
                "09:00:00": 4,
                "17:00:00": 0
            },
            {
                "09:00:00": 4,
                "17:00:00": 0
            },
            {
                "09:00:00": 4,
                "17:00:00": 0
            },
            {}
        ]
    }
}

Biceps

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    agentProfile: {
      kind: 'Stateless'
      resourcePredictionsProfile: {
        kind: 'Manual'
      }
      resourcePredictions: {
        timeZone: 'Eastern Standard Time'
        daysData: [
          {}
          {
            '09:00:00': 4
            '17:00:00': 0
          }
          {
            '09:00:00': 4
            '17:00:00': 0
          }
          {
            '09:00:00': 4
            '17:00:00': 0
          }
          {
            '09:00:00': 4
            '17:00:00': 0
          }
          {
            '09:00:00': 4
            '17:00:00': 0
          }
          {}
        ]
      }
    }
  }
}

Schema för hela veckan

Om du väljer schemat för hela veckan kan du ange det antal agenter som du vill ha tillgängliga hela tiden.

Azure-portalen

ARM-mall

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "agentProfile": {
                    "kind": "Stateless",
                    "resourcePredictionsProfile": {
                        "kind": "Manual"
                    },
                    "resourcePredictions": {
                        "timeZone": "Eastern Standard Time",
                        "daysData": [
                            {
                                "00:00:00": 1
                            }
                        ]
                    }
                }
            }
        }
    ]
}

Azure CLI

{
    "Stateless": {},
    "resourcePredictionsProfile": {
        "Manual": {}
    },
    "resourcePredictions": {
        "timeZone": "Eastern Standard Time",
        "daysData": [
            {
                "00:00:00": 1
            }
        ]
    }
}

Biceps

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    agentProfile: {
      kind: 'Stateless'
      resourcePredictionsProfile: {
        kind: 'Manual'
      }
      resourcePredictions: {
        timeZone: 'Eastern Standard Time'
        daysData: [
          {
            '00:00:00': 1
          }
        ]
      }
    }
  }
}

Automatisk

Om du inte känner till dina användningsmönster och vill förlita dig på automatisk prognostisering baserat på tidigare data väljer du Automatisk. Du kan balansera mellan kostnad och agentprestanda med hjälp av ett skjutreglage med följande fem alternativ. Hanterade DevOps-pooler kör en förfrågan över de senaste tre veckornas historiska data, om sådana finns. Den organiserar köade sessioner i poolen i femminutersperioder och tilldelar den angivna percentilen (för att undvika toppar) till varje timme.

• Mest kostnadseffektiva (MostCostEffective): tionde percentilen.
• Mer kostnadseffektivt (MoreCostEffective): 25:e percentilen.
• Balanserad (standard) (Balanced): 50:e percentilen.
• Mer prestanda (MorePerformance): 75:e percentilen.
• Bästa prestanda (BestPerformance): 90:e percentilen.

Azure-portalen

ARM-mall

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "agentProfile": {
                    "kind": "Stateless",
                    "resourcePredictionsProfile": {
                        "predictionPreference": "Balanced",
                        "kind": "Automatic"
                    }
                }
            }
        }
    ]
}

Azure CLI

{
    "Stateless": {},
    "resourcePredictionsProfile": {
        "Automatic": {
            "predictionPreference": "Balanced"
        }
    }
}

Biceps

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    agentProfile: {
      kind: 'Stateless'
      resourcePredictionsProfile: {
        kind: 'Automatic'
        predictionPreference: 'Balanced'
      }
    }
  }
}

Agenternas livscykel och potentiella fördröjningar i allokeringen

När du aktiverar standby-agenter med hjälp av ett tillståndslöst schema måste du installera och konfigurera Azure Pipelines-agenten innan du övergår från det klara tillståndet till det allokerade tillståndet och kör en pipeline.

När hanterade DevOps-pooler tillhandahåller nya agenter försöker den ladda ned den senaste Azure Pipelines-agenten så att den redan laddas ned på standby-agenter innan de övergår till färdig status. Start, anslutning och början av jobbet kan ta allt från 10 sekunder till en minut beroende på poolens SKU-hastighet, den avbildning som används och nätverksbelastningen. När du anger vissa inställningar i ett pipelinejobb kan det dessutom orsaka en ny nedladdning och körning av en annan agent. Regressioner och återgångar av agenten kan också orsaka en omladdning av agenten.

Färdiga agenter har alltid en potentiell fördröjning eftersom Hanterade DevOps-pooler använder den här agenten på ett "tillfälligt" sätt, vilket innebär att vi startar och kör uppgiftsagenten en gång per jobb. Om du ser fördröjningar hos agenter som är beredda att hämta jobb från Azure DevOps, bör du överväga följande frågor:

• Har du redo agenter? Det vanligaste problemet är ett missförstånd om när agenter ska förkonfigureras i förväg. Datorer måste snurras upp från grunden när följande villkor uppfylls:
  • Antalet jobb i kö är större än antalet väntelägesagenter i en pool.
  • Jobb placeras i kö utanför företableringsschemat.
  • Antalet standbyagenter är inställt till noll.
• Konfigurerar du väntelägesagenter som har flera bilder på rätt sätt? Om du inte anger vilken bild som ska användas i din pipeline med hjälp av kravet ImageOverride, riktar sig jobben mot den första bilden. Beroende på dina skalningsinställningar kanske du inte har så många agenter tillgängliga som du förväntar dig, eftersom vissa allokeras till andra avbildningar.
• Använder du ImageVersionOverride-efterfrågan i dina pipelines? När du använder ImageVersionOverride begäran för att ange en annan avbildningsversion än vad som har konfigurerats i poolinställningarna startar varje agent på begäran med den angivna avbildningsversionen. Standby-agenter etableras med hjälp av de avbildningsversioner som anges i poolens konfiguration. Om du använder ImageVersionOverridematchar inte väntelägesagenter den versionen och en ny agent startar.
• Saktar proxy-, virtuellt nätverk eller brandväggsinställningar ner poolen? Potentiell långsamhet från alla nätverksinställningar leder till att agenter tar längre tid att starta agenten och ansluta den till Azure DevOps.
• Åsidosättar du agentversionen? Som standard körs Managed DevOps-pooler på den senaste versionen av Azure DevOps-uppgiftsagenten. Inställningar i YAML-pipelinen (till exempel Agent.Version efterfrågan) och Azure DevOps-organisationsinställningar kan tvinga pipelines att använda äldre versioner av aktivitetsagenten, vilket kräver en åternedladdning när en dator har allokerats.

Relaterat innehåll

• Konfigurera poolinställningar
• Hantera kostnader och prestanda