Configurare le impostazioni del pool

Importante

I pool DevOps gestiti sono attualmente in ANTEPRIMA. Vedere le condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure per termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale.

Questo articolo descrive come configurare le impostazioni di base del pool DevOps gestito.

Passare a Panoramica per visualizzare una panoramica delle impostazioni del pool, spostare le risorse di Azure in un nuovo gruppo di risorse o sottoscrizione o configurare i tag. I pool DevOps gestiti passano fino a 20 tag alla macchina virtuale e gli altri vengono ignorati.

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

Usare le impostazioni seguenti per configurare il pool devOps gestito.

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

Progetto Dev Center

Azure portal

Scegliere il progetto Dev Center per il pool DevOps gestito. Durante la creazione del pool, è possibile creare un progetto Dev Center e Dev Center, se non ne è disponibile uno.

Modello ARM

Il progetto dev center viene specificato dalla devCenterProjectResourceId proprietà .

    "$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 per devCenterProjectResourceId il progetto dev Center nel portale di Azure usando la visualizzazione JSON dalla pagina di panoramica del progetto Dev Center oppure è 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, viene devCenterProjectResourceId recuperato da un progetto Dev Center denominato 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 progetto dev center viene specificato dal parametro durante la creazione o l'aggiornamento devcenter-project-id di 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 per devcenter-project-id il progetto dev center nel portale di Azure usando la visualizzazione JSON dalla pagina di panoramica del progetto dev center oppure è 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, viene devcenter-project-id recuperato da un progetto dev center denominato 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"

Organizzazione DevOps di Azure

Azure portal

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

Se il pool è 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

L'organizzazione di Azure DevOps viene configurata usando l'elenco organizations nella organizationProfile sezione . Nell'esempio seguente viene configurato un pool DevOps gestito per tutti i progetti in una singola organizzazione, con un parallelismo pari a 4. Per un esempio di configurazione di 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": "2024-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "https://dev.azure.com/fabrikam-tailspin",
                            "projects": [],
                            "parallelism": 4
                        }
                    ]
                }
            }
        }
    ]
}

Interfaccia della riga di comando di Azure

L'organizzazione di Azure DevOps viene configurata usando l'elenco organizations nel organization-profile parametro . Nell'esempio seguente viene configurato un pool DevOps gestito per tutti i progetti in una singola organizzazione, con un parallelismo pari a 4. Per un esempio di configurazione di 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": {...}
  }
}

Per impostazione predefinita, il pool devOps gestito è 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 disponibili per l'uso 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, verranno eseguiti solo due agenti alla volta durante l'attesa degli altri processi.

Azure portal

Il numero massimo di agenti è configurato nelle impostazioni pool per un pool esistente e nella scheda Informazioni di base durante la creazione di un pool.

Modello ARM

Il numero massimo di agenti viene configurato usando la maximumConcurrency proprietà . Nell'esempio seguente, Maximum agents è impostato su 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": "2024-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "maximumConcurrency": 4
            }
        }
    ]
}

Interfaccia della riga di comando di Azure

Il numero massimo di agenti viene configurato usando il parametro durante la maximum-concurrency creazione o l'aggiornamento di un pool. Nell'esempio seguente, Maximum agents è impostato su 4.

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

Nota

Il numero massimo di 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 simultaneamente. 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

Le dimensioni dell'agente specificano le dimensioni della macchina virtuale di Azure da usare per l'hosting degli agenti di pool DevOps gestiti.

Azure portal

Scegliere Cambia dimensioni per visualizzare e selezionare una dimensione della macchina virtuale di Azure disponibile nell'area di Azure. 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 non disponibili . Dopo l'approvazione di una richiesta di quota per uno SKU non disponibile , verrà elencata come Disponibile. Altre informazioni sulle quote dei pool DevOps gestiti.

Modello ARM

Le dimensioni dell'agente sono configurate usando la sku proprietà nella fabricProfile sezione . Nell'esempio seguente viene specificata una dimensione della macchina virtuale Standard_D2ads_v5 .

{
    "$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": "2024-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    }
                }
            }
        }
    ]
}

Interfaccia della riga di comando di Azure

Le dimensioni dell'agente sono configurate usando la sku proprietà nella sezione durante la fabricProfile creazione o l'aggiornamento di un pool. Nell'esempio seguente viene specificata una dimensione della macchina virtuale Standard_D2ads_v5 .

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

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

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

Se la sottoscrizione non ha la capacità di configurare il pool con lo SKU della macchina virtuale di Azure desiderato e il numero massimo di agenti, verrà visualizzato un errore simile al messaggio 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>, verificare che le dimensioni dello SKU siano supportate per l'area. 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.

• Standard
• 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.

Azure portal

Il tipo di disco del sistema operativo è configurato nelle impostazioni del pool per un pool esistente e nella scheda Informazioni di base durante la creazione di un pool.

Modello ARM

Il tipo di disco del sistema operativo viene configurato usando la osDiskStorageAccountType proprietà nella storageProfile sezione . Nell'esempio seguente viene specificato un tipo di disco del sistema operativo Standard . Scegliere Standard, StandardSSD o Premium.

{
    "$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": "2024-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "storageProfile": {
                    "osDiskStorageAccountType": "Standard"
                }
            }
        }
    ]
}

Interfaccia della riga di comando di Azure

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

Il tipo di disco del sistema operativo viene configurato usando la osDiskStorageAccountType proprietà nella storageProfile sezione del fabric-profile parametro . Nell'esempio seguente viene specificato un tipo di disco del sistema operativo Standard . Scegliere Standard, StandardSSD o Premium.

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

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

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

Immagini

I pool DevOps gestiti offrono diverse opzioni per le immagini delle macchine virtuali per l'esecuzione di pipeline nel pool. È possibile creare il pool usando immagini di macchine virtuali di Azure Marketplace selezionate, usare immagini personalizzate in una raccolta di calcolo di Azure oppure usare le stesse immagini Windows e Linux usate dagli agenti ospitati da Microsoft Azure Pipelines.

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

Vedi anche

• Configurare le immagini