Een installatiekopieëndefinitie en een installatiekopieënversie maken

Artikel
10/18/2023

Let op

In dit artikel wordt verwezen naar CentOS, een Linux-distributie die de status End Of Life (EOL) nadert. Houd rekening met uw gebruik en plan dienovereenkomstig. Zie de Richtlijnen voor het einde van de levensduur van CentOS voor meer informatie.

Een Azure Compute Gallery (voorheen bekend als Shared Image Gallery) vereenvoudigt het delen van aangepaste installatiekopieën in uw organisatie. Aangepaste installatiekopieën zijn soortgelijk aan Marketplace-installatiekopieën, maar u kunt deze zelf maken. Installatiekopieën kunnen worden gemaakt op basis van een VM, VHD, momentopname, beheerde installatiekopie of een andere versie van de installatiekopie.

Met de Azure Compute Gallery kunt u uw aangepaste VM-installatiekopieën delen met anderen in uw organisatie, binnen of in verschillende regio's, binnen een Microsoft Entra-tenant of openbaar met behulp van een communitygalerie. U kunt kiezen welke installatiekopieën u wilt delen, in welke regio’s u ze beschikbaar wilt maken en met wie u ze wilt delen. U kunt meerdere galerieën maken, zodat u afbeeldingen logisch kunt groeperen. Veel nieuwe functies, zoals ARM64, Versneld netwerken en TrustedVM, worden alleen ondersteund via azure Compute Gallery en niet beschikbaar voor beheerde installatiekopieën.

De functie Azure Compute Gallery heeft meerdere resourcetypen:

Bron	Beschrijving
Bron van installatiekopie	Dit is een resource die kan worden gebruikt voor het maken van een installatiekopieënversie in een galerie. Een bron van een installatiekopie kan een bestaande Virtuele Azure-machine zijn die gegeneraliseerd of gespecialiseerd is, een beheerde installatiekopie, een momentopname of een versie van een installatiekopie in een andere galerie.
Galerij	Net als bij Azure Marketplace is een galerie een opslagplaats voor het beheren en delen van installatiekopieën en VM-toepassingen, maar u bepaalt wie er toegang heeft.
Definitie van installatiekopie	Definities van installatiekopieën worden in een galerie gemaakt en bevatten informatie over de installatiekopie en de vereisten voor intern gebruik. Dit houdt ook in of het om een Windows- of Linux-installatiekopie gaat. Daarnaast bevat de definitie releaseopmerkingen en de minimale en maximale geheugenvereisten. Het is een definitie van een type installatiekopie.
Versie van installatiekopieën	U gebruikt een versie van een installatiekopie om een VM te maken wanneer u een galerie gebruikt. U kunt net zo veel versies van een installatiekopie voor uw omgeving gebruiken als u nodig hebt. Net als bij een beheerde installatiekopie, wanneer u een versie van een installatiekopie gebruikt om een VM te maken, wordt de versie van de installatiekopie gebruikt voor het maken van nieuwe schijven voor de VM. Versies van installatiekopieën kunnen meerdere keren worden gebruikt.

Voordat u begint

Als u dit artikel wilt voltooien, moet u een bestaande Azure Compute Gallery en een bron hebben voor uw installatiekopieën die beschikbaar zijn in Azure. Afbeeldingsbronnen kunnen het volgende zijn:

Een VIRTUELE machine in uw abonnement. U kunt een installatiekopieën vastleggen van zowel gespecialiseerde als gegeneraliseerde VM's.
Een beheerde installatiekopieën,
Beheerd besturingssysteem en gegevensschijven.
Besturingssysteem- en gegevensschijven als VHD's in een opslagaccount.
Andere versies van installatiekopieën in dezelfde galerie of een andere galerie in hetzelfde abonnement.

Als de installatiekopieën gegevensschijven bevatten, mag de grootte van de gegevensschijf niet groter zijn dan 1 TB.

Namen van installatiekopiedefinities kunnen bestaan uit hoofdletters, kleine letters, cijfers, streepjes en punten. Zie Installatiekopiedefinities voor meer informatie over de waarden die u kunt specificeren voor een installatiekopiedefinitie.

Toegestane tekens voor de versie van de installatiekopieën zijn getallen en punten. Cijfers moeten binnen het bereik van een 32-bits geheel getal zijn. Indeling: MajorVersion.MinorVersion.Patch.

Wanneer u dit artikel doorloopt, vervangt u waar nodig de resourcenamen.

Voor gegeneraliseerde installatiekopieën raadpleegt u de specifieke richtlijnen voor het besturingssysteem voordat u de installatiekopieën vastlegt:

Linux
- Algemene stappen
- CentOS
- Debian
- Flatcar
- Freebsd
- Oracle Linux
- Openbsd
- Red Hat
- SUSE
- Ubuntu
Windows

