Menemukan informasi citra Azure Marketplace menggunakan Azure CLI

Applies to: ✔️ Mesin Virtual Linux ✔️ Kumpulan 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, MicrosoftWindowsServer
  • Penawaran: Nama grup citra terkait yang dibuat oleh penerbit. Contoh: UbuntuServer, WindowsServer
  • SKU: Instans penawaran, seperti rilis utama distribusi. Contoh: 18.04-LTS, 2019-Datacenter
  • 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 citra menyediakan lisensi tambahan dan ketentuan pembelian, maka Anda harus menerimanya sebelum Anda dapat menggunakan citra. Untuk mengetahui informasi lebih lanjut, lihat Memeriksa informasi paket pembelian.

Jalankan perintah az vm image list, tanpa opsi --all, untuk melihat daftar gambar komputer virtual populer di Azure Marketplace. 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. Anda juga dapat menggunakan UrnAlias yang merupakan versi singkat yang dibuat untuk citra populer seperti UbuntuLTS.

Offer          Publisher               Sku                 Urn                                                             UrnAlias             Version
-------------  ----------------------  ------------------  --------------------------------------------------------------  -------------------  ---------
CentOS         OpenLogic               7.5                 OpenLogic:CentOS:7.5:latest                                     CentOS               latest
CoreOS         CoreOS                  Stable              CoreOS:CoreOS:Stable:latest                                     CoreOS               latest
debian-10      Debian                  10                  Debian:debian-10:10:latest                                      Debian               latest
openSUSE-Leap  SUSE                    42.3                SUSE:openSUSE-Leap:42.3:latest                                  openSUSE-Leap        latest
RHEL           RedHat                  7-LVM               RedHat:RHEL:7-LVM:latest                                        RHEL                 latest
SLES           SUSE                    15                  SUSE:SLES:15:latest                                             SLES                 latest
UbuntuServer   Canonical               18.04-LTS           Canonical:UbuntuServer:18.04-LTS:latest                         UbuntuLTS            latest
WindowsServer  MicrosoftWindowsServer  2019-Datacenter     MicrosoftWindowsServer:WindowsServer:2019-Datacenter:latest     Win2019Datacenter    latest
WindowsServer  MicrosoftWindowsServer  2016-Datacenter     MicrosoftWindowsServer:WindowsServer:2016-Datacenter:latest     Win2016Datacenter    latest
WindowsServer  MicrosoftWindowsServer  2012-R2-Datacenter  MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest  Win2012R2Datacenter  latest
WindowsServer  MicrosoftWindowsServer  2012-Datacenter     MicrosoftWindowsServer:WindowsServer:2012-Datacenter:latest     Win2012Datacenter    latest
WindowsServer  MicrosoftWindowsServer  2008-R2-SP1         MicrosoftWindowsServer:WindowsServer:2008-R2-SP1:latest         Win2008R2SP1         latest

Menemukan citra tertentu

Untuk menemukan citra komputer virtual tertentu di Marketplace, gunakan perintah az vm image list dengan opsi --all. Versi perintah ini memerlukan beberapa waktu dan dapat mengembalikan output yang panjang, sehingga Anda akan memfilter daftar dengan --publisher atau parameter lain.

Misalnya, perintah berikut menampilkan semua penawaran Debian (ingat bahwa tanpa penggantian --all, perintah ini hanya mencari cache lokal citra umum):

az vm image list --offer Debian --all --output table 

Output parsial:

Offer                                    Publisher                         Sku                                      Urn                                                                                                   Version
---------------------------------------  --------------------------------  ---------------------------------------  ----------------------------------------------------------------------------------------------------  --------------
apache-solr-on-debian                    apps-4-rent                       apache-solr-on-debian                    apps-4-rent:apache-solr-on-debian:apache-solr-on-debian:1.0.0                                         1.0.0
atomized-h-debian10-v1                   atomizedinc1587939464368          hdebian10plan                            atomizedinc1587939464368:atomized-h-debian10-v1:hdebian10plan:1.0.0                                   1.0.0
atomized-h-debian9-v1                    atomizedinc1587939464368          hdebian9plan                             atomizedinc1587939464368:atomized-h-debian9-v1:hdebian9plan:1.0.0                                     1.0.0
atomized-r-debian10-v1                   atomizedinc1587939464368          rdebian10plan                            atomizedinc1587939464368:atomized-r-debian10-v1:rdebian10plan:1.0.0                                   1.0.0
atomized-r-debian9-v1                    atomizedinc1587939464368          rdebian9plan                             atomizedinc1587939464368:atomized-r-debian9-v1:rdebian9plan:1.0.0                                     1.0.0
cis-debian-linux-10-l1                   center-for-internet-security-inc  cis-debian10-l1                          center-for-internet-security-inc:cis-debian-linux-10-l1:cis-debian10-l1:1.0.7                         1.0.7
cis-debian-linux-10-l1                   center-for-internet-security-inc  cis-debian10-l1                          center-for-internet-security-inc:cis-debian-linux-10-l1:cis-debian10-l1:1.0.8                         1.0.8
cis-debian-linux-10-l1                   center-for-internet-security-inc  cis-debian10-l1                          center-for-internet-security-inc:cis-debian-linux-10-l1:cis-debian10-l1:1.0.9                         1.0.9
cis-debian-linux-9-l1                    center-for-internet-security-inc  cis-debian9-l1                           center-for-internet-security-inc:cis-debian-linux-9-l1:cis-debian9-l1:1.0.18                          1.0.18
cis-debian-linux-9-l1                    center-for-internet-security-inc  cis-debian9-l1                           center-for-internet-security-inc:cis-debian-linux-9-l1:cis-debian9-l1:1.0.19                          1.0.19
cis-debian-linux-9-l1                    center-for-internet-security-inc  cis-debian9-l1                           center-for-internet-security-inc:cis-debian-linux-9-l1:cis-debian9-l1:1.0.20                          1.0.20
apache-web-server-with-debian-10         cognosys                          apache-web-server-with-debian-10         cognosys:apache-web-server-with-debian-10:apache-web-server-with-debian-10:1.2019.1008                1.2019.1008
docker-ce-with-debian-10                 cognosys                          docker-ce-with-debian-10                 cognosys:docker-ce-with-debian-10:docker-ce-with-debian-10:1.2019.0710                                1.2019.0710
Debian                                   credativ                          8                                        credativ:Debian:8:8.0.201602010                                                                       8.0.201602010
Debian                                   credativ                          8                                        credativ:Debian:8:8.0.201603020                                                                       8.0.201603020
Debian                                   credativ                          8                                        credativ:Debian:8:8.0.201604050                                                                       8.0.201604050
...

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:

  1. Mencantumkan penerbit citra untuk lokasi. Dalam contoh ini, kita melihat wilayah US Barat.

    az vm image list-publishers --location westus --output table
    
  2. Untuk penerbit tertentu, cantumkan penawaran mereka. Dalam contoh ini, kami menambahkan Canonical sebagai penerbit.

    az vm image list-offers --location westus --publisher Canonical --output table
    
  3. Untuk penawaran tertentu, cantumkan SKU mereka. Dalam contoh ini, kita menambahkan UbuntuServer sebagai penawaran.

    az vm image list-skus --location westus --publisher Canonical --offer UbuntuServer --output table
    
  4. Untuk penerbit, penawaran, dan SKU tertentu, tampilkan semua versi citra. Dalam contoh ini, kita menambahkan 18.04-LTS sebagai SKU.

    az vm image list \
        --location westus \
        --publisher Canonical \
        --offer UbuntuServer \
        --sku 18.04-LTS \
        --all --output table
    

Teruskan nilai kolom URN ini dengan parameter --image saat Anda membuat komputer virtual dengan perintah az vm create. Anda dapat mengganti nomor versi di URN dengan "terbaru" agar menggunakan versi citra 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 citra komputer virtual di Azure Marketplace memiliki lisensi tambahan dan ketentuan pembelian yang harus Anda terima sebelum Anda dapat menerapkannya 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. Jika properti plan dalam output bukan null, citra memiliki persyaratan yang perlu Anda terima sebelum penyebaran terprogram dilakukan.

Misalnya, citra Canonical Ubuntu Server 18.04 LTS tidak memiliki persyaratan tambahan, karena informasi 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 citra yang tidak memiliki informasi rencana, seperti citra Ubuntu Server 18.04 terbaru dari Canonical, teruskan 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 accept-terms mengembalikan nilai "accepted": true, yang menunjukkan bahwa Anda telah menerima persyaratan citra.

Menggunakan VHD yang ada dengan informasi rencana pembelian

Jika Anda memiliki VHD yang sudah ada dari komputer virtual yang dibuat menggunakan citra Azure Marketplace berbayar, sebaiknya sediakan informasi rencana pembelian saat membuat komputer virtual 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 komputer virtual bernama myVM di grup sumber daya myResourceGroup lalu menampilkan informasi rencana 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. Tim dukungan akan membutuhkan nama komputer virtual, 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.