البحث عن معلومات صورة Azure Marketplace باستخدام Azure CLI

مقالة
10/15/2024

تنبيه

تشير هذه المقالة إلى CentOS، وهو توزيع Linux هو حالة نهاية العمر الافتراضي (EOL). يرجى مراعاة استخدامك والتخطيط وفقا لذلك. لمزيد من المعلومات، راجع إرشادات نهاية العمر الافتراضي CentOS.

ينطبق على: ✔️ أجهزة Linux الظاهرية ✔️ أجهزة Windows الظاهرية ✔️ مجموعات مقياس مرنة

يوضح هذا الموضوع كيفية استخدام Azure CLI للبحث عن صور VM في Azure Marketplace. استخدم هذه المعلومات لتحديد صورة Marketplace عند إنشاء جهاز ظاهري برمجياً باستخدام CLI أو قوالب Resource Manager أو أدوات أخرى.

يمكنك أيضاً استعراض الصور والعروض المتوفرة باستخدام Azure Marketplace أو Azure PowerShell.

المصطلحات

تحتوي صورة Marketplace في Azure على السمات التالية:

الموزع: المؤسسة التي أنشأت الصورة. أمثلة: Canonical وRedHat وSUSE.
العرض: اسم مجموعة الصور ذات الصلة التي أنشأها موزع. أمثلة: 0001-com-ubuntu-server-تشويش، RHEL، sles-15-sp3.
SKU: مثيل أحد العروض، مثل إصدار رئيسي للتوزيع. أمثلة: 22_04-lts-gen2، 8-lvm-gen2، gen2.
الإصدار: رقم إصدار SKU للصورة.

يمكن تمرير هذه القيم بشكلٍ فردي أو كصورة URN مع دمج القيم المفصولة بنقطتين (:). على سبيل المثال: الموزع:العرض:Sku:الإصدار. يمكنك استبدال رقم الإصدار في URN بـ latest لاستخدام أحدث نسخة من الصورة.

إذا كان ناشر الصور يوفر ترخيصا إضافيا وشروط شراء، فيجب عليك قبول هذه الشروط قبل أن تتمكن من استخدام الصورة. لمزيدٍ من المعلومات، راجع التحقق من معلومات خطة الشراء.

قائمة الصور الشائعة

يمكنك تشغيل قائمة صور az vm -- كل ذلك لرؤية جميع الصور المتاحة لك، ولكن قد يستغرق الأمر عدة دقائق لإنتاج القائمة بأكملها. الخيار الأسرع هو استخدام az vm image list، دون --all الخيار ، لمشاهدة قائمة بصور الأجهزة الظاهرية الشائعة في Azure Marketplace. على سبيل المثال، قم بتشغيل الأمر التالي لعرض قائمة مخزنة مؤقتاً بالصور الشائعة بتنسيق جدول:

az vm image list --output table

يتضمن الإخراج صورة URN. إذا حذفت --all الخيار، يمكنك مشاهدة UrnAlias لكل صورة، إذا كانت متوفرة. UrnAlias هو نسخة مختصرة تم إنشاؤها للصور الشائعة مثل Ubuntu2204. أسماء الأسماء المستعارة لصورة Linux وتفاصيلها الناتجة عن هذا الأمر هي:

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

أسماء الأسماء المستعارة لصورة Windows وتفاصيلها الناتجة عن هذا الأمر هي:

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

البحث عن صور محددة

يمكنك تصفية قائمة الصور حسب --publisher أو معلمة أخرى للحد من النتائج.

على سبيل المثال، يعرض الأمر التالي جميع عروض Debian:

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

يمكنك تقييد النتائج الخاصة بك إلى بنية واحدة عن طريق إضافة المعلمة --architecture . على سبيل المثال، لعرض جميع صور Arm64 المتوفرة من Canonical:

az vm image list --architecture Arm64 --publisher Canonical --all --output table

انظر إلى جميع الصور المتاحة

ثمة طريقة أخرى للعثور على صورة في أحد المواقع وهي تشغيل أوامر az vm image list-publishers وaz vm image list-offers وaz vm image list-skus بالترتيب. باستخدام هذه الأوامر، يمكنك تحديد هذه القيم:

أدرج موزعي الصور لأحد المواقع. في هذا المثال، نحن ننظر إلى منطقة غرب الولايات المتحدة .
```
az vm image list-publishers --location westus --output table
```
بالنسبة إلى موزع معين، أدرج عروضه. في هذا المثال، نضيف RedHat كناشر.
```
az vm image list-offers --location westus --publisher RedHat --output table
```
للحصول على عرض معين، قم بإدراج وحدات SKU الخاصة بهم. في هذا المثال، نضيف RHEL كعرض.
```
az vm image list-skus --location westus --publisher RedHat --offer RHEL --output table
```

إشعار

قام Canonical بتغيير أسماء العروض التي يستخدمونها لأحدث الإصدارات. قبل Ubuntu 20.04، اسم العرض هو UbuntuServer. بالنسبة إلى Ubuntu 20.04 ، يكون اسم العرض و 0001-com-ubuntu-server-focal ل Ubuntu 22.04 هو 0001-com-ubuntu-server-jammy.

بالنسبة إلى موزع معين، والعرض، ووحدة SKU، اعرض جميع إصدارات الصورة. في هذا المثال، نضيف 9_1 ك SKU.
```
az vm image list \
    --location westus \
    --publisher RedHat \
    --offer RHEL \
    --sku 9_1 \
    --all --output table
```

قم بتمرير هذه القيمة لعمود URN مع المعلمة --image عند إنشاء جهاز ظاهري باستخدام الأمر az vm create. يمكنك أيضا استبدال رقم الإصدار في URN ب "الأحدث"، لاستخدام أحدث إصدار من الصورة.

إذا قمت بنشر جهاز ظاهري باستخدام قالب Resource Manager، فإنك تقوم بتعيين معلمات الصورة بشكلٍ فردي في الخصائصimageReference. راجع مرجع القالب.

تحقق من معلومات خطة الشراء

تحتوي بعض صور الجهاز الظاهري في Azure Marketplace على ترخيص إضافي وشروط شراء يجب قبولها قبل أن تتمكن من نشرها برمجيا.

لنشر جهاز ظاهري من مثل هذه الصورة، ستحتاج إلى قبول شروط الصورة في المرة الأولى التي تستخدمها فيها، مرة واحدة لكل اشتراك. ستحتاج أيضاً إلى تحديد معلمات خطة الشراء لنشر جهاز ظاهري من تلك الصورة

لعرض معلومات خطة شراء صورة، قم بتشغيل الأمر az vm image show باستخدام URN الخاص بالصورة. plan إذا لم تكن nullالخاصية في الإخراج ، فإن الصورة تحتوي على مصطلحات تحتاج إلى قبولها قبل النشر البرمجي.

على سبيل المثال، لا تحتوي صورة Ubuntu Server 18.04 LTS المتعارف عليه على مصطلحات إضافية، لأن plan المعلومات هي null:

az vm image show --location westus --urn Canonical:UbuntuServer:18.04-LTS:latest

إخراج:

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

يعرض تشغيل أمر مشابه لـ RabbitMQ Certified by Bitnami الخصائص plan التالية: name وproduct وpublisher. (تحتوي بعض الصور أيضاً على خاصية promotion code.)

az vm image show --location westus --urn bitnami:rabbitmq:rabbitmq:latest

إخراج:

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

لنشر هذه الصورة، تحتاج إلى قبول الشروط وتوفير معلمات خطة الشراء عند نشر جهاز ظاهري باستخدام تلك الصورة.

قبول الشروط

لعرض شروط الترخيص وقبولها، استخدم الأمر az vm image terms. عند قبول الشروط، يمكنك تمكين النشر البرمجي في اشتراكك. ما عليك سوى قبول الشروط مرة واحدة لكل اشتراك للصورة. على سبيل المثال:

az vm image terms show --urn bitnami:rabbitmq:rabbitmq:latest

يتضمن الإخراج licenseTextLink لشروط الترخيص، ويشير إلى أن قيمة accepted هي 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"
}

لقبول الشروط، اكتب:

az vm image terms accept --urn bitnami:rabbitmq:rabbitmq:latest

نشر جهاز ظاهري جديد باستخدام معلمات الصورة

باستخدام معلومات حول الصورة، يمكنك نشرها باستخدام الأمر az vm create.

لنشر صورة لا تحتوي على معلومات خطة، مثل أحدث صورة Ubuntu Server 18.04 من Canonical، مرر URN ل --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

بالنسبة للصورة التي تحتوي على معلمات خطة الشراء، مثل صورة RabbitMQ المعتمدة من قبل Bitnami، يمكنك تمرير URN --image وأيضاً توفير معلمات خطة الشراء:

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

إذا تلقيت رسالة حول قبول شروط الصورة، فراجع قسم قبول الشروط. تأكد من إرجاع ناتج az vm image terms accept القيمة "accepted": true, التي تظهر أنك قبلت شروط الصورة.

استخدام VHD الموجود مع معلومات خطة الشراء

إذا كان لديك VHD موجود من جهاز ظاهري تم إنشاؤه باستخدام صورة Azure Marketplace مدفوعة، فقد تحتاج إلى إعطاء معلومات خطة الشراء عند إنشاء جهاز ظاهري جديد من هذا الجهاز الظاهري.

إذا كان لا يزال لديك الجهاز الظاهري الأصلي، أو جهاز ظاهري آخر تم إنشاؤه باستخدام نفس صورة السوق، فيمكنك الحصول على اسم الخطة والموزع ومعلومات المنتج الخاصة به باستخدام az vm get-instance-view. يحصل هذا المثال على جهاز ظاهري يسمى myVM في مجموعة موارد myResourceGroup ثم يعرض معلومات خطة الشراء.

az vm get-instance-view -g myResourceGroup -n myVM --query plan

إذا لم تحصل على معلومات الخطة قبل حذف الجهاز الظاهري الأصلي، فيمكنك تقديم طلب دعم. سيحتاجون إلى اسم الجهاز الظاهري ومعرف الاشتراك والطابع الزمني لعملية الحذف.

بمجرد حصولك على معلومات الخطة، يمكنك إنشاء جهاز ظاهري جديد باستخدام المعلمة --attach-os-disk لتحديد 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

الخطوات التالية

لإنشاء جهاز ظاهري بسرعة باستخدام معلومات الصورة، راجع إنشاء أجهزة Linux الظاهرية وإدارتها باستخدام Azure CLI.

مشاركة عبر