Képdefiníció és képverzió létrehozása

Cikk
08/24/2024

Figyelemfelhívás

Ez a cikk az End Of Life (EOL) állapotú Linux-disztribúcióra, a CentOS-ra hivatkozik. Fontolja meg a használatát, és ennek megfelelően tervezze meg. További információ: CentOS End Of Life útmutató.

Az Azure Compute Gallery (korábbi nevén Megosztott képtár) leegyszerűsíti az egyéni képmegosztást a szervezeten belül. Az egyéni rendszerképek olyanok, mint a piactérről beszerzett rendszerképek, de Ön hozza azokat létre. A rendszerképek virtuális gépről, VHD-ről, pillanatképről, felügyelt rendszerképről vagy más képverzióról hozhatók létre.

Az Azure Compute Gallery lehetővé teszi egyéni virtuálisgép-rendszerképek megosztását a szervezet más tagjaival, a régiókon belül vagy régiók között, a Microsoft Entra-bérlőn belül, vagy nyilvánosan egy közösségi katalógus használatával. Adja meg, hogy mely képeket szeretné megosztani, mely régiókban szeretné elérhetővé tenni őket, és kivel szeretné megosztani őket. Több gyűjteményt is létrehozhat, hogy logikailag csoportosíthassa a képeket. Számos új funkció, például az ARM64, a gyorsított hálózatkezelés és a TrustedVM csak az Azure Compute Galleryben támogatott, felügyelt rendszerképekhez nem érhető el.

Az Azure Compute Gallery szolgáltatás több erőforrástípussal rendelkezik:

Erőforrás	Leírás
Kép forrása	Ez egy erőforrás, amellyel képverziót hozhat létre egy katalógusban. A rendszerképforrás lehet egy meglévő, általánosított vagy specializált Azure-beli virtuális gép, egy felügyelt rendszerkép, egy pillanatkép vagy egy másik katalógus képverziója.
Galéria	Az Azure Marketplace-hez hasonlóan a katalógusok is a rendszerképek és virtuálisgép-alkalmazások kezelésére és megosztására szolgáló adattárak, de Ön szabályozhatja, hogy ki rendelkezik hozzáféréssel.
Képdefiníció	A képdefiníciók egy katalógusban jönnek létre, és információkat tartalmaznak a képről és a belső használatra vonatkozó követelményekről. Ez magában foglalja, hogy a rendszerkép Windows vagy Linux, kibocsátási megjegyzések, valamint minimális és maximális memóriakövetelmények. Ez egy képtípus definíciója.
Kép verziója	A képverzióval virtuális gépet hozhat létre katalógus használata esetén. A rendszerképek igény szerint több verziójával is rendelkezhet a környezethez. A felügyelt lemezképekhez hasonlóan a rendszerképverzióval is létrehozhat új lemezeket a virtuális géphez. A képverziók többször is használhatók.

Mielőtt elkezdené

A cikk elvégzéséhez rendelkeznie kell egy meglévő Azure Compute Galleryvel és egy forrással a rendszerképhez az Azure-ban. A képforrások a következőek lehetnek:

Egy virtuális gép az előfizetésében. A rendszerképeket speciális és általánosított virtuális gépekről is rögzítheti.
Felügyelt rendszerkép,
Felügyelt operációs rendszer és adatlemezek.
Operációs rendszer és adatlemezek virtuális merevlemezként egy tárfiókban.
Más képverziók ugyanabban a katalógusban vagy egy másik katalógusban ugyanabban az előfizetésben.

Ha a lemezkép adatlemezeket fog tartalmazni, az adatlemez mérete nem lehet 1 TB-nál nagyobb.

A képdefiníciók neve lehet nagybetűből vagy kisbetűből, számjegyből, pontból, kötőjelből és pontból. A képdefiníciókhoz megadható értékekről további információt a Képdefiníciók című témakörben talál.

A képverzió megengedett karakterei számok és időszakok. A számoknak 32 bites egész számtartományon belül kell lenniük. Formátum: MajorVersion.MinorVersion.Javítás.

A cikk használatakor szükség esetén cserélje le az erőforrásneveket.

Általánosított képek esetén a rendszerkép rögzítése előtt tekintse meg az operációs rendszerre vonatkozó útmutatást:

Linux
- Általános lépések
- CentOS
- Debian
- Pőrekocsi
- FreeBSD
- Oracle Linux
- OpenBSD
- Red Hat
- SUSE
- Ubuntu
Windows

Ha először tervezi futtatni a Sysprepet, mielőtt feltöltené a virtuális merevlemezt (VHD-t) az Azure-ba, győződjön meg arról, hogy előkészítette a virtuális gépet.

Közösségi katalógus

Ha közösségi katalógus használatával osztja meg a képeket, győződjön meg arról, hogy ugyanabban a régióban hozza létre a katalógust, a képdefiníciókat és a képverziókat.

Amikor a felhasználók közösségi katalógusbeli képeket keresnek, csak a kép legújabb verziója jelenik meg.

Fontos

A képdefiníciókból származó információk nyilvánosan elérhetők lesznek, például a közzétételhez, az ajánlathoz és a termékváltozathoz megadott adatokhoz.

Rendszerkép létrehozása

Válasszon egy alábbi lehetőséget a képdefiníció és a képverzió létrehozásához:

Ha egy virtuális gépről szeretne képet létrehozni a portálon, olvassa el a virtuális gép képének rögzítése című témakört.

Ha nem virtuálisgép-forrásból szeretne lemezképet létrehozni, kövesse az alábbi lépéseket.

Nyissa meg az Azure Portalt, majd keresse meg és válassza ki az Azure Compute Galleryt.
Válassza ki a listából a használni kívánt gyűjteményt.
A katalógus lapján válassza a Hozzáadás lehetőséget a lap tetején, majd válassza ki a virtuálisgép-képdefiníciót a legördülő menüből.
az Új képdefiníció hozzáadása az Azure Compute Galleryhez lap Alapszintű beállítások lapján válasszon egy régiót.
Képdefiníció neveként írjon be egy nevet, például myImageDefinition.
Operációs rendszer esetén válassza ki a megfelelő lehetőséget a forrás alapján.
Virtuális gép létrehozása esetén válassza ki a forrás alapján a lehetőséget. A legtöbb esetben ez gen 1 lesz. További információ: 2. generációs virtuális gépek támogatása.
Az operációs rendszer állapota esetén válassza ki a lehetőséget a forrás alapján. További információ: Általános és specializált.
Publisher esetén írjon be egy egyedi nevet, például a myPublisher nevet.
Az Ajánlat mezőbe írjon be egy egyedi nevet, például a myOffer nevet.
Termékváltozat esetén írjon be egy egyedi nevet, például a mySKU-t.
A lap alján válassza a Véleményezés + létrehozás lehetőséget.
Miután a képdefiníció megfelelt az ellenőrzésnek, válassza a Létrehozás lehetőséget.
Ha az üzembe helyezés befejeződött, válassza az Ugrás az erőforráshoz lehetőséget.
A képdefiníció lap Első lépések lapján válassza a Verzió létrehozása lehetőséget.
A Régió területen válassza ki azt a régiót, ahol létre szeretné hozni a rendszerképet. Bizonyos esetekben a forrásnak ugyanabban a régióban kell lennie, ahol a rendszerkép létrejön. Ha nem látja a forrást a későbbi legördülő listákban, próbálja meg módosítani a kép régióját. A rendszerképet később bármikor replikálhatja más régiókba.
Verziószám esetén írjon be egy számot, például 1.0.0. A képverzió nevének a főverziót kell követnie.alverzió.javítás formátuma egész számokkal.

A Forrás területen válassza ki a forráshoz használt fájltípust a legördülő menüből. Az egyes forrástípusok részletes részleteiért tekintse meg az alábbi táblázatot.

Forrás	Egyéb mezők
Lemezek vagy pillanatképek	– Operációsrendszer-lemez esetén válassza ki a lemezt vagy a pillanatképet a legördülő listából. – Adatlemez hozzáadásához írja be a LUN-számot, majd válassza ki az adatlemezt a legördülő listából.
Rendszerképverzió	– Válassza ki a Forrásgyűjteményt a legördülő listában. – Válassza ki a megfelelő képdefiníciót a legördülő menüből. – Válassza ki a meglévő képverziót, amelyet használni szeretne a legördülő listában.
Felügyelt rendszerkép	Válassza ki a Forrásképet a legördülő listában. A felügyelt lemezképnek ugyanabban a régióban kell lennie, amelyet a Példány részletei között választott.
VHD tárfiókban	Válassza a Tallózás lehetőséget a VHD tárfiókjának kiválasztásához.

A Legutóbbiak kizárása beállításnál hagyja meg a Nem alapértelmezett értéket, hacsak nem szeretné, hogy ez a verzió verziószám helyett virtuális gép latest létrehozásakor legyen használva.
Az élettartam végéhez jelöljön ki egy dátumot a naptárból arra az időpontra, amikor úgy gondolja, hogy a verzió nem lesz használatban.
A Replikáció lapon válassza ki a tárolótípust a legördülő menüből.
Állítsa be az alapértelmezett replikaszámot, ezt felülbírálhatja minden hozzáadott régió esetében.
Replikálnia kell a forrásrégióba, így a lista első replikája abban a régióban lesz, ahol a rendszerképet létrehozta. További replikákat úgy vehet fel, hogy kiválasztja a régiót a legördülő listából, és szükség szerint módosítja a replikaszámot.
Ha elkészült, válassza a Véleményezés + létrehozás lehetőséget. Az Azure ellenőrzi a konfigurációt.
Amikor a rendszerkép verziója megfelel az ellenőrzésnek, válassza a Létrehozás lehetőséget.
Ha az üzembe helyezés befejeződött, válassza az Ugrás az erőforráshoz lehetőséget.

A rendszerkép replikálása eltarthat egy ideig az összes célrégióba.

Meglévő virtuális gépet is rögzíthet képként a portálról. További információ: Virtuális gép képének létrehozása a portálon.

A képdefiníciók logikai csoportosítást hoznak létre a képekhez. Ezek a bennük létrehozott képverziókkal kapcsolatos információk kezelésére szolgálnak.

Hozzon létre egy képdefiníciót egy katalógusban az sig image-definition create használatával. Győződjön meg arról, hogy a képdefiníció a megfelelő típus. Ha általánosította a virtuális gépet (Linux vagy Sysprep for Windows rendszerenwaagent -deprovision), akkor létre kell hoznia egy általános képdefiníciót a használatával--os-state generalized. Ha a virtuális gépet meglévő felhasználói fiókok eltávolítása nélkül szeretné használni, hozzon létre egy speciális képdefiníciót a következővel --os-state specialized: .

A képdefiníciókhoz megadható paraméterekről további információt a Képdefiníciók című témakörben talál.

Ebben a példában a képdefiníció neve myImageDefinition, és egy speciális Linux operációsrendszer-rendszerképhez tartozik. Ha windowsos operációs rendszert használó képek definícióját szeretné létrehozni, használja --os-type Windowsa .

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

Feljegyzés

A külső piactéri rendszerképekből származó képeket tartalmazó képdefiníciók esetében a tervadatoknak pontosan meg kell egyeznie a külső rendszerkép tervadataival. A képdefiníció hozzáadásával és --plan-publisher a képdefiníció létrehozásakor vegye fel a tervadatokat a képdefinícióba.--plan-name--plan-product

A képverzió létrehozása

Hozzon létre egy képverziót az az sig image version create használatával.

A kép létrehozásának szintaxisa attól függően változik, hogy mit használ a forrásként. A forrástípusokat keverheti, ha csak egy operációsrendszer-forrást használ. Az egyes adatlemezekhez különböző források is tartozhatnak.

Forrás	Paraméterkészlet
Operációsrendszer-lemez:
Virtuális gép a virtuális gép azonosítójával	`--managed-image <Resource ID of the VM>`
Felügyelt rendszerkép vagy más rendszerképverzió	`--managed-image <Resource ID of the managed image or image version`
Pillanatkép vagy felügyelt lemez	`--os-snapshot <Resource ID of the snapshot or managed disk>`
VHD tárfiókban	`--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>`.
Adatlemez:
Pillanatkép vagy felügyelt lemez	`--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>`
VHD tárfiókban	`--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>`

A kép különböző forrásainak megadására vonatkozó részletes példákért tekintse meg az az sig image-version create examples (az sig image-version create examples) című témakört.

Az alábbi példában egy virtuális gépről hozunk létre egy képet. A rendszerkép verziója 1.0.0 , és 2 replikát fogunk létrehozni az USA nyugati középső régiójában, 1 replikát az USA déli középső régiójában és 1 replikát az USA 2 . keleti régiójában zónaredundáns tárolással. A replikációs régióknak tartalmazniuk kell azt a régiót, amelyben a forrás virtuális gép található.

A rendszerkép létrehozása előtt ajánlott leállítani\felszabadítani a virtuális gépet.

Cserélje le a példában szereplő értéket --managed-image a virtuális gép azonosítójára.

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"

Feljegyzés

Meg kell várnia, amíg a rendszerkép verziója teljesen elkészül és replikálódik, mielőtt ugyanazt a felügyelt lemezképet használva létrehoz egy másik rendszerképverziót.

A rendszerképet prémium szintű tárolóban is tárolhatja, ha hozzáadja --storage-account-type premium_lrsa zónaredundáns tárolást --storage-account-type standard_zrs a képverzió létrehozásakor.

A képdefiníciók logikai csoportosítást hoznak létre a képekhez. A képdefiníció létrehozásakor győződjön meg arról, hogy az összes megfelelő információval rendelkezik. Ha általánosította a forrás virtuális gépet, akkor létre kell hoznia egy képdefiníciót a használatával -OsState generalized. Ha nem általánosította a forrást, hozzon létre egy képdefiníciót a következővel -OsState specialized: .

A képdefiníciókhoz megadható értékekről további információt a Képdefiníciók című témakörben talál.

Hozza létre a képdefiníciót a New-AzGalleryImageDefinition használatával.

Ebben a példában a képdefiníció neve myImageDefinition, és egy Windowst futtató speciális virtuális géphez tartozik. A linuxos képek definíciójának létrehozásához használja -OsType Linuxa .

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

Feljegyzés

A külső képekről származó képeket tartalmazó képdefiníciók esetében a tervadatoknak pontosan meg kell egyeznie a külső rendszerkép tervadataival. A képdefiníció hozzáadásával és -PurchasePlanPublisher a képdefiníció létrehozásakor vegye fel a tervadatokat a képdefinícióba.-PurchasePlanName-PurchasePlanProduct

Képverzió létrehozása

Hozzon létre egy képverziót a New-AzGalleryImageVersion használatával.

A kép létrehozásának szintaxisa attól függően változik, hogy mit használ a forrásként.

Forrás	Paraméterkészlet
Operációsrendszer-lemez
Virtuális gép a virtuális gép azonosítójával	`-SourceImageId <Resource ID of the VM>`
Felügyelt rendszerkép vagy más rendszerképverzió	`-SourceImageId <Resource ID of the managed image or image version`
Pillanatkép vagy felügyelt lemez	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Adatlemez
Pillanatkép vagy felügyelt lemez	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

Az alábbi példában egy képverziót hozunk létre egy virtuális gépről. Ajánlott leállítani\felszabadítani a virtuális gépet, mielőtt létrehoz egy lemezképet a Stop-AzVM használatával.

Ebben a példában a rendszerkép verziója 1.0.0, és az USA nyugati középső és déli középső adatközpontjaiba replikálódik. A replikáció célrégióinak kiválasztásakor ne feledje, hogy a forrásrégiót is meg kell adnia célként a replikációhoz.

   $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

Eltarthat egy ideig, amíg replikálja a rendszerképet az összes célrégióba, ezért létrehoztunk egy feladatot, hogy nyomon tudjuk követni az előrehaladást. A feladat előrehaladásának megtekintéséhez írja be a következőt $job.State:

$job.State

Feljegyzés

Meg kell várnia, amíg a rendszerkép verziója teljesen elkészül és replikálódik, mielőtt ugyanazt a felügyelt lemezképet használva létrehoz egy másik rendszerképverziót.

A rendszerképet prémium szintű tárolóban is tárolhatja, ha hozzáadja -StorageAccountType Premium_LRSa zónaredundáns tárolást -StorageAccountType Standard_ZRS a képverzió létrehozásakor.

Képdefiníció létrehozása a REST API használatával

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

Hozzon létre egy képverziót a REST API használatával. Ebben a példában egy képverziót hozunk létre egy virtuális gépről. Másik forrás használatához adja meg a forrás erőforrás-azonosítóját (például adja meg az operációsrendszer-lemez pillanatképének azonosítóját).

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

Rendszerkép létrehozása egy bérlőben a forráslemezkép használatával egy másik bérlőben

A forráslemezképet tartalmazó előfizetésben adjon olvasói engedélyeket a felhasználónak. Ha a felhasználó rendelkezik olvasói engedéllyel a forrásrendszerképhez, jelentkezzen be mindkét fiókba (forrás és cél).

Szüksége lesz a tenantID forráslemezképre, az subscriptionID előfizetésre, amelyben az új rendszerképet tárolják (cél), valamint a resourceID forrásrendszerképre. Emellett gondoskodnia kell arról, hogy a forráslemezkép régiója vagy replikája és célrégiója megegyezik.

Parancssori felület
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
   --location myLocation

# 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

Következő lépések

A vásárlási terv adatainak megadásáról további információt az Azure Marketplace vásárlási tervadatainak megadása rendszerképek létrehozásakor című témakörben talál.

Megosztás a következőn keresztül:

Képdefiníció és képverzió létrehozása

Mielőtt elkezdené

Közösségi katalógus

Rendszerkép létrehozása

Rendszerkép létrehozása egy bérlőben a forráslemezkép használatával egy másik bérlőben

Következő lépések

Visszajelzés

További források