Creare una definizione di immagine e una versione dell'immagine

Attenzione

Questo articolo fa riferimento a CentOS, una distribuzione Linux prossima allo stato EOL (End of Life, fine del ciclo di vita). Prendere in considerazione l'uso e il piano di conseguenza. Per altre informazioni, vedere le linee guida per la fine della vita di CentOS.

Una raccolta di calcolo di Azure (in precedenza nota come Raccolta immagini condivise) semplifica la condivisione di immagini personalizzate nell'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.

Azure Compute Gallery consente di condividere le immagini di vm personalizzate con altri utenti dell'organizzazione, all'interno o tra aree, all'interno di un tenant di Microsoft Entra o pubblicamente usando una raccolta della community. 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 La raccolta di calcolo di Azure e non sono disponibili per le immagini gestite.

La funzionalità Raccolta di calcolo di Azure presenta più tipi di risorse:

Risorsa	Descrizione
Origine immagine	Si tratta di una risorsa che è possibile usare per creare una versione di immagine in una raccolta. Un'origine dell'immagine può essere una macchina virtuale di Azure esistente generalizzata o specializzata, un'immagine gestita, uno snapshot o una versione di immagine di un'altra raccolta.
Gallery	Come in Azure Marketplace, una raccolta è un repository per la gestione e la condivisione delle immagini e delle applicazioni di macchine virtuali, ma è possibile controllare 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. Questa include il fatto che l'immagine è per Windows o Linux, le note sulla versione e i 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 usa per creare una macchina virtuale quando si usa una raccolta. È 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.

Operazioni preliminari

Per completare questo articolo, è necessario avere una raccolta di calcolo di Azure esistente e un'origine per l'immagine disponibile in Azure. Le origini delle immagini possono essere:

• Una macchina virtuale nella sottoscrizione. È 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 dischi rigidi virtuali in un account di archiviazione.
• Altre versioni di immagini nella stessa raccolta o in un'altra raccolta nella stessa sottoscrizione.

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: MajorVersion.MinorVersion.Patch.

Quando si usa questo articolo, sostituire i nomi delle risorse, se 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 in Azure per la prima volta, verificare di aver preparato la VM.

Raccolta della community

Se si condivideranno le immagini usando una raccolta community, assicurarsi di creare la raccolta, le definizioni di immagini e le versioni delle immagini nella stessa area.

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:

Portale

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.

1. Passare alla portale di Azure, quindi cercare e selezionare Raccolta di calcolo di Azure.

2. Selezionare la raccolta da usare nell'elenco.

3. Nella pagina della raccolta selezionare Aggiungi nella parte superiore della pagina e quindi selezionare Definizione dell'immagine della macchina virtuale dall'elenco a discesa.

4. nella scheda Informazioni di base della pagina Aggiungi nuova definizione di immagine alla raccolta di calcolo di Azure selezionare un'area.

5. Per Nome definizione immagine, digitare un nome come myImageDefinition.

6. Per Sistema operativo selezionare l'opzione corretta in base all'origine.

7. Per la generazione di macchine virtuali, selezionare l'opzione in base all'origine. Nella maggior parte dei casi, sarà Gen 1. Per ulteriori informazioni, consultare Supporto per le macchine virtuali di seconda generazione.

8. In Stato del sistema operativo selezionare l'opzione in base all'origine. Per altre informazioni, vedere Generalizzato e specializzato.

9. Per Publisher digitare un nome univoco come myPublisher.

10. In Offerta digitare un nome univoco come myOffer.

11. Per SKU digitare un nome univoco, ad esempio mySKU.

12. Nella parte inferiore della pagina selezionare Rivedi e crea.

13. Dopo la convalida della definizione dell'immagine, selezionare Crea.

14. Una volta completata la distribuzione, selezionare Vai alla risorsa.

15. Nella pagina per la definizione dell'immagine, nella scheda Attività iniziali selezionare Crea una versione.

16. 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 negli elenchi a discesa successivi, provare a modificare l'area per l'immagine. È sempre possibile replicare l'immagine in altre aree in un secondo momento.

17. Per Numero di versione, digitare un numero come 1.0.0. Il nome della versione dell'immagine deve essere nel formato principale.secondaria.patch con numeri interi.

18. 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 snapshot	- Per Disco del sistema operativo selezionare il disco o lo snapshot dall'elenco a discesa. - Per aggiungere un disco dati, digitare il numero LUN e quindi selezionare il disco dati dall'elenco a discesa.
    Versione dell'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.
    Disco rigido virtuale in un account di archiviazione	Selezionare Sfoglia per scegliere l'account di archiviazione per il disco rigido virtuale.

19. 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.

20. Per Data di fine vita, selezionare una data dal calendario per quando si ritiene che questa versione non venga usata.

21. Nella scheda Replica selezionare il tipo di archiviazione nell'elenco a discesa.

22. Impostare il Numero di repliche predefinito, è possibile eseguire l'override di questa opzione per ogni area aggiunta.

23. È 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.

24. Al termine, selezionare Rivedi e crea. Azure convaliderà la configurazione.

25. Dopo la convalida della versione dell'immagine, selezionare Crea.

26. 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.

CLI

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 la macchina virtuale è stata generalizzata (usando waagent -deprovision per Linux o Sysprep per Windows), è necessario 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 la versione dell'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	Parameter Set
Disco del sistema operativo:
VM con l'ID macchina virtuale	--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 o disco gestito	--os-snapshot <Resource ID of the snapshot or managed disk>
Disco rigido virtuale 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 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 gli esempi az sig image-version create.

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 --managed-image 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 \
   --managed-image "/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_lrso con ridondanza della zona Archiviazione aggiungendo --storage-account-type standard_zrs quando si crea la versione dell'immagine.

PowerShell

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 dell'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	Parameter Set
Disco del sistema operativo
VM con l'ID macchina virtuale	-SourceImageId <Resource ID of the VM>
Immagine gestita o un'altra versione dell'immagine	-SourceImageId <Resource ID of the managed image or image version
Snapshot o disco gestito	-OSDiskImage <Resource ID of the snapshot or managed disk>
Disco dati
Snapshot 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 nell'archiviazione Premium aggiungendo -StorageAccountType Premium_LRSo con ridondanza della zona Archiviazione aggiungendo -StorageAccountType Standard_ZRS quando si crea la versione dell'immagine.

REST

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 origine, passare l'ID risorsa per l'origine, ad esempio passare 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 un'immagine in un tenant usando l'immagine di origine in un altro tenant

Nella sottoscrizione in cui è presente l'immagine di origine concedere autorizzazioni di lettura all'utente. Dopo che l'utente dispone dell'autorizzazione lettore per l'immagine di origine, accedere a entrambi gli account (origine e destinazione).

Sarà necessario l'oggetto tenantID dell'immagine di origine, l'oggetto subscriptionID per la sottoscrizione in cui verrà archiviata la nuova immagine (destinazione) e l'oggetto resourceID dell'immagine di origine.

CLI

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

# Login to the subscription where the new image will be created
az login

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

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

# Create the image
az sig image-version create `
   --gallery-image-definition myImageDef `
   --gallery-image-version 1.0.0 `
   --gallery-name myGallery `
   --resource-group myResourceGroup `
   --image-version $sourceImageID

PowerShell

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

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

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

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

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.