Als u Sysprep voor het eerst naar Azure wilt uploaden voordat u uw virtuele harde schijf (VHD) uploadt, moet u ervoor zorgen dat u uw virtuele machine hebt voorbereid.

Community-galerie

Als u uw afbeeldingen gaat delen met behulp van een communitygalerie, moet u ervoor zorgen dat u uw galerie, definities van installatiekopieën en installatiekopieën in dezelfde regio maakt.

Wanneer gebruikers zoeken naar afbeeldingen in de communitygalerie, wordt alleen de meest recente versie van een installatiekopieën weergegeven.

Belangrijk

Informatie uit uw afbeeldingsdefinities is openbaar beschikbaar, zoals wat u opgeeft voor Publiceren, Aanbieden en SKU.

Een installatiekopie maken

Kies hieronder een optie voor het maken van uw installatiekopieëndefinitie en installatiekopieënversie:

Zie Een installatiekopieën van een VIRTUELE machine vastleggen in de portal om een installatiekopieën van een virtuele machine te maken.

Volg deze stappen om een installatiekopieën te maken met een andere bron dan een VIRTUELE machine.

Ga naar Azure Portal en zoek en selecteer Azure Compute Gallery.
Selecteer de galerie die u wilt gebruiken in de lijst.
Selecteer Op de pagina voor uw galerie de optie Toevoegen boven aan de pagina en selecteer vervolgens vm-installatiekopieën in de vervolgkeuzelijst.
selecteer een regio op de pagina Nieuwe afbeeldingsdefinitie toevoegen aan de Azure Compute-galerie op het tabblad Basisbeginselen.
Typ een naam als myImageDefinition voor de naam van de definitie van de installatiekopie.
Voor het besturingssysteem selecteert u de juiste optie op basis van uw bron.
Selecteer voor het genereren van vm's de optie op basis van uw bron. In de meeste gevallen is dit Gen 1. Zie Ondersteuning voor VM's van de tweede generatie voor meer informatie.
Selecteer voor de status van het besturingssysteem de optie op basis van uw bron. Zie Gegeneraliseerde en gespecialiseerde informatie voor meer informatie.
Voor Publisher typt u een unieke naam, zoals myPublisher.
Voor Offer typt u een unieke naam zoals myOffer.
Voor SKU typt u een unieke naam, zoals mySKU.
Selecteer Onder aan de pagina De optie Controleren en maken.
Nadat de definitie van de installatiekopieën is gevalideerd, selecteert u Maken.
Nadat de implementatie klaar is, selecteert u Ga naar resource.
Selecteer een versie maken op de pagina voor de definitie van de installatiekopieën op het tabblad Aan de slag.
Selecteer in Regio de regio waar u de installatiekopieën wilt maken. In sommige gevallen moet de bron zich in dezelfde regio bevinden als waar de installatiekopieën worden gemaakt. Als u de bron niet in latere vervolgkeuzelijsten ziet staan, wijzigt u de regio voor de afbeelding. U kunt de installatiekopieën later altijd repliceren naar andere regio's.
Voor versienummer typt u een getal zoals 1.0.0. De naam van de installatiekopieënversie moet de primaire naam volgen.minor.patchindeling met gehele getallen.

Selecteer in De bron het type bestand dat u voor uw bron gebruikt in de vervolgkeuzelijst. Zie de onderstaande tabel voor specifieke details voor elk brontype.

Bron	Andere velden
Schijven of momentopnamen	- Selecteer voor de besturingssysteemschijf de schijf of momentopname in de vervolgkeuzelijst. - Als u een gegevensschijf wilt toevoegen, typt u het LUN-nummer en selecteert u vervolgens de gegevensschijf in de vervolgkeuzelijst.
Versie van installatiekopie	- Selecteer de brongalerie in de vervolgkeuzelijst. - Selecteer de juiste afbeeldingsdefinitie in de vervolgkeuzelijst. - Selecteer de bestaande versie van de installatiekopieën die u wilt gebruiken in de vervolgkeuzelijst.
Beheerde installatiekopie	Selecteer de bronafbeelding in de vervolgkeuzelijst. De beheerde installatiekopieën moeten zich in dezelfde regio bevinden die u hebt gekozen in exemplaardetails.
VHD in een opslagaccount	Selecteer Bladeren om het opslagaccount voor de VHD te kiezen.

Laat in Uitsluiten van de meest recente waarde de standaardwaarde Nee staan, tenzij u niet wilt dat deze versie wordt gebruikt bij het maken van een virtuele machine latest in plaats van een versienummer.
Voor de einddatum van de levensduur selecteert u een datum in de kalender voor wanneer u denkt dat deze versie niet meer moet worden gebruikt.
Selecteer op het tabblad Replicatie het opslagtype in de vervolgkeuzelijst.
Stel het standaardaantal replica's in. U kunt dit overschrijven voor elke regio die u toevoegt.
U moet repliceren naar de bronregio, dus de eerste replica in de lijst bevindt zich in de regio waarin u de installatiekopieën hebt gemaakt. U kunt meer replica's toevoegen door de regio in de vervolgkeuzelijst te selecteren en het aantal replica's zo nodig aan te passen.
Als u klaar bent, selecteert u Beoordelen en maken. Azure valideert de configuratie.
Wanneer de versie van de installatiekopieën is gevalideerd, selecteert u Maken.
Nadat de implementatie klaar is, selecteert u Ga naar resource.

Het kan even duren om de installatiekopie naar alle doelregio's te repliceren.

U kunt ook vanuit de portal een bestaande VIRTUELE machine vastleggen als een installatiekopieën. Zie Een installatiekopieën van een virtuele machine maken in de portal voor meer informatie.

Definities van installatiekopieën maken een logische groepering voor installatiekopieën. Die worden gebruikt voor het beheren van informatie over de installatiekopieversies die daarbinnen worden gemaakt.

Maak een definitie van een installatiekopieën in een galerie met behulp van az sig image-definition create. Controleer of uw installatiekopiedefinitie het juiste type heeft. Als u de VIRTUELE machine (voor waagent -deprovision Linux of Sysprep voor Windows) hebt gegeneraliseerd, moet u een gegeneraliseerde installatiekopieëndefinitie maken met behulp van --os-state generalized. Als u de VM wilt gebruiken zonder bestaande gebruikersaccounts te verwijderen, maakt u een gespecialiseerde installatiekopiedefinitie met behulp van --os-state specialized.

Zie Afbeeldingsdefinities voor meer informatie over de parameters die u kunt opgeven voor een installatiekopieëndefinitie.

In dit voorbeeld heeft de definitie van de installatiekopie de naam myImageDefinition en is deze voor een gespecialiseerde installatiekopie van een Linux-besturingssysteem. Als u een definitie wilt maken voor installatiekopieën met een Windows-besturingssysteem, gebruikt u --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

Notitie

Voor installatiekopieën die afbeeldingen bevatten die afstammen van marketplace-installatiekopieën van derden, moeten de plangegevens exact overeenkomen met de plangegevens van de installatiekopieën van derden. Neem de plangegevens op in de definitie van de installatiekopieën door toe te voegen --plan-name, --plan-producten --plan-publisher wanneer u de definitie van de installatiekopieën maakt.

De versie van de installatiekopieën maken

Maak een installatiekopieënversie met az sig image version create.

De syntaxis voor het maken van de afbeelding wordt gewijzigd, afhankelijk van wat u als bron gebruikt. U kunt de brontypen combineren, zolang u maar één besturingssysteembron hebt. U kunt ook verschillende bronnen voor elke gegevensschijf hebben.

Bron	Parameterset
Besturingssysteemschijf:
VM met behulp van de VM-id	`--managed-image <Resource ID of the VM>`
Beheerde installatiekopieën of een andere versie van de installatiekopieën	`--managed-image <Resource ID of the managed image or image version`
Momentopname of beheerde schijf	`--os-snapshot <Resource ID of the snapshot or managed disk>`
VHD in een opslagaccount	`--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>`.
Gegevensschijf:
Momentopname of beheerde schijf	`--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>`
VHD in een opslagaccount	`--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>`

Zie de voorbeelden van az sig image-version create voor gedetailleerde voorbeelden van het opgeven van verschillende bronnen voor uw installatiekopie.

In het onderstaande voorbeeld maken we een installatiekopieën van een VIRTUELE machine. De versie van onze installatiekopieën is 1.0.0 en we gaan 2 replica's maken in de regio VS - west-centraal, 1 replica in de regio VS - zuid-centraal en 1 replica in de regio VS - oost 2 met zone-redundante opslag. De replicatieregio’s moeten de regio omvatten waarin de bron-VM zich bevindt.

Het is een best practice om de toewijzing van de VIRTUELE machine te stoppen\ongedaan te maken voordat u een installatiekopieën maakt.

Vervang de waarde van --managed-image in dit voorbeeld door de id van uw VIRTUELE machine.

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"

Notitie

U moet wachten tot de installatiekopieversie volledig is gebouwd en gerepliceerd voordat u dezelfde beheerde installatiekopie kunt gebruiken om een andere versie van de installatiekopie te maken.

U kunt uw installatiekopieën ook opslaan in Premium-opslag door zone-redundante opslag toe te voegen door toe te voegen --storage-account-type premium_lrs--storage-account-type standard_zrs wanneer u de versie van de installatiekopieën maakt.

Definities van installatiekopieën maken een logische groepering voor installatiekopieën. Zorg ervoor dat bij het maken van de definitie van de installatiekopieën alle juiste informatie bevat. Als u de bron-VM hebt gegeneraliseerd , moet u een definitie van de installatiekopieën maken met behulp van -OsState generalized. Als u de bron niet hebt gegeneraliseerd, maakt u een definitie van de installatiekopieën met behulp van -OsState specialized.

Zie Installatiekopiedefinities voor meer informatie over de waarden die u kunt specificeren voor een installatiekopiedefinitie.

Maak de definitie van de installatiekopie met behulp van New-AzGalleryImageDefinition.

In dit voorbeeld heet de definitie van de installatiekopie myImageDefinition en is deze voor een gespecialiseerde VM met Windows. Als u een definitie wilt maken voor installatiekopieën met Linux, gebruikt u -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'

Notitie

Voor installatiekopieën die afbeeldingen bevatten die afstammen van installatiekopieën van derden, moeten de plangegevens exact overeenkomen met de plangegevens van de installatiekopieën van derden. Neem de plangegevens op in de definitie van de installatiekopieën door toe te voegen -PurchasePlanName, -PurchasePlanProducten -PurchasePlanPublisher wanneer u de definitie van de installatiekopieën maakt.

Een installatiekopieënversie maken

Maak een installatiekopieversie met new-AzGalleryImageVersion.

De syntaxis voor het maken van de afbeelding wordt gewijzigd, afhankelijk van wat u als bron gebruikt.

Bron	Parameterset
Besturingssysteemschijf
VM met behulp van de VM-id	`-SourceImageId <Resource ID of the VM>`
Beheerde installatiekopieën of een andere versie van de installatiekopieën	`-SourceImageId <Resource ID of the managed image or image version`
Momentopname of beheerde schijf	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Gegevensschijf
Momentopname of beheerde schijf	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

In het onderstaande voorbeeld maken we een installatiekopieënversie van een VIRTUELE machine. Het is een best practice om de toewijzing van de VIRTUELE machine te stoppen\ongedaan te maken voordat u een installatiekopieën maakt met behulp van Stop-AzVM.

In dit voorbeeld is versie 1.0.0 van de installatiekopieën en wordt deze gerepliceerd naar datacenters vs - west-centraal en VS - zuid-centraal. Wanneer u doelregio's kiest voor replicatie, moet u ook de bronregio opnemen als doel voor replicatie.

   $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

Het kan even duren voordat de installatiekopie wordt gerepliceerd naar alle doelregio's, zodat we een taak hebben gemaakt, zodat we de voortgang kunnen bijhouden. Als u de voortgang van de taak wilt zien, typt $job.Stateu .

$job.State

Notitie

U moet wachten tot de installatiekopieversie volledig is gebouwd en gerepliceerd voordat u dezelfde beheerde installatiekopie kunt gebruiken om een andere versie van de installatiekopie te maken.

U kunt uw installatiekopieën ook opslaan in Premium-opslag door zone-redundante opslag toe te voegen door toe te voegen -StorageAccountType Premium_LRS-StorageAccountType Standard_ZRS wanneer u de versie van de installatiekopieën maakt.

Een installatiekopieëndefinitie maken met behulp van de REST API

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",
    },
}

Maak een installatiekopieënversie met behulp van de REST API. In dit voorbeeld maken we een installatiekopieënversie van een VIRTUELE machine. Als u een andere bron wilt gebruiken, geeft u de resource-id voor de bron door (geef bijvoorbeeld de id van de momentopname van de besturingssysteemschijf door).

# @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}"
            }
        }
    }
}

Een installatiekopieën in de ene tenant maken met behulp van de broninstallatiekopieën in een andere tenant

In het abonnement waarin de broninstallatiekopieën zich bevinden, verleent u lezermachtigingen aan de gebruiker. Zodra de gebruiker leesmachtigingen heeft voor de broninstallatiekopieën, meldt u zich aan bij beide accounts (bron en doel).

U hebt de tenantID broninstallatiekopieën nodig, het subscriptionID abonnement waarin de nieuwe installatiekopieën worden opgeslagen (doel) en de resourceID broninstallatiekopieën.

CLI
Powershell

# 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

# 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

Volgende stappen

Zie Informatie over het leveren van aankoopplangegevens voor Azure Marketplace bij het maken van installatiekopieën.

Een installatiekopieëndefinitie en een installatiekopieënversie maken

Voordat u begint

Community-galerie

Een installatiekopie maken

Een installatiekopieën in de ene tenant maken met behulp van de broninstallatiekopieën in een andere tenant

Volgende stappen

Aanvullende resources