Creare una definizione di immagine e una versione dell'immagine

La Azure Compute Gallery semplifica la condivisione di immagini personalizzate all'interno dell'organizzazione. Le immagini personalizzate sono come le immagini di marketplace, ma si possono creare autonomamente. Le immagini possono essere create da una macchina virtuale, un disco rigido virtuale, uno snapshot, un'immagine gestita o un'altra versione dell'immagine.

La Raccolta di Calcolo di Azure consente di condividere le immagini di VM personalizzate con altri utenti dell'organizzazione, all'interno o tra diverse aree geografiche, all'interno di un tenant Microsoft Entra o pubblicamente usando una raccolta comunitaria. Scegliere le immagini che si intende condividere, le aree nelle quali si vuole renderle disponibili e i destinatari. È possibile creare più raccolte così da raggruppare in maniera logica le immagini. Molte nuove funzionalità come ARM64, Rete accelerata e TrustedVM sono supportate solo tramite Azure Raccolta di calcolo e non disponibili per le immagini gestite.

La funzione Azure Compute Gallery include più tipi di risorse:

Risorsa	Descrizione
Fonte immagine	Si tratta di una risorsa che è possibile usare per creare una versione immagine in una galleria. La sorgente di un'immagine può essere una macchina virtuale Azure preesistente generalizzata o specializzata, un'immagine gestita, uno snapshot o una versione immagine in un'altra raccolta.
Gallery	Analogamente al Azure Marketplace, un gallery è un repository per la gestione e la condivisione di immagini e applicazioni VM, ma si controlla chi ha accesso.
Definizione delle immagini	Le definizioni di immagini vengono create all'interno di una raccolta e forniscono informazioni sull'immagine e sui requisiti per il relativo uso interno. Ciò include se l'immagine è Windows o Linux, note sulla versione e requisiti minimi e massimi di memoria. Si tratta della definizione di un tipo di immagine.
Versione dell'immagine	La versione dell'immagine è ciò che si utilizza per creare una macchina virtuale quando si utilizza una raccolta di immagini. È possibile avere più versioni di un'immagine in base alle necessità del proprio ambiente. Come un'immagine gestita, quando si usa una versione dell'immagine per creare una macchina virtuale, la versione dell'immagine viene usata per creare nuovi dischi per la macchina virtuale. Le versioni delle immagini possono essere usate più volte.

Prerequisiti

Per completare questo articolo, è necessario avere una Azure Compute Gallery esistente e un'origine dell'immagine che sia disponibile in Azure. Le origini delle immagini possono essere:

Una macchina virtuale nel tuo abbonamento. È possibile acquisire un'immagine da macchine virtuali specializzate e generalizzate .
Immagine gestita,
Sistemi operativi gestiti e dischi dati.
Dischi del sistema operativo e dati come VHD in un account di archiviazione.
Altre versioni di immagini nella stessa galleria o in un'altra galleria nello stesso abbonamento.

Se l'immagine conterrà dischi dati, le dimensioni del disco dati non possono essere superiori a 1 TB.

I nomi delle definizioni di immagini possono essere costituiti da lettere maiuscole o minuscole, numeri, trattini e punti. Per altre informazioni sui valori che è possibile specificare per la definizione di immagine, vedere Definizioni di immagini.

I caratteri consentiti per la versione dell'immagine sono numeri e punti. I numeri devono essere compresi nell'intervallo di un valore Integer a 32 bit. Formato: VersionePrincipale.VersioneSecondaria.Patch.

Quando si utilizza questo articolo, sostituire i nomi delle risorse, dove necessario.

Per le immagini generalizzate , vedere le linee guida specifiche del sistema operativo prima di acquisire l'immagine:

Linux
- Passaggi generici
- CentOS
- Debian
- Flatcar
- FreeBSD
- Oracle Linux
- OpenBSD
- Red Hat
- SUSE
- Ubuntu
Windows

Se si prevede di eseguire Sysprep prima di caricare il disco rigido virtuale (VHD) in Azure per la prima volta, assicurarsi di avere preparato la macchina virtuale.

Galleria della community

Se condividerai le immagini usando una galleria della community, assicurati di creare la tua galleria, le definizioni delle immagini e le versioni delle immagini nella stessa regione.

Quando gli utenti cercano immagini della raccolta community, viene visualizzata solo la versione più recente di un'immagine.

Importante

Le informazioni delle definizioni di immagine saranno disponibili pubblicamente, ad esempio le informazioni fornite per Pubblica, Offerta e SKU.

Creare un'immagine

Scegliere un'opzione seguente per creare la definizione dell'immagine e la versione dell'immagine:

Per creare un'immagine da una macchina virtuale nel portale, vedere Acquisire un'immagine di una macchina virtuale.

Per creare un'immagine usando un'origine diversa da una macchina virtuale, seguire questa procedura.

Andare al portale Azure, quindi cercare e selezionare Azure Compute Gallery.
Selezionare la raccolta da usare dall'elenco.
Nella pagina della raccolta, selezionare Aggiungi nella parte superiore della pagina e quindi selezionare Definizione immagine VM dal menu a discesa.
nella pagina Aggiungi nuova definizione di immagine alla Azure Compute Gallery nella scheda Di base selezionare una Regione.
Per Nome definizione immagine, digitare un nome come myImageDefinition.
Per Sistema operativo selezionare l'opzione corretta in base all'origine.
Per la generazione di macchine virtuali, selezionare l'opzione in base alla sorgente. Nella maggior parte dei casi, sarà Gen 1. Per ulteriori informazioni, consultare Supporto per le macchine virtuali di seconda generazione.
Per lo Stato del sistema operativo, selezionare l'opzione in base alla tua sorgente. Per altre informazioni, vedere Generalizzato e specializzato.
Per Publisher digitare un nome univoco, ad esempio myPublisher.
In Offerta digitare un nome univoco come myOffer.
Per SKU digitare un nome univoco, ad esempio mySKU.
Nella parte inferiore della pagina selezionare Rivedi e crea.
Dopo la convalida della definizione dell'immagine, selezionare Crea.
Una volta completata la distribuzione, selezionare Vai alla risorsa.
Nella pagina per la definizione dell'immagine, nella scheda Attività iniziali selezionare Crea una versione.
In Area selezionare l’area in cui collocare l'immagine creata. In alcuni casi, l'origine deve trovarsi nella stessa area in cui viene creata l'immagine. Se l'origine non viene visualizzata nei menu a discesa successivi, provare a modificare la regione per l'immagine. È sempre possibile replicare l'immagine in altre aree in un secondo momento.
Per Numero di versione, digitare un numero come 1.0.0. Il nome della versione dell'immagine deve essere nel formato versione principale.versione secondaria.patch con numeri interi.

In Origine selezionare il tipo di file usato per l'origine dall'elenco a discesa. Per informazioni dettagliate specifiche per ogni tipo di origine, vedere la tabella seguente.

Origine	Altri campi
Dischi o istantanee	- Per Disco del sistema operativo selezionare il disco o lo snapshot dal menu a tendina. - Per aggiungere un disco dati, digitare il numero LUN e quindi selezionare il disco dati dall'elenco a discesa.
Versione immagine	- Selezionare la Raccolta di origine dall'elenco a discesa. - Selezionare la definizione di immagine corretta dall'elenco a discesa. - Selezionare la versione dell'immagine esistente che si vuole usare dall'elenco a discesa.
Immagine gestita	- Selezionare l'Immagine di origine dall'elenco a discesa. L'immagine gestita deve trovarsi nella stessa area scelta in Dettagli dell'istanza.
VHD in un account di archiviazione	Selezionare Sfoglia per scegliere l'account di archiviazione per il disco rigido virtuale.

In Escludi dalla versione più recente lasciare il valore predefinito No a meno che non si voglia usare questa versione durante la creazione di una macchina virtuale usando latest anziché un numero di versione.
Per Data di fine vita, selezionare una data dal calendario per quando si ritiene che questa versione non venga usata.
Nella scheda Replica selezionare il tipo di archiviazione nell'elenco a discesa.
Impostare il Numero di repliche predefinito, è possibile eseguire l'override di questa opzione per ogni area aggiunta.
È necessario eseguire la replica nell'area di origine, quindi la prima replica nell'elenco si troverà nell'area in cui è stata creata l'immagine. È possibile aggiungere altre repliche selezionando l'area nell'elenco a discesa e modificando il numero di repliche in base alle esigenze.
Al termine, selezionare Rivedi e crea. Azure convaliderà la configurazione.
Dopo la convalida della versione dell'immagine, selezionare Crea.
Una volta completata la distribuzione, selezionare Vai alla risorsa.

La replica dell'immagine in tutte le aree di destinazione può richiedere tempo.

È anche possibile acquisire una macchina virtuale esistente come immagine dal portale. Per altre informazioni, vedere Creare un'immagine di una macchina virtuale nel portale.

Per creare un'immagine usando il interfaccia della riga di comando di Azure, è prima necessario creare una definizione di immagine. Le definizioni di immagini creano un raggruppamento logico per le immagini. Vengono usate per gestire le informazioni sulle versioni di immagini create al loro interno.

Creare una definizione di immagine in una raccolta usando az sig image-definition create. Assicurarsi che la definizione di immagine sia del tipo corretto. Se hai generalized la macchina virtuale (usando waagent -deprovision per Linux o Sysprep per Windows), dovresti creare una definizione di immagine generalizzata usando --os-state generalized. Se si vuole usare la VM senza rimuovere gli account utente esistenti, creare una definizione di immagine specializzata usando --os-state specialized.

Per altre informazioni sui parametri che è possibile specificare per una definizione di immagine, vedere Definizioni di immagini.

In questo esempio la definizione di immagine è denominata myImageDefinition ed è relativa a un'immagine specializzata del sistema operativo Linux. Per creare una definizione per le immagini usando un sistema operativo Windows, usare --os-type Windows.

az sig image-definition create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --publisher myPublisher \
   --offer myOffer \
   --sku mySKU \
   --os-type Linux \
   --os-state specialized

Nota

Per le definizioni di immagine che conterranno immagini discendenti da immagini del marketplace di terze parti, le informazioni sul piano devono corrispondere esattamente alle informazioni sul piano dell'immagine di terze parti. Includere le informazioni sul piano nella definizione dell'immagine aggiungendo --plan-name, --plan-producte --plan-publisher quando si crea la definizione dell'immagine.

Creare una versione di immagine

Creare una versione dell'immagine usando az sig image version create.

La sintassi per la creazione dell'immagine cambierà, a seconda di ciò che si usa come origine. È possibile combinare i tipi di origine, purché si disponga di una sola origine del sistema operativo. È anche possibile avere origini diverse per ogni disco dati.

Origine	Set di parametri
Disco del sistema operativo:
VM con l'ID VM	`--managed-image <Resource ID of the VM>`
Immagine gestita o un'altra versione dell'immagine	`--managed-image <Resource ID of the managed image or image version`
Snapshot oppure disco gestito	`--os-snapshot <Resource ID of the snapshot or managed disk>`
Disco rigido virtuale (VHD) in un account di archiviazione	`--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>`.
Disco dati:
Snapshot o disco gestito	`--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>`
Disco rigido virtuale (VHD) in un account di archiviazione	`--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>`

Per esempi dettagliati su come specificare origini diverse per l'immagine, vedere la documentazione "az sig image-version create examples".

Nell'esempio seguente viene creata un'immagine da una macchina virtuale. La versione dell'immagine è 1.0.0 e verranno create 2 repliche nell'area Stati Uniti centro-occidentali, 1 replica nell'area Stati Uniti centro-meridionali e 1 replica nell'area Stati Uniti orientali 2 usando l'archiviazione con ridondanza della zona. Le aree di replica devono includere l'area in cui si trova la macchina virtuale di origine.

È consigliabile arrestare o deallocare la macchina virtuale prima di creare un'immagine.

Sostituire il valore di --virtual-machine in questo esempio con l'ID della macchina virtuale.

az sig image-version create \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --target-regions "westcentralus" "southcentralus=1" "eastus=1=standard_zrs" \
   --replica-count 2 \
   --virtual-machine "/subscriptions/<Subscription ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"

Nota

È necessario attendere che la creazione della versione dell'immagine venga interamente completata e replicata prima di poter usare la stessa immagine gestita o creare un'altra versione di immagine.

È anche possibile archiviare l'immagine nell'archiviazione Premium aggiungendo --storage-account-type premium_lrs, o nell'Archiviazione Ridondante tra Zone aggiungendo --storage-account-type standard_zrs quando si crea la versione dell'immagine.

Per creare un'immagine usando PowerShell, è prima necessario creare una definizione di immagine. Le definizioni di immagini creano un raggruppamento logico per le immagini. Quando si crea la definizione dell'immagine, assicurarsi che contenga tutte le informazioni corrette. Se la macchina virtuale di origine è stata generalizzata , è necessario creare una definizione di immagine usando -OsState generalized. Se l'origine non è stata generalizzata, creare una definizione di immagine usando -OsState specialized.

Per altre informazioni sui valori che è possibile specificare per la definizione di immagine, vedere Definizioni di immagini.

Per creare la definizione di immagine, usare New-AzGalleryImageDefinition.

In questo esempio la definizione dell'immagine è denominata myImageDefinition ed è per una macchina virtuale specializzata che esegue Windows. Per creare una definizione per le immagini usando Linux, usare -OsType Linux.

$imageDefinition = New-AzGalleryImageDefinition `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -Name 'myImageDefinition' `
   -OsState specialized `
   -OsType Windows `
   -Publisher 'myPublisher' `
   -Offer 'myOffer' `
   -Sku 'mySKU'

Nota

Per le definizioni di immagine che conterranno immagini discendenti da immagini di terze parti, le informazioni sul piano devono corrispondere esattamente alle informazioni di piano dell'immagine di terze parti. Includere le informazioni sul piano nella definizione dell'immagine aggiungendo -PurchasePlanName, -PurchasePlanProducte -PurchasePlanPublisher quando si crea la definizione dell'immagine.

Creare una versione di immagine

Creare una versione dell'immagine usando New-AzGalleryImageVersion.

La sintassi per la creazione dell'immagine cambierà, a seconda di ciò che si usa come origine.

Origine	Insieme di parametri
Disco del sistema operativo
VM con l'ID VM	`-SourceImageId <Resource ID of the VM>`
Immagine gestita o un'altra versione dell'immagine	`-SourceImageId <Resource ID of the managed image or image version`
Istantanea o disco gestito	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Disco dati
Istantanea o disco gestito	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

Nell'esempio seguente viene creata una versione dell'immagine da una macchina virtuale. È consigliabile arrestare o deallocare la macchina virtuale prima di creare un'immagine usando Stop-AzVM.

In questo esempio la versione dell'immagine è 1.0.0 e viene replicata nei datacenter degli Stati Uniti centro-occidentali e degli Stati Uniti centro-meridionali. Quando si scelgono le aree di destinazione per la replica, tenere presente che è necessario includere anche l'area di origine come destinazione per la replica.

   $region1 = @{Name='South Central US';ReplicaCount=1}
   $region2 = @{Name='East US';ReplicaCount=2}
   $targetRegions = @($region1,$region2)

$job = $imageVersion = New-AzGalleryImageVersion `
   -GalleryImageDefinitionName $imageDefinition.Name`
   -GalleryImageVersionName '1.0.0' `
   -GalleryName $gallery.Name `
   -ResourceGroupName $gallery.ResourceGroupName `
   -Location $gallery.Location `
   -TargetRegion $targetRegions  `
   -SourceImageId $sourceVm.Id.ToString() `
   -PublishingProfileEndOfLifeDate '2020-12-01' `  
   -asJob

Può essere necessario un po' di tempo per replicare l'immagine in tutte le aree di destinazione, per questo motivo Microsoft ha creato un processo in modo che sia possibile tenere traccia dello stato di avanzamento. Per visualizzare lo stato di avanzamento del processo, digitare $job.State.

$job.State

Nota

È necessario attendere che la creazione della versione dell'immagine venga interamente completata e replicata prima di poter usare la stessa immagine gestita o creare un'altra versione di immagine.

È anche possibile archiviare l'immagine nello storage Premium aggiungendo -StorageAccountType Premium_LRS o nello Storage Ridondante su Zona aggiungendo -StorageAccountType Standard_ZRS quando si crea la versione dell'immagine.

Creare una definizione di immagine usando l'API REST

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}?api-version=2019-12-01

{
    "location": "eastus",
    "properties": {
        "hyperVGeneration": "V1",
        "identifier": {
            "offer": "myOffer",
            "publisher": "myPublisher",
            "sku": "mySKU"
        },
        "osState": "Specialized",
        "osType": "Linux",
    },
}

Creare una versione dell'immagine usando l'API REST. In questo esempio viene creata una versione dell'immagine da una macchina virtuale. Per usare un'altra sorgente, fornire l'ID della risorsa per la sorgente, ad esempio l'ID dello snapshot del disco del sistema operativo.

# @name imageVersion
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryDefinitionName}/versions/{galleryImageVersionName}?api-version=2019-12-01

{
    "location": "{region}",
    "properties": {
        "publishingProfile": {
            "endOfLifeDate": "2024-12-02T00:00:00+00:00",
            "replicaCount": 1,
            "storageAccountType": "Standard_ZRS",
            "targetRegions": [
                {
                    "name": "eastus",
                    "regionalReplicaCount": 2,
                    "storageAccountType": "Standard_LRS",
                },
                {
                    "name": "westus2",
                }
            ]
        },
        "storageProfile": {
            "source": {
                "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}"
            }
        }
    }
}

Creare una versione dell'immagine in un tenant usando la versione dell'immagine di origine in un altro tenant

Nella sottoscrizione in cui è presente la versione dell'immagine di origine concedere autorizzazioni di lettura all'utente. Una volta che l'utente ha ricevuto l'autorizzazione di lettura per la versione dell'immagine sorgente, accedere a entrambi gli account (origine e destinazione).

Sarà necessario avere a disposizione la tenantID versione dell'immagine di origine, la subscriptionID sottoscrizione dove verrà archiviata la nuova versione dell'immagine (destinazione), e la resourceID versione dell'immagine di origine. La definizione dell'immagine della raccolta di destinazione deve esistere già prima di creare la versione dell'immagine con az sig image-version create o New-AzGalleryImageVersion. Assicurarsi inoltre che l'area o la replica dell'immagine di origine e l'area di destinazione siano uguali.

CLI
PowerShell

Usare il interfaccia della riga di comando di Azure per creare una versione dell'immagine in un tenant usando la versione dell'immagine di origine in un altro tenant.

# Set some variables
tenantID="<tenant ID for the source image version>"
subID="<subscription ID where the image version will be created>"
sourceImageVersionID="<resource ID of the source image version>"

# Sign in to the subscription where the new image version will be created
az login

# Sign in to the tenant where the source image version is available
az login --tenant $tenantID

# Sign back in to the subscription where the image version will be created and ensure subscription context is set
az login
az account set --subscription $subID

# Create the image version from the source image version
az sig image-version create \
   --gallery-image-definition myImageDef \
   --gallery-image-version 1.0.0 \
   --gallery-name myGallery \
   --resource-group myResourceGroup \
   --image-version $sourceImageVersionID \
   --location myLocation

Usare PowerShell per creare una versione dell'immagine in un tenant usando la versione dell'immagine di origine in un altro tenant.

# Set variables
$targetSubID = "<subscription ID for the target>"
$sourceTenantID = "<tenant ID for the source image version>"
$sourceImageVersionID = "<resource ID of the source image version>"

# Sign in to the tenant where the source image version is published
Connect-AzAccount -Tenant $sourceTenantID -UseDeviceAuthentication

# Sign in to the subscription where the new image version will be created and set the context
Connect-AzAccount -UseDeviceAuthentication -Subscription $targetSubID
Set-AzContext -Subscription $targetSubID

# Create the image version from the source image version in a different tenant
New-AzGalleryImageVersion -ResourceGroupName myResourceGroup -GalleryName myGallery -GalleryImageDefinitionName myImageDef -Location "West US 2" -Name 1.0.0 -SourceImageId $sourceImageVersionID

Passaggi successivi

Per informazioni su come fornire informazioni sul piano di acquisto, vedere Fornire informazioni sul piano di acquisto di Azure Marketplace durante la creazione di immagini.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-04-10

Condividi tramite

Creare una definizione di immagine e una versione dell'immagine

Prerequisiti

Galleria della community

Creare un'immagine

Creare una versione dell'immagine in un tenant usando la versione dell'immagine di origine in un altro tenant

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive