Configurare le immagini dei pool gestiti di DevOps

Articolo
2025-05-04

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 della raccolta di calcolo di Azure oppure usare le stesse immagini degli agenti ospitati da Microsoft Azure Pipelines.

I pool DevOps gestiti possono essere configurati con una singola immagine o più immagini. Quando il pool include più immagini, le pipeline devono specificare l'immagine su cui desiderano essere eseguite utilizzando gli alias .

Importante

Il supporto standard ubuntu 20.04 LTS sta per arrivare alla fine del 31 maggio 2025 e i pool di DevOps gestiti stanno rimuovendo le immagini Ubuntu 20.04 dalle immagini del marketplace selezionate e dalle immagini di Azure Pipelines.

La creazione di nuovi pool con immagini del marketplace selezionate o immagini di Azure Pipelines con Ubuntu 20.04 verrà disabilitata a partire dal 1° giugno 2025, ma i pool esistenti in queste immagini continueranno a essere eseguiti fino al 1° luglio 2025.
Il 1° luglio 2025, i pool che utilizzano immagini selezionate dal marketplace di Ubuntu 20.04 o immagini di Azure Pipelines verranno disattivati. Gli agenti che usano queste immagini non effettueranno il provisioning e le pipeline non verranno eseguite.

Per mantenere i pool di DevOps gestiti che attualmente usano Ubuntu 20.04 in esecuzione, aggiornare le immagini Ubuntu 20.04 a Ubuntu 22.04 o 24.04 (scelta consigliata). Per altre informazioni, vedere Scegliere l'immagine del pool. Se hai più immagini nel tuo pool, aggiorna gli alias delle tue immagini Ubuntu affinché le pipeline che richiedono Ubuntu vengano eseguite usando l'immagine desiderata.

Scegliere l'immagine del pool

Quando si crea un pool DevOps gestito, viene selezionata un'immagine predefinita. È possibile mantenere la scelta predefinita o modificarla durante la creazione del pool. Per configurare l'immagine dopo la creazione del pool, passare a Impostazioni>Pool, scegliere Aggiungi da Raccolta di Immagini e selezionare una o più immagini per il pool.

Screenshot della configurazione dell'immagine.

Le immagini vengono configurate nella fabricProfile sezione delle proprietà delle risorse Pool devOps gestiti.

Nell'esempio seguente vengono specificate tre immagini. Per altre informazioni sullo schema per le immagini, vedere le sezioni seguenti in questo articolo.

{
    "$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-10-19",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    ...
                    "images": [
                        {
                            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
                            "aliases": [
                                "ubuntu-24.04-gen2"
                            ]
                        },
                        {
                            "wellKnownImageName": "windows-2022"
                        },
                        {
                            "wellKnownImageName": "ubuntu-22.04"
                        }
                    ]
                }
            }
        }
    ]
}

Ogni immagine può avere le proprietà seguenti.

Proprietà	Descrizione
`aliases`	Elenco facoltativo di alias. È quindi possibile fare riferimento all'immagine usando gli alias anziché l'ID risorsa completo dell'immagine.
`resourceID`	ID risorsa dell'immagine da usare. Obbligatorio quando si usano le immagini di Azure Compute Gallery o le immagini selezionate dal Microsoft Marketplace.
`wellKnownImageName`	Alias dell'immagine di Azure Pipelines. Obbligatorio quando si usano immagini di Azure Pipelines.
`buffer`	Quando gli agenti di standby sono abilitati, `buffer` indica la percentuale di agenti di standby da allocare a questa immagine. Il totale di tutti i valori dell'immagine `buffer` deve essere uguale a 100.

L'esempio seguente definisce tre immagini. Gli agenti standby sono abilitati, con il 100% degli agenti standby allocati all'immagine windows-2022.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
        "aliases": [
            "ubuntu-24.04-gen2"
        ],
        "buffer": "0"
    },
    {
        "buffer": "100",
        "wellKnownImageName": "windows-2022"
    },
    {
        "buffer": "0",
        "wellKnownImageName": "ubuntu-22.04"
    }
]

Le immagini vengono configurate nella fabric-profile sezione delle proprietà delle risorse Pool devOps gestiti.

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

Nell'esempio seguente viene illustrata la images sezione del file fabric-profile.json e vengono specificate tre immagini. Per altre informazioni sullo schema per le immagini, vedere le sezioni seguenti in questo articolo.

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
            "aliases": [
                "ubuntu-24.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Ogni immagine può avere le proprietà seguenti.

Proprietà	Descrizione
`aliases`	Elenco facoltativo di alias. È quindi possibile fare riferimento all'immagine usando gli alias anziché l'ID risorsa completo dell'immagine.
`resourceID`	ID risorsa dell'immagine da usare. Obbligatorio quando si usano le immagini di Azure Compute Gallery o le immagini selezionate dal Microsoft Marketplace.
`wellKnownImageName`	Alias dell'immagine di Azure Pipelines. Obbligatorio quando si usano immagini di Azure Pipelines.
`buffer`	Quando gli agenti di standby sono abilitati, `buffer` indica la percentuale di agenti di standby da allocare a questa immagine. Il totale di tutti i valori dell'immagine `buffer` deve essere uguale a 100.

L'esempio seguente definisce tre immagini. Gli agenti standby sono abilitati, con il 100% degli agenti standby allocati all'immagine windows-2022.

{
  "vmss": {
    "sku": {...},
    "images": [
        {
            "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
            "aliases": [
                "ubuntu-24.04-gen2"
            ],
            "buffer": "0"
        },
        {
            "buffer": "100",
            "wellKnownImageName": "windows-2022"
        },
        {
            "buffer": "0",
            "wellKnownImageName": "ubuntu-22.04"
        }
    ],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Se si sceglie una singola immagine, tutte le pipeline vengono eseguite nel tuo pool usando quell'immagine. Se si scelgono più immagini, è possibile specificare l'immagine da usare per ogni pipeline. Per altre informazioni, vedere Usare più immagini per pool.

Importante

Se nel pool sono presenti più immagini e non si usano domande nelle pipeline per selezionare un'immagine, le pipeline vengono eseguite usando la prima immagine nel pool. È possibile modificare l'ordine delle immagini nel pool modificando l'ordine delle immagini nell'elenco images nella sezione fabricProfile (se si usano modelli di ) oppure ordinando le immagini nell'elenco delle immagini nel portale di Azure usando il trascinamento della selezione.

È possibile scegliere tra i tipi di immagini seguenti.

Immagini di Azure Pipelines: scegliere tra le stesse immagini usate dagli agenti ospitati da Microsoft.
Immagini del marketplace selezionate: scegliere da un set di immagini di macchine virtuali di Azure Marketplace pubblicate da Microsoft.
Immagini della Galleria di Calcolo di Azure - Scegli dalle immagini delle tue Azure Compute Galleries. È necessario assegnare il ruolo Lettore al Service Principal DevOpsInfrastructure per le immagini di Azure Compute Gallery che si desidera utilizzare. Per ulteriori informazioni, vedere come concedere l'accesso al ruolo di lettore all'entità servizio DevOpsInfrastructure.

Immagini di Azure Pipelines

I pool devOps gestiti offrono diverse immagini preconfigurate con lo stesso software degli agenti ospitati da Microsoft selezionati per Azure Pipelines.

Screenshot delle immagini di Azure Pipelines.

Per specificare un'immagine di Azure Pipelines, specificare l'alias dell'immagine usando la wellKnownImageName proprietà . Consulta un elenco degli alias predefiniti delle immagini di Azure Pipelines.

"images": [
    {
        "wellKnownImageName": "windows-2022"
    }
]

"images": [
    {
        "wellKnownImageName": "windows-2022"
    }
]

Ogni immagine include il software installato seguente.

Immagine	Software incluso
Azure Pipelines - Windows Server 2022	Software incluso
Azure Pipelines - Windows Server 2019	Software incluso
Azure Pipelines - Ubuntu 24.04	Software incluso
Azure Pipelines - Ubuntu 22.04	Software incluso
Azure Pipelines - Ubuntu 20.04	Software incluso

Importante

La creazione di nuovi pool con immagini del marketplace selezionate o immagini di Azure Pipelines con Ubuntu 20.04 verrà disabilitata a partire dal 1° giugno 2025, ma i pool esistenti in queste immagini continueranno a essere eseguiti fino al 1° luglio 2025.
Il 1° luglio 2025, i pool che utilizzano immagini selezionate di Ubuntu 20.04 dal marketplace o immagini di Azure Pipelines verranno disabilitati. Gli agenti che usano queste immagini non saranno in grado di effettuare il provisioning e le pipeline non potranno essere eseguite.

Per mantenere i pool di DevOps gestiti che attualmente usano Ubuntu 20.04 in esecuzione, aggiornare le immagini Ubuntu 20.04 a Ubuntu 22.04 o 24.04 (scelta consigliata). Per altre informazioni, vedere Scegliere l'immagine del pool. Se hai più immagini nel tuo pool, aggiorna gli alias per le immagini Ubuntu affinché le pipeline che richiedono Ubuntu vengano eseguite usando l'immagine desiderata.

Immagini del marketplace selezionate

I pool DevOps gestiti offrono un set di immagini di macchine virtuali di Azure Marketplace pubblicate da Microsoft curate per l'uso nei pool.

Screenshot delle immagini selezionate dal marketplace.

Scegliere Immagini del marketplace selezionate, scegliere l'immagine desiderata e scegliere la versione desiderata. Scegliere la versione più recente per usare sempre la versione più recente dell'immagine.

Per specificare un'immagine del marketplace selezionata, specificare l'ID risorsa dell'immagine usando la resourceId proprietà .

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/Publishers/canonical/ArtifactTypes/VMImage/Offers/ubuntu-24_04-lts/Skus/server/versions/latest"
    }
]

Per specificare l'immagine del marketplace selezionata, specificare l'ID risorsa dell'immagine usando la resourceId proprietà .

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/Publishers/canonical/ArtifactTypes/VMImage/Offers/ubuntu-24_04-lts/Skus/server/versions/latest"
    }
]

Importante

La creazione di nuovi pool con immagini del marketplace selezionate o immagini di Azure Pipelines con Ubuntu 20.04 verrà disabilitata a partire dal 1° giugno 2025, ma i pool esistenti in queste immagini continueranno a essere eseguiti fino al 1° luglio 2025.
Il 1° luglio 2025, i pool che utilizzano immagini selezionate del marketplace Ubuntu 20.04 o immagini di Azure Pipelines verranno disabilitati. Gli agenti che utilizzano queste immagini non prepareranno le risorse necessarie e le pipeline non verranno eseguite.

Per mantenere i pool di DevOps gestiti che attualmente usano Ubuntu 20.04 in esecuzione, aggiornare le immagini Ubuntu 20.04 a Ubuntu 22.04 o 24.04 (scelta consigliata). Per altre informazioni, vedere Scegliere l'immagine del pool. Se nel pool sono presenti più immagini, aggiorna i tuoi alias per le immagini Ubuntu affinché le pipeline che richiedono Ubuntu vengano eseguite con l'immagine desiderata.

Immagini di Azure Compute Gallery

Scegliere le immagini della Azure Compute Gallery per specificare un'immagine da qualsiasi Azure Compute Gallery disponibile nei tuoi abbonamenti. Sono supportate immagini generalizzate con i sistemi operativi seguenti.

Windows Server 2019
Windows Server 2022
Windows 11
Ubuntu 20.04
Ubuntu 22.04
Ubuntu 24.04
Debian 9
RHEL 8
RHEL 9
SUSE 12
SUSE 15

Importante

I pool DevOps gestiti supportano solo immagini generalizzate della raccolta di calcolo di Azure.

Screenshot delle immagini della Galleria di calcolo di Azure.

Per fornire un'immagine di Azure Compute Gallery, fornisci l'ID risorsa dell'immagine usando la proprietà resourceId.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/resource_group_placeholder/providers/Microsoft.Compute/galleries/my_images/images/Ubuntu2404"
    }
]

Per fornire un'immagine di Azure Compute Gallery, fornisci l'ID risorsa dell'immagine usando la proprietà resourceId.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/resource_group_placeholder/providers/Microsoft.Compute/galleries/my_images/images/Ubuntu2404"
    }
]

Concedere l'accesso al ruolo Lettore al Principal di Servizio DevOpsInfrastructure

Importante

Assegna il ruolo di Lettore all'entità servizio DevOpsInfrastructure per le immagini della Azure Compute Gallery che desideri utilizzare. Se si seleziona un'immagine dell'Azure Compute Gallery che non dispone di questo accesso configurato, la creazione del pool fallisce. È possibile assegnare il ruolo Lettore singolarmente a livello di immagine o a livello di raccolta immagini per tutte le immagini nella raccolta.

Passare alla risorsa desiderata nella portale di Azure. Per poter usare tutte le immagini in una raccolta, passare a Raccolta di calcolo di Azure nel portale di Azure. Per usare solo un'immagine specifica, passare a tale immagine.
Seleziona Controllo di accesso (IAM).
Selezionare Aggiungi>Aggiungi assegnazione di ruolo per aprire la pagina Aggiungi assegnazione di ruolo.
Assegnare il ruolo seguente. Per la procedura dettagliata, vedere Assegnare ruoli di Azure usando il portale di Azure.

Impostazione Valore

Ruolo Lettore

Assegna accesso a Principal del servizio

Membri Infrastruttura DevOps

Impostazione	Valore
Ruolo	Lettore
Assegna accesso a	Principal del servizio
Membri	Infrastruttura DevOps

Usare più immagini per pool con alias

Se nel pool sono presenti più immagini, è possibile configurare la pipeline di Azure DevOps per usare un'immagine specifica facendo riferimento a un alias per tale immagine.

Consiglio

Se le pipeline riscontrano problemi quando si aggiunge per la prima volta una nuova immagine al pool, controllare l'ordinamento delle immagini nell'elenco e prendere in considerazione l'uso di requisiti e alias per specificare esplicitamente quale immagine utilizzare per ogni pipeline.

Configurare gli alias di immagine

Per aggiungere e gestire alias di immagine, passare alla sezione Immagini delle impostazioni del pool e scegliere ..., Aggiungi alias.

Aggiungere gli alias desiderati all'elenco Alias e scegliere Salva.

Screenshot del pannello alias.

L'esempio seguente mostra un pool con due immagini di Azure Pipelines e un'immagine del marketplace selezionata. Le immagini di Azure Pipeline hanno gli alias predefiniti visualizzati e l'immagine del marketplace selezionata ha un singolo alias configurato denominato ubuntu-24.04-gen2.

Screenshot di un pool con più immagini con alias.

Per configurare gli alias, specificarli nell'elenco aliases . L'esempio seguente definisce un'immagine con un singolo alias denominato ubuntu-24.04-gen2.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
        "aliases": [
            "ubuntu-24.04-gen2"
        ]
    }
]

Per configurare gli alias, specificarli nell'elenco aliases . L'esempio seguente definisce un'immagine con un singolo alias denominato ubuntu-24.04-gen2.

"images": [
    {
        "resourceId": "/subscriptions/subscription_id_placeholder/Providers/Microsoft.Compute/Locations/eastus/publishers/canonical/artifacttypes/vmimage/offers/ubuntu-24_04-lts/skus/server/versions/latest",
        "aliases": [
            "ubuntu-24.04-gen2"
        ]
    }
]

Alias predefiniti delle immagini di Azure Pipelines

Oltre a tutti gli alias configurati, le immagini di Azure Pipelines hanno gli alias predefiniti seguenti.

Immagine di Azure Pipelines	Alias predefinito
Azure Pipelines - Windows Server 2022	`windows-2022`
Azure Pipelines - Windows Server 2019	`windows-2019`
Azure Pipelines - Ubuntu 24.04	`ubuntu-24.04`
Azure Pipelines - Ubuntu 22.04	`ubuntu-22.04`
Azure Pipelines - Ubuntu 20.04	`ubuntu-20.04`

Usare le richieste per specificare un'immagine

Se nel pool sono presenti più immagini, è possibile configurare una pipeline per l'esecuzione in un'immagine specifica usando una richiesta denominata ImageOverride. Quando si specifica la ImageOverride richiesta nella pipeline, i Pool DevOps Gestiti inviano il lavoro solo agli agenti che usano tale immagine.

Per eseguire una pipeline sull'immagine Ubuntu 24.04 dell'esempio precedente con un ubuntu-24.04-gen2 alias, specificare nella sezione pool della pipeline la seguente richiesta.

pool: 
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals ubuntu-24.04-gen2

Importante

Non inserire virgolette intorno al nome dell'alias nella ImageOverride richiesta, anche se ha spazi nel nome.

Per eseguire una pipeline usando un'immagine di Azure Pipelines nel pool, usare l'alias nella tabella precedente. Per eseguire una pipeline nell'immagine di Azure Pipelines Windows Server 2022 dell'esempio precedente, specificare il seguente requisito nella sezione della pipeline pool.

pool: 
  name: fabrikam-dev-pool # Name of Managed DevOps Pool
  demands:
  - ImageOverride -equals windows-2022

Vedi anche

Configurare le impostazioni del pool

Condividi tramite

Configurare le immagini dei pool gestiti di DevOps

Scegliere l'immagine del pool

Immagini di Azure Pipelines

Immagini del marketplace selezionate

Immagini di Azure Compute Gallery

Concedere l'accesso al ruolo Lettore al Principal di Servizio DevOpsInfrastructure

Usare più immagini per pool con alias

Configurare gli alias di immagine

Alias predefiniti delle immagini di Azure Pipelines

Usare le richieste per specificare un'immagine

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive