Menemukan informasi citra Azure Marketplace menggunakan Azure CLI
Perhatian
Artikel ini mereferensikan CentOS, distribusi Linux yang merupakan status End Of Life (EOL). Harap pertimbangkan penggunaan dan rencanakan yang sesuai. Untuk informasi selengkapnya, lihat panduan Akhir Masa Pakai CentOS.
Berlaku untuk: ✔️ mesin virtual Linux ✔️ mesin virtual Windows ✔️ Set skala fleksibel
Topik ini menjelaskan cara menggunakan Azure CLI untuk menemukan citra komputer virtual di Azure Marketplace. Gunakan informasi ini untuk menentukan citra Marketplace saat Anda membuat komputer virtual secara terprogram dengan CLI, templat Resource Manager, atau alat lainnya.
Anda juga dapat menelusuri gambar dan penawaran yang tersedia menggunakan Azure Marketplace atau Azure PowerShell.
Terminologi
Citra Marketplace di Azure memiliki atribut berikut:
- Penerbit: Organisasi yang membuat citra. Contoh: Canonical, RedHat, SUSE.
- Penawaran: Nama grup citra terkait yang dibuat oleh penerbit. Contoh: 0001-com-ubuntu-server-jammy, RHEL, sles-15-sp3.
- SKU: Instans penawaran, seperti rilis utama distribusi. Contoh: 22_04-lts-gen2, 8-lvm-gen2, gen2.
- Versi: Nomor versi SKU citra.
Nilai-nilai ini dapat dilewatkan secara individual atau sebagai URN citra, yang menggabungkan nilai yang dipisahkan oleh titik dua (:). Misalnya: Penerbit:Penawaran:Sku:Versi. Anda dapat mengganti nomor versi di URN dengan latest menggunakan versi citra terbaru.
Jika penerbit gambar memberikan lisensi tambahan dan ketentuan pembelian, maka Anda harus menerima persyaratan tersebut sebelum anda dapat menggunakan gambar. Untuk mengetahui informasi lebih lanjut, lihat Memeriksa informasi paket pembelian.
Mencantumkan citra populer
Anda dapat menjalankan daftar gambar az vm --all untuk melihat semua gambar yang tersedia untuk Anda, tetapi dapat memakan waktu beberapa menit untuk menghasilkan seluruh daftar. Opsi yang lebih cepat adalah penggunaan az vm image list, tanpa --all opsi , untuk melihat daftar gambar VM populer di Marketplace Azure. Misalnya, jalankan perintah berikut untuk menampilkan daftar citra populer yang di-cache dalam format tabel:
az vm image list --output table
Output termasuk URN citra. Jika Anda menghilangkan --all opsi, Anda dapat melihat UrnAlias untuk setiap gambar, jika tersedia. UrnAlias adalah versi singkat yang dibuat untuk gambar populer seperti Ubuntu2204.
Nama alias gambar Linux dan detailnya yang dihasilkan oleh perintah ini adalah:
Architecture Offer Publisher Sku Urn UrnAlias Version
-------------- ---------------------------- ---------------------- ---------------------------------- ------------------------------------------------------------------------------ ----------------------- ---------
x64 CentOS OpenLogic 8_5-gen2 OpenLogic:CentOS:8_5-gen2:latest CentOS85Gen2 latest
x64 Debian11 Debian 11-backports-gen2 Debian:debian-11:11-backports-gen2:latest Debian-11 latest
x64 flatcar-container-linux-free kinvolk stable-gen2 kinvolk:flatcar-container-linux-free:stable-gen2:latest FlatcarLinuxFreeGen2 latest
x64 opensuse-leap-15-4 SUSE gen2 SUSE:opensuse-leap-15-4:gen2:latest OpenSuseLeap154Gen2 latest
x64 RHEL RedHat 8-lvm-gen2 RedHat:RHEL:8-lvm-gen2:latest RHELRaw8LVMGen2 latest
x64 sles-15-sp3 SUSE gen2 SUSE:sles-15-sp3:gen2:latest SLES latest
x64 0001-com-ubuntu-server-jammy Canonical 22_04-lts-gen2 Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest Ubuntu2204 latest
Nama alias gambar Windows dan detailnya yang dihasilkan oleh perintah ini adalah:
Architecture Offer Publisher Sku Urn Alias Version
-------------- ---------------------------- ---------------------- ---------------------------------- ------------------------------------------------------------------------------ ----------------------- ---------
x64 WindowsServer MicrosoftWindowsServer 2022-datacenter-azure-edition MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition:latest Win2022AzureEdition latest
x64 WindowsServer MicrosoftWindowsServer 2022-datacenter-azure-edition-core MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition-core:latest Win2022AzureEditionCore latest
x64 WindowsServer MicrosoftWindowsServer 2019-Datacenter MicrosoftWindowsServer:WindowsServer:2019-Datacenter:latest Win2019Datacenter latest
x64 WindowsServer MicrosoftWindowsServer 2016-Datacenter MicrosoftWindowsServer:WindowsServer:2016-Datacenter:latest Win2016Datacenter latest
x64 WindowsServer MicrosoftWindowsServer 2012-R2-Datacenter MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest Win2012R2Datacenter latest
x64 WindowsServer MicrosoftWindowsServer 2012-Datacenter MicrosoftWindowsServer:WindowsServer:2012-Datacenter:latest Win2012Datacenter latest
Menemukan citra tertentu
Anda dapat memfilter daftar gambar menurut --publisher atau parameter lain untuk membatasi hasilnya.
Misalnya, perintah berikut menampilkan semua penawaran Debian:
az vm image list --offer Debian --all --output table
Anda dapat membatasi hasil Anda ke satu arsitektur dengan menambahkan --architecture parameter . Misalnya, untuk menampilkan semua gambar Arm64 yang tersedia dari Canonical:
az vm image list --architecture Arm64 --publisher Canonical --all --output table
Lihat semua citra yang tersedia
Cara lain untuk menemukan citra di lokasi adalah dengan menjalankan perintah az vm image list-publishers, az vm image list-offer, dan az vm image list-skus secara berurutan. Dengan perintah ini, Anda menentukan nilai berikut:
Mencantumkan penerbit citra untuk lokasi. Dalam contoh ini, kita melihat wilayah US Barat.
az vm image list-publishers --location westus --output tableUntuk penerbit tertentu, cantumkan penawaran mereka. Dalam contoh ini, kami menambahkan RedHat sebagai penerbit.
az vm image list-offers --location westus --publisher RedHat --output tableUntuk penawaran tertentu, cantumkan SKU mereka. Dalam contoh ini, kami menambahkan RHEL sebagai penawaran.
az vm image list-skus --location westus --publisher RedHat --offer RHEL --output table
Catatan
Canonical telah mengubah nama Penawaran yang mereka gunakan untuk versi terbaru. Sebelum Ubuntu 20.04, nama Penawaran adalah UbuntuServer. Untuk Ubuntu 20.04 nama Penawaran adalah 0001-com-ubuntu-server-focal dan untuk Ubuntu 22.04 itu 0001-com-ubuntu-server-jammy.
Untuk penerbit, penawaran, dan SKU tertentu, tampilkan semua versi citra. Dalam contoh ini, kami menambahkan 9_1 sebagai SKU.
az vm image list \ --location westus \ --publisher RedHat \ --offer RHEL \ --sku 9_1 \ --all --output table
Teruskan nilai kolom URN ini dengan parameter --image saat Anda membuat komputer virtual dengan perintah az vm create. Anda juga dapat mengganti nomor versi di URN dengan "terbaru", untuk menggunakan versi gambar terbaru.
Jika Anda menggunakan komputer virtual dengan templat Resource Manager, Anda mengatur parameter gambar satu per satu di properti imageReference. Lihat referensi templat.
Memeriksa informasi rencana pembelian
Beberapa gambar VM di Marketplace Azure memiliki lisensi tambahan dan ketentuan pembelian yang harus Anda terima sebelum Anda dapat menyebarkannya secara terprogram.
Untuk menerapkan komputer virtual dari citra seperti itu, Anda harus menerima persyaratan gambar saat pertama kali menggunakannya, sekali per langganan. Anda juga harus menentukan parameter rencana pembelian untuk menerapkan komputer virtual dari citra tersebut
Untuk melihat informasi rencana pembelian citra, jalankan perintah az vm image show dengan URN citra. plan Jika properti dalam output tidak null, gambar memiliki persyaratan yang perlu Anda terima sebelum penyebaran terprogram.
Misalnya, gambar Canonical Ubuntu Server 18.04 LTS tidak memiliki istilah tambahan, karena informasinya plan adalah null:
az vm image show --location westus --urn Canonical:UbuntuServer:18.04-LTS:latest
Output:
{
"dataDiskImages": [],
"id": "/Subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Providers/Microsoft.Compute/Locations/westus/Publishers/Canonical/ArtifactTypes/VMImage/Offers/UbuntuServer/Skus/18.04-LTS/Versions/18.04.201901220",
"location": "westus",
"name": "18.04.201901220",
"osDiskImage": {
"operatingSystem": "Linux"
},
"plan": null,
"tags": null
}
Menjalankan perintah serupa untuk citra RabbitMQ Certified by Bitnami akan menunjukkan properti plan berikut: name, product, dan publisher. (Beberapa citra juga memiliki properti promotion code.)
az vm image show --location westus --urn bitnami:rabbitmq:rabbitmq:latest
Output:
{
"dataDiskImages": [],
"id": "/Subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Providers/Microsoft.Compute/Locations/westus/Publishers/bitnami/ArtifactTypes/VMImage/Offers/rabbitmq/Skus/rabbitmq/Versions/3.7.1901151016",
"location": "westus",
"name": "3.7.1901151016",
"osDiskImage": {
"operatingSystem": "Linux"
},
"plan": {
"name": "rabbitmq",
"product": "rabbitmq",
"publisher": "bitnami"
},
"tags": null
}
Untuk menyebarkan citra ini, Anda harus menerima persyaratan dan memberikan parameter rencana pembelian saat Anda menyebarkan komputer virtual menggunakan citra tersebut.
Menerima persyaratan
Untuk melihat dan menerima syarat lisensi, gunakan perintah az vm image terms. Saat Anda menerima persyaratan, Anda mengaktifkan penyebaran terprogram dalam langganan Anda. Anda hanya perlu menerima persyaratan sekali per langganan untuk citra. Contohnya:
az vm image terms show --urn bitnami:rabbitmq:rabbitmq:latest
Output menyertakan licenseTextLink ke syarat lisensi dan menunjukkan bahwa nilai accepted adalah true:
{
"accepted": true,
"additionalProperties": {},
"id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.MarketplaceOrdering/offertypes/bitnami/offers/rabbitmq/plans/rabbitmq",
"licenseTextLink": "https://storelegalterms.blob.core.windows.net/legalterms/3E5ED_legalterms_BITNAMI%253a24RABBITMQ%253a24RABBITMQ%253a24IGRT7HHPIFOBV3IQYJHEN2O2FGUVXXZ3WUYIMEIVF3KCUNJ7GTVXNNM23I567GBMNDWRFOY4WXJPN5PUYXNKB2QLAKCHP4IE5GO3B2I.txt",
"name": "rabbitmq",
"plan": "rabbitmq",
"privacyPolicyLink": "https://bitnami.com/privacy",
"product": "rabbitmq",
"publisher": "bitnami",
"retrieveDatetime": "2019-01-25T20:37:49.937096Z",
"signature": "XXXXXXLAZIK7ZL2YRV5JYQXONPV76NQJW3FKMKDZYCRGXZYVDGX6BVY45JO3BXVMNA2COBOEYG2NO76ONORU7ITTRHGZDYNJNXXXXXX",
"type": "Microsoft.MarketplaceOrdering/offertypes"
}
Untuk menerima persyaratan, ketik:
az vm image terms accept --urn bitnami:rabbitmq:rabbitmq:latest
Menyebarkan komputer virtual baru menggunakan parameter citra
Dengan informasi terkait citra, Anda dapat menyebarkannya menggunakan perintah az vm create.
Untuk menyebarkan gambar yang tidak memiliki informasi rencana, seperti gambar Ubuntu Server 18.04 terbaru dari Canonical, berikan URN untuk --image:
az group create --name myURNVM --location westus
az vm create \
--resource-group myURNVM \
--name myVM \
--admin-username azureuser \
--generate-ssh-keys \
--image Canonical:UbuntuServer:18.04-LTS:latest
Untuk citra dengan parameter rencana pembelian, seperti citra RabbitMQ Certified by Bitnami, Anda teruskan URN untuk --image dan juga sediakan parameter rencana pembelian:
az group create --name myPurchasePlanRG --location westus
az vm create \
--resource-group myPurchasePlanRG \
--name myVM \
--admin-username azureuser \
--generate-ssh-keys \
--image bitnami:rabbitmq:rabbitmq:latest \
--plan-name rabbitmq \
--plan-product rabbitmq \
--plan-publisher bitnami
Jika Anda mendapatkan pesan yang meminta Anda untuk menerima persyaratan citra, tinjau bagian Terima persyaratan. Pastikan output az vm image terms accept mengembalikan nilai "accepted": true, yang menunjukkan bahwa Anda telah menerima ketentuan gambar.
Menggunakan VHD yang ada dengan informasi rencana pembelian
Jika Anda memiliki VHD yang sudah ada dari VM yang dibuat menggunakan gambar Marketplace Azure berbayar, Anda mungkin perlu memberikan informasi rencana pembelian saat membuat VM baru dari VHD tersebut.
Jika Anda masih memiliki komputer virtual asli atau komputer virtual lain yang dibuat menggunakan citra marketplace yang sama, Anda bisa mendapatkan nama rencana, penerbit, dan informasi produk darinya menggunakan az vm get-instance-view. Contoh ini mendapatkan VM bernama myVMdi grup sumber daya myResourceGroup lalu menampilkan informasi paket pembelian.
az vm get-instance-view -g myResourceGroup -n myVM --query plan
Jika Anda tidak mendapatkan informasi paket sebelum VM asli dihapus, Anda dapat mengajukan permintaan dukungan. Mereka akan memerlukan nama VM, ID langganan, dan stempel waktu operasi penghapusan.
Setelah Anda memiliki informasi rencana, Anda dapat membuat komputer virtual baru menggunakan parameter --attach-os-disk untuk menentukan VHD.
az vm create \
--resource-group myResourceGroup \
--name myNewVM \
--nics myNic \
--size Standard_DS1_v2 --os-type Linux \
--attach-os-disk myVHD \
--plan-name planName \
--plan-publisher planPublisher \
--plan-product planProduct
Langkah berikutnya
Untuk membuat komputer virtual dengan cepat menggunakan informasi citra, lihat Membuat dan Mengelola Komputer Virtual Linux dengan Azure CLI.