Membuat definisi gambar dan versi gambar

Artikel
09/20/2023

Perhatian

Artikel ini mereferensikan CentOS, distribusi Linux yang mendekati status End Of Life (EOL). Harap pertimbangkan penggunaan dan rencanakan yang sesuai. Untuk informasi selengkapnya, lihat panduan Akhir Masa Pakai CentOS.

Azure Compute Gallery (sebelumnya dikenal sebagai Shared Image Gallery) menyederhanakan berbagi gambar kustom di seluruh organisasi Anda. Citra kustom seperti gambar pasar, tetapi Anda membuatnya sendiri. Gambar dapat dibuat dari VM, VHD, snapshot, gambar terkelola, atau versi gambar lainnya.

Azure Compute Gallery memungkinkan Anda berbagi gambar VM kustom dengan orang lain di organisasi Anda, di dalam atau di seluruh wilayah, dalam penyewa Microsoft Entra, atau secara publik menggunakan galeri komunitas. Pilih gambar mana yang ingin Anda bagikan, wilayah mana yang ingin Anda sediakan, dan dengan siapa Anda ingin membagikannya. Anda dapat membuat beberapa galeri sehingga Anda dapat mengelompokkan gambar secara logis. Banyak fitur baru seperti ARM64, Accelerated Networking dan TrustedVM hanya didukung melalui Azure Compute Gallery dan tidak tersedia untuk gambar terkelola.

Fitur Azure Compute Gallery memiliki beberapa jenis sumber daya:

Sumber daya	Deskripsi
Sumber gambar	Ini merupakan sumber daya yang dapat digunakan untuk membuat versi gambar di galeri. Sumber gambar dapat berupa mesin virtual Azure yang suda ada, baik umum atau khusus, gambar terkelola, salinan bayangan, atau versi gambar di galeri lain.
Galeri	Seperti Marketplace Azure, galeri adalah repositori untuk mengelola dan berbagi gambar serta aplikasi mesin virtual, tetapi Anda mengontrol siapa yang memiliki akses.
Definisi gambar	Definisi gambar dibuat dalam galeri dan membawa informasi tentang gambar dan persyaratan untuk menggunakannya secara internal. Hal ini termasuk apakah gambar itu Windows atau Linux, catatan rilis, dan persyaratan memori minimum dan maksimum. Hal ini merupakan definisi dari jenis gambar.
Versi gambar	Versi gambar adalah apa yang Anda gunakan untuk membuat VM saat menggunakan galeri. Anda juga bisa memiliki beberapa versi gambar yang diperlukan untuk lingkungan Anda. Seperti gambar terkelola, ketika Anda menggunakan versi gambar untuk membuat VM, versi gambar digunakan untuk membuat disk baru untuk VM. Versi gambar dapat digunakan beberapa kali.

Sebelum Anda mulai

Untuk menyelesaikan artikel ini, Anda harus memiliki Azure Compute Gallery yang sudah ada, dan sumber untuk gambar Anda tersedia di Azure. Sumber gambar dapat merupakan:

VM dalam langganan Anda. Anda dapat mengambil gambar dari VM khusus dan umum.
Gambar yang dikelola,
OS terkelola dan disk data.
OS dan disk data sebagai VHD dalam akun penyimpanan.
Versi gambar lainnya baik di galeri yang sama atau galeri lain dalam langganan yang sama.

Jika gambar berisi disk data, ukuran disk data tidak boleh lebih dari 1 TB.

Nama definisi gambar dapat terdiri dari huruf besar atau kecil, angka, titik, tanda hubung, dan titik. Untuk informasi selengkapnya tentang nilai yang bisa Anda tentukan untuk definisi gambar, lihat Definisi citra.

Karakter yang diizinkan untuk versi gambar adalah angka dan titik. Angka harus berada dalam rentang bilangan bulat 32-bit. Format: MajorVersion.MinorVersion.Patch.

Saat bekerja melalui tutorial ini, ganti nama sumber daya jika diperlukan.

Untuk gambar umum, lihat panduan khusus OS sebelum mengambil gambar:

Linux
- Langkah umum
- CentOS
- Debian
- Flatcar
- Freebsd
- Oracle Linux
- Openbsd
- Red Hat
- SUSE
- Ubuntu
Windows

Jika Anda berencana menjalankan Sysprep sebelum mengunggah hard disk virtual (VHD) ke Azure untuk pertama kalinya, pastikan Anda telah menyiapkan VM.

Galeri komunitas

Jika Anda akan berbagi gambar menggunakan galeri komunitas, pastikan Anda membuat galeri, definisi gambar, dan versi gambar di wilayah yang sama.

Saat pengguna menelusuri gambar galeri komunitas, hanya gambar versi terbaru yang ditampilkan.

Penting

Informasi dari definisi gambar Anda akan tersedia untuk umum, seperti yang Anda berikan untuk Penerbitan, Penawaran, dan SKU.

Buat sebuah citra

Pilih opsi di bawah ini untuk membuat definisi gambar dan versi gambar Anda:

Untuk membuat gambar dari VM di portal, lihat Menangkap gambar VM.

Untuk membuat gambar menggunakan sumber selain VM, ikuti langkah-langkah ini.

Buka portal Microsoft Azure, lalu cari dan pilih Azure Compute Gallery.
Pilih galeri yang ingin Anda gunakan dari daftar.
Pada halaman galeri gambar baru Anda, pilih Tambahkan dari bagian atas halaman lalu pilih definisi gambar VM dari menu drop-down.
pada halaman Tambahkan definisi gambar baru ke Azure Compute Gallery, di tab Dasar-dasar, pilih Wilayah.
Untuk Nama definisi gambar, ketikkan nama seperti myImageDefinition.
Untuk Sistem operasi, pilih opsi yang benar berdasarkan sumber Anda.
Untuk Pembuatan VM, pilih opsi berdasarkan sumber Anda. Dalam kebanyakan kasus, ini akan Gen 1. Untuk informasi selengkapnya, lihat Dukungan untuk VM generasi 2.
Untuk Status sistem operasi, pilih opsi berdasarkan sumber Anda. Untuk informasi selengkapnya, lihat Umum dan khusus.
Untuk Penerbit, ketik nama unik seperti myPublisher.
Untuk Penawaran, ketik nama unik seperti myOffer.
Untuk SKU, ketik nama unik seperti mySKU.
Di bagian bawah panel, pilih Tinjau + buat.
Setelah definisi gambar lolos validasi, pilih Buat.
Saat penyebaran selesai, pilih Buka sumber daya.
Di halaman untuk definisi gambar Anda, pada tab Mulai, pilih Buat versi.
Di Wilayah, pilih wilayah tempat Anda ingin gambar dibuat. Dalam beberapa kasus, sumber harus berada di wilayah yang sama tempat gambar tersebut dibuat. Jika Anda tidak melihat sumber tercantum dalam drop-down, coba ubah wilayah untuk gambar. Anda selalu dapat mereplikasi gambar ke wilayah lain nanti.
Untuk Nomor versi, ketikkan angka seperti 1.0.0. Nama versi gambar harus mengikuti format mayor.minor.patch menggunakan bilangan bulat.

Di Sumber, pilih jenis file yang Anda gunakan untuk sumber dari drop-down. Lihat tabel di bawah untuk detail spesifik untuk setiap jenis sumber.

Sumber	Bidang lainnya
Disk atau rekam jepret	- Untuk disk OS pilih disk atau rekam jepret dari dropdown. - Untuk menambahkan disk data, ketik nomor LUN lalu pilih disk data dari dropdown.
Versi gambar	- Pilih Galeri sumber dari dropdown. - Pilih definisi gambar yang benar dari dropdown. - Pilih versi gambar yang ada yang ingin Anda gunakan dari dropdown.
Gambar terkelola	Pilih Sumber gambar dari dropdown. Gambar yang dikelola harus berada di wilayah yang sama dengan yang Anda pilih di Detail instans.
VHD di akun penyimpanan	Pilih Telusuri untuk memilih akun penyimpanan untuk VHD.

Di Kecualikan dari yang terbaru, tinggalkan nilai default Tidak kecuali Anda tidak ingin versi ini digunakan saat membuat VM menggunakan latest, bukan nomor versi.
Untuk tanggal Akhir masa pakai, pilih tanggal dari kalender saat Anda ingin versi ini harus berhenti digunakan.
Di tab Replikasi, pilih jenis penyimpanan dari dropdown.
Atur Jumlah replika default, Anda dapat mengambil alih untuk setiap wilayah yang Anda tambahkan.
Anda perlu mereplikasi ke wilayah sumber, sehingga replika pertama dalam daftar akan berada di wilayah tempat Anda membuat gambar. Anda dapat menambahkan lebih banyak replika dengan memilih wilayah dari dropdown dan menyesuaikan jumlah replika yang diperlukan.
Setelah selesai, pilih Tinjau + buat. Azure akan memvalidasi konfigurasi.
Saat versi gambar lolos validasi, pilih Buat.
Saat penyebaran selesai, pilih Buka sumber daya.

Ini bisa memakan waktu cukup lama untuk mereplikasi gambar ke semua wilayah target.

Anda juga dapat mengambil VM yang ada sebagai gambar, dari portal. Untuk informasi selengkapnya, lihat Membuat gambar VM di portal.

Definisi citra membuat pengelompokan logis untuk citra. Mereka digunakan untuk mengelola informasi tentang versi gambar yang dibuat di dalamnya.

Buat definisi gambar di galeri menggunakan az sig image-definition create. Pastikan definisi gambar Anda adalah Jenis yang tepat. Jika Anda telah menggeneralisasi VM (menggunakan waagent -deprovision untuk Linux, atau Sysprep untuk Windows), maka Anda harus membuat definisi gambar yang digeneralisasi menggunakan --os-state generalized. Jika Anda ingin menggunakan VM tanpa menghapus akun pengguna yang ada, buat definisi gambar khusus menggunakan --os-state specialized.

Untuk informasi selengkapnya tentang parameter yang dapat Anda tentukan untuk definisi gambar, lihat Definisi gambar.

Dalam contoh ini, definisi citra diberi nama myImageDefinition, dan untuk citra khusus Linux OS. Untuk membuat definisi untuk gambar menggunakan OS Windows, gunakan --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

Catatan

Untuk definisi gambar yang akan berisi gambar turunan dari gambar pihak ketiga, informasi rencana harus sama persis dengan informasi rencana dari gambar pihak ketiga. Sertakan informasi rencana dalam definisi gambar dengan menambahkan --plan-name, --plan-product, dan --plan-publisher saat Anda membuat definisi gambar.

Membuat versi gambar

Hapus versi gambar menggunakan az sig image version create.

Sintaks untuk membuat gambar akan berubah, bergantung pada apa yang Anda gunakan sebagai sumber. Anda dapat mencampur jenis sumber, selama Anda hanya memiliki satu sumber OS. Anda juga dapat memiliki sumber yang berbeda untuk setiap disk data.

Sumber	Set parameter
Disk OS:
VM menggunakan ID VM	`--managed-image <Resource ID of the VM>`
Gambar terkelola atau versi gambar lainnya	`--managed-image <Resource ID of the managed image or image version`
Rekam jepret atau disk terkelola	`--os-snapshot <Resource ID of the snapshot or managed disk>`
VHD di akun penyimpanan	`--os-vhd-uri <URI> --os-vhd-storage-account <storage account name>`.
Disk data:
Rekam jepret atau disk terkelola	`--data-snapshots <Resource ID of the snapshot or managed disk> --data-snapshot-luns <LUN number>`
VHD di akun penyimpanan	`--data-vhds-sa <storageaccountname> --data-vhds-uris <URI> --data-vhds-luns <LUN number>`

Untuk contoh terperinci tentang cara menentukan sumber yang berbeda untuk gambar Anda, lihat contoh az sig image-version create.

Pada contoh di bawah ini, kita membuat gambar dari VM. Versi gambar kita adalah 1.0.0 dan kita akan membuat 2 replika di wilayah Barat Sentral AS, 1 replika di wilayah US Selatan Tengah serta 1 replika di wilayah US Timur 2 menggunakan penyimpanan zona redundansi. Wilayah replikasi harus mencakup wilayah tempat VM sumber berada.

Sebaiknya hentikan\batalkan alokasi VM sebelum membuat gambar.

Ganti nilai --managed-image di contoh ini dengan ID VM Anda.

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"

Catatan

Anda perlu menunggu versi citra benar-benar selesai dibuat dan direplikasi sebelum Anda dapat menggunakan citra terkelola yang sama untuk membuat versi citra lain.

Anda juga bisa menyimpan gambar Anda di penyimpanan Premium dengan menambahkan --storage-account-type premium_lrs, atau Zone Redundant Storage dengan menambahkan --storage-account-type standard_zrs saat Anda membuat versi gambarnya.

Definisi citra membuat pengelompokan logis untuk citra. Saat membuat definisi gambar Anda, pastikan definisi gambar memiliki semua informasi yang benar. Jika menggeneralisasi VM sumber, Anda harus membuat definisi gambar menggunakan -OsState generalized. Jika Anda tidak menggeneralisasi VM, buat definisi gambar menggunakan -OsState specialized.

Untuk informasi selengkapnya tentang nilai yang bisa Anda tentukan untuk definisi gambar, lihat Definisi citra.

Buat definisi gambar menggunakan New-AzGalleryImageDefinition.

Dalam contoh ini, definisi citra bernama myImageDefinition, dan untuk VM Windows khusus. Untuk membuat definisi citra menggunakan Linux, gunakan -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'

Catatan

Untuk definisi gambar yang akan berisi gambar turunan dari gambar pihak ketiga, informasi rencana harus sama persis dengan informasi rencana dari gambar pihak ketiga. Sertakan informasi rencana dalam definisi gambar dengan menambahkan -PurchasePlanName, -PurchasePlanProduct, dan -PurchasePlanPublisher saat Anda membuat definisi gambar.

Membuat versi gambar

Buat versi cutra menggunakan New-AzGalleryImageVersion.

Sintaks untuk membuat gambar akan berubah, bergantung pada apa yang Anda gunakan sebagai sumber.

Sumber	Set parameter
Disk OS
VM menggunakan ID VM	`-SourceImageId <Resource ID of the VM>`
Gambar terkelola atau versi gambar lainnya	`-SourceImageId <Resource ID of the managed image or image version`
Rekam jepret atau disk terkelola	`-OSDiskImage <Resource ID of the snapshot or managed disk>`
Disk data
Rekam jepret atau disk terkelola	`-DataDiskImage @{Source = @{Id=<source_id>}; Lun=<LUN>; SizeInGB = <Size in GB>; HostCaching = <Caching> }`

Pada contoh di bawah ini, kita membuat versi gambar dari VM. Ini adalah praktik terbaik untuk menghentikan\berhenti menyediakan VM sebelum membuat gambar menggunakan Stop-AzVM.

Dalam contoh ini, versi citra adalah 1.0.0 dan direplikasi ke Barat Sentral AS dan US Tengah Selatan. Saat memilih wilayah target untuk replikasi, ingat bahwa Anda juga harus menyertakan wilayah sumber sebagai target replikasi.

   $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

Replikasi citra ke semua wilayah target dapat memakan waktu yang cukup lama, jadi, kami sudah membuat pekerjaan sehingga kita dapat melacak kemajuannya. Untuk melihat kemajuan pekerjaan, ketik $job.State.

$job.State

Catatan

Anda perlu menunggu versi citra benar-benar selesai dibuat dan direplikasi sebelum Anda dapat menggunakan citra terkelola yang sama untuk membuat versi citra lain.

Anda juga bisa menyimpan gambar Anda di penyimpanan Premium dengan menambahkan -StorageAccountType Premium_LRS, atau Zone Redundant Storage dengan menambahkan -StorageAccountType Standard_ZRS saat Anda membuat versi gambarnya.

Membuat definisi gambar menggunakan 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",
    },
}

Membuat versi gambar menggunakan REST API. Dalam contoh ini, kita membuat versi gambar dari VM. Untuk menggunakan sumber lain, kirimkan ID sumber daya untuk sumber (misalnya, kirimkan ID rekam jepret disk OS).

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

Membuat gambar dalam satu penyewa menggunakan gambar sumber di penyewa lain

Dalam langganan tempat gambar sumber ada, berikan izin pembaca kepada pengguna. Setelah pengguna memiliki izin pembaca ke gambar sumber, masuk ke akun (sumber dan target).

Anda akan memerlukan tenantID gambar sumber, subscriptionID untuk langganan tempat gambar baru akan disimpan (target), dan resourceID gambar sumber.

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

Langkah berikutnya

Untuk informasi tentang cara menyediakan informasi paket pembelian, lihat Menyediakan informasi paket pembelian Azure Marketplace saat membuat gambar.

Bagikan melalui

Membuat definisi gambar dan versi gambar

Sebelum Anda mulai

Galeri komunitas

Buat sebuah citra

Membuat gambar dalam satu penyewa menggunakan gambar sumber di penyewa lain

Langkah berikutnya

Sumber Daya Tambahan: