Configurare le impostazioni del pool

Questo articolo descrive come configurare le impostazioni di base dell'istanza di Pool DevOps gestiti.

Informazioni generali

Per visualizzare una panoramica delle impostazioni del pool, vedere Panoramica.

In Panoramica è possibile:

• Visualizzare i dettagli del gruppo di risorse e della sottoscrizione e spostare le risorse di Azure in un nuovo gruppo di risorse o sottoscrizione.
• Visualizzare la posizione del pool. Per visualizzare i percorsi supportati, seguire la procedura descritta in Registrare il provider di risorse pool DevOps gestiti nella sottoscrizione di Azure.
• Configurare i tag. I pool DevOps gestiti passano fino a 20 tag alla macchina virtuale e gli altri vengono ignorati.
• Visualizzare le informazioni di configurazione per il pool, ad esempio Nome, organizzazione Di Azure DevOps, Stato agente e Agenti massimi.
• Visualizzare grafici delle metriche predefiniti.

Impostazioni del pool

Per configurare il pool, passare a Pool di impostazioni>.

Per configurare il pool, usare le impostazioni seguenti:

• Progetto Dev Center
• Organizzazione DevOps di Azure
• Immagini
• Numero massimo di agenti
• Dimensioni agente
• Tipo di disco del sistema operativo

Progetto Dev Center

Portale di Azure

Selezionare l'istanza del progetto Dev Center per il pool. Se non è disponibile, è possibile creare un'istanza di Dev Center e un'istanza del progetto Dev Center quando si crea il pool.

Modello ARM

La proprietà devCenterProjectResourceId specifica l'istanza del progetto Dev Center.

{
    "$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",
            "location": "eastus",
            "tags": {},
            "properties": {
                ...
                "devCenterProjectResourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project"
            }
        }
    ]
}

È possibile recuperare il valore per un'istanza devCenterProjectResourceId del progetto Dev Center nel portale di Azure usando la visualizzazione JSON dalla pagina di panoramica dell'istanza del progetto Dev Center . È anche possibile recuperarlo usando l'interfaccia della riga di comando di Azure per eseguire una query sul progetto per la relativa id proprietà.

Nell'esempio seguente il devCenterProjectResourceId valore viene recuperato da un'istanza del progetto Dev Center denominata fabrikam-dev-center-project nel fabrikam-managed-devops-pools gruppo di risorse.

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

Interfaccia della riga di comando di Azure

Il devcenter-project-id parametro specifica l'istanza del progetto Dev Center quando si crea o si aggiorna un pool.

az mdp pool create \
   --devcenter-project-id /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/resourceGroupName/providers/Microsoft.DevCenter/projects/devCenterProjectName
   # other parameters omitted for space

È possibile recuperare il devcenter-project-id per l'istanza del progetto Dev Center nel portale di Azure utilizzando la visualizzazione JSON dalla pagina Overview dell'istanza del progetto Dev Center. È anche possibile recuperarlo usando l'interfaccia della riga di comando di Azure per eseguire una query sul progetto per la relativa id proprietà.

Nell'esempio seguente l'oggetto devcenter-project-id viene recuperato da un'istanza del fabrikam-dev-center-project denominata fabrikam-managed-devops-pools nel gruppo di risorse.

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

Bicipite

La proprietà specifica l'istanza del progetto Dev Center .

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    devCenterProjectResourceId: '/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project'
  }
}

È possibile recuperare il devCenterProjectResourceId per l'istanza del progetto Dev Center nel portale di Azure utilizzando la visualizzazione JSON dalla pagina Panoramica dell'istanza del progetto Dev Center. È anche possibile recuperarlo usando l'interfaccia della riga di comando di Azure per eseguire una query sul progetto per la relativa id proprietà.

Nell'esempio seguente l'oggetto devCenterProjectResourceId viene recuperato da un'istanza del fabrikam-dev-center-project denominata fabrikam-managed-devops-pools nel gruppo di risorse.

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

Organizzazione DevOps di Azure

Portale di Azure

Se il pool è stato configurato per una singola organizzazione Azure DevOps, è possibile specificare l'organizzazione nelle impostazioni del pool.

Se il pool è stato configurato per più organizzazioni, l'impostazione dell'organizzazione Azure DevOps non è presente nelle impostazioni del pool. Per configurare il pool per l'uso in più organizzazioni, passare a Impostazioni>Sicurezza e configurare Usa pool in più organizzazioni.

Modello ARM

È possibile configurare il valore dell'organizzazione di Azure DevOps usando l'elenco organizations nella organizationProfile sezione .

Nell'esempio seguente un pool è configurato per tutti i progetti in una singola organizzazione, con un parallelismo pari a 4. Per un esempio che illustra come configurare più organizzazioni, vedere Usare il pool in più organizzazioni.

{
    "$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": {
                ...
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "https://dev.azure.com/fabrikam-tailspin",
                            "projects": [],
                            "parallelism": 4
                        }
                    ]
                }
            }
        }
    ]
}

Interfaccia della riga di comando di Azure

È possibile configurare il valore dell'organizzazione di Azure DevOps usando l'elenco organizations nel organization-profile parametro .

Nell'esempio seguente un pool è configurato per tutti i progetti in una singola organizzazione, con un parallelismo pari a 4. Per un esempio che illustra come configurare più organizzazioni, vedere Usare il pool in più organizzazioni.

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

Nell'esempio seguente viene illustrato l'elenco organizations nel file organization-profile.json .

{
  "AzureDevOps": {
    "organizations": [
      {
        "url": "https://dev.azure.com/fabrikam-tailspin",
        "projects": [],
        "parallelism": 4
      }
    ],
    "permissionProfile": {...}
  }
}

Bicipite

È possibile configurare il valore dell'organizzazione di Azure DevOps usando l'elenco organizations nella organizationProfile sezione .

Nell'esempio seguente un pool è configurato per tutti i progetti in una singola organizzazione, con un parallelismo pari a 4.

Per un esempio che illustra come configurare più organizzazioni, vedere Usare il pool in più organizzazioni.

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    organizationProfile: {
      organizations: [
        {
          url: 'https://dev.azure.com/fabrikam-tailspin'
          projects: []
          parallelism: 4
        }
      ]
    }
  }
}

Per impostazione predefinita, il pool è disponibile per tutti i progetti nelle organizzazioni specificate. Per limitare il pool a progetti specifici, vedere Impostazioni di sicurezza: Configurare l'accesso all'organizzazione.

Numero massimo di agenti

Specificare il numero massimo di agenti di cui è possibile eseguire il provisioning contemporaneamente nel pool. Ad esempio, se si specifica un valore massimo di agenti pari a 2, è possibile eseguire contemporaneamente un massimo di due agenti. Se vengono accodati più di due processi, vengono eseguiti lavori su soli due agenti, mentre gli altri processi attendono.

È possibile visualizzare lo stato corrente e il numero degli agenti di cui è stato effettuato il provisioning nel pool usando il riquadro Agenti . Tutti gli agenti nella visualizzazione Agenti (ad eccezione degli agenti con stato Restituito) sono eseguiti su una risorsa di macchina virtuale e vengono conteggiati nel conteggio massimo degli agenti.

Portale di Azure

È possibile configurare il valore Massimo agentiin Impostazioni pool per un pool esistente e nella scheda Informazioni di base quando si crea un pool.

Modello ARM

È possibile configurare il valore Massimo agenti usando la maximumConcurrency proprietà .

Nell'esempio seguente il valore Massimo agenti è 4.

{
    "$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": {
                ...
                "maximumConcurrency": 4
            }
        }
    ]
}

Interfaccia della riga di comando di Azure

È possibile configurare il valore Massimo agenti usando il maximum-concurrency parametro quando si crea o si aggiorna un pool.

Nell'esempio seguente il valore Massimo agenti è 4.

az mdp pool create \
   --maximum-concurrency 4
   # other parameters omitted for space

Bicipite

È possibile configurare il valore Massimo agenti usando la maximumConcurrency proprietà .

Nell'esempio seguente il valore Massimo agenti è 4.

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

Nota

Il valore Massimo agenti configura il numero massimo di agenti di cui è possibile eseguire il provisioning contemporaneamente, ma il numero di processi paralleli self-hosted dell'organizzazione specifica il numero di processi che possono essere eseguiti contemporaneamente. Assicurarsi di disporre di un numero sufficiente di processi paralleli self-hosted disponibili nell'organizzazione per consentire agli agenti di eseguire i processi. Per altre informazioni, vedere Prezzi dei processi paralleli di Azure DevOps Services.

Dimensioni agente

L'impostazione Dimensioni agente specifica le dimensioni della macchina virtuale di Azure da usare per ospitare gli agenti di Pool DevOps gestiti.

Portale di Azure

Per visualizzare e selezionare una dimensione di macchina virtuale di Azure disponibile nell'area di Azure, selezionare Cambia dimensione. Le dimensioni degli agenti (SKU) con le quote dei pool DevOps gestiti disponibili sono contrassegnate come Disponibili. È possibile richiedere una quota maggiore per gli SKU contrassegnati come Non disponibili. Dopo l'approvazione di una richiesta di quota per uno SKU non disponibile , viene contrassegnata come Disponibile. Altre informazioni sulle quote dei pool DevOps gestiti.

Modello ARM

È possibile configurare le dimensioni dell'agente usando la sku proprietà nella fabricProfile sezione . Nell'esempio seguente viene specificata una Standard_D2ads_v5 dimensione della macchina virtuale.

{
    "$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": {
                ...
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    }
                }
            }
        }
    ]
}

Interfaccia della riga di comando di Azure

È possibile configurare le dimensioni dell'agente usando la sku proprietà nella fabricProfile sezione quando si crea o si aggiorna un pool. Nell'esempio seguente viene specificata una Standard_D2ads_v5 dimensione della macchina virtuale.

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

Nell'esempio seguente viene illustrata la sku sezione del fabric-profile.json file .

{
  "vmss": {
    "sku": {
      "name": "Standard_D2ads_v5"
    },
    "images": [...],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Bicipite

È possibile configurare le dimensioni dell'agente usando la sku proprietà nella fabricProfile sezione . Nell'esempio seguente viene specificata una Standard_D2ads_v5 dimensione della macchina virtuale.

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

Se la sottoscrizione non ha la capacità di configurare il pool con lo SKU della macchina virtuale di Azure e il numero massimo di agenti specificati, viene visualizzato un messaggio di errore simile al seguente:

Cores needed to complete this request is 8, which exceeds the current limit of 0 for SKU family standardDDSv4Family in region eastus. Please choose a different region if possible, or request additional quota at https://portal.azure.com/#view/Microsoft_Azure_Support/NewSupportRequestV3Blade/issueType/quota/subscriptionId/subscription_id_placeholder/topicId/3eadc5d3-b59a-3658-d8c6-9c729ba35b97

Per risolvere il problema, vedere Esaminare le quote dei pool DevOps gestiti.

Non tutti gli SKU sono supportati per tutte le aree di Azure. Se viene visualizzato un errore simile a SKU family <sku-family> is not available in location <region>, assicurati che le dimensioni dello SKU siano supportate per la tua regione. Per altre informazioni, vedere Dimensioni delle macchine virtuali in Azure e Prodotti disponibili in base all'area geografica.

Tipo di disco del sistema operativo

I pool DevOps gestiti forniscono i tipi di disco seguenti per il disco del sistema operativo:

• Normale
• SSD Standard
• SSD Premium

Il tipo di disco del sistema operativo predefinito è Standard. Se la velocità effettiva del carico di lavoro supera il livello del livello standard, è possibile ottenere un miglioramento delle prestazioni nel carico di lavoro eseguendo l'aggiornamento a un tipo di disco con prestazioni più elevate. Per altre informazioni sui tipi di disco e sulle prestazioni, vedere Tipi di dischi gestiti di Azure.

Portale di Azure

È possibile configurare il tipo di disco del sistema operativonelle impostazioni del pool per un pool esistente. È possibile configurare il tipo di disco del sistema operativo nella scheda Informazioni di base quando si crea un pool.

Modello ARM

È possibile configurare il tipo di disco del sistema operativo usando la osDiskStorageAccountType proprietà nella storageProfile sezione . Selezionare Standard, StandardSSD o Premium.

Nell'esempio seguente viene specificato un tipo di disco del sistema operativo Standard :

{
    "$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": {
                ...
                "storageProfile": {
                    "osDiskStorageAccountType": "Standard"
                }
            }
        }
    ]
}

Interfaccia della riga di comando di Azure

È possibile configurare il tipo di disco del sistema operativo usando la osDiskStorageAccountType proprietà nella storageProfile sezione del fabric-profile parametro .

Selezionare Standard, StandardSSD o Premium. Nell'esempio seguente viene specificato un tipo di disco del sistema operativo Standard .

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

Nell'esempio seguente viene illustrata la storageProfile sezione del fabric-profile.json file .

{
  "vmss": {
    "sku": {...},
    "images": [...],
    "osProfile": {...},
    "storageProfile": {
      "osDiskStorageAccountType": "Standard",
      "dataDisks": []
    }
  }
}

Bicipite

È possibile configurare il tipo di disco del sistema operativo usando la osDiskStorageAccountType proprietà nella storageProfile sezione .

Selezionare Standard, StandardSSD o Premium. Nell'esempio seguente viene specificato un tipo di disco del sistema operativo Standard .

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    fabricProfile: {
      ...
      storageProfile: {
        osDiskStorageAccountType: 'Standard'
      }
    }
  }
}

Immagini

I pool DevOps gestiti offrono diverse opzioni di immagine della macchina virtuale da usare per eseguire pipeline nel pool. È possibile creare il pool usando immagini di macchine virtuali del Marketplace selezionate, immagini personalizzate in un'istanza di Azure Compute Gallery o le stesse immagini Windows e Linux usate dagli agenti ospitati da Microsoft azure Pipelines.

Importante

Le immagini seguenti sono deprecate nei pool DevOps gestiti:

• Azure Pipelines - Windows Server 2019
• Ubuntu 20.04

Per ulteriori informazioni, consultare Programma di deprecazione delle immagini dei pool DevOps gestiti.

È possibile configurare il pool in modo da usare una singola immagine o più immagini. È anche possibile usare alias per configurare le pipeline per usare un'immagine specifica. Per altre informazioni, vedere Configurare immagini di pool DevOps gestiti.

Importante

Se nel pool sono presenti più immagini e non si usano richieste nelle pipeline per designare un'immagine, le pipeline vengono eseguite usando la prima immagine elencata nel pool. È possibile modificare l'ordine delle immagini nel pool nei modi seguenti:

• Usa i modelli: modifica l'ordine delle immagini nella sezione fabricProfile dell'elenco images.
• Usare il trascinamento: ordinare le immagini nell'elenco di immagini nel portale di Azure.

Contenuti correlati

• Configurare le immagini