تثبيت وإعداد CLI (v2)

APPLY TO: Azure CLI ml extension v1 v2 (معاينة)

ملاحظة

تستخدم هذه المقالة أحدث إصدار من الإصدار 2 من CLI الموجود في المعاينة العامة. للحصول على إرشادات حول تحديث أحدث إصدار وتثبيته، راجع مستند تثبيت CLI (الإصدار 2) وإعداده .

الامتداد ml (المعاينة) إلى Azure CLI هو الواجهة المحسنة ل Azure التعلم الآلي. فهو يتيح لك تدريب النماذج ونشرها من سطر الأوامر، مع ميزات تسرع من توسيع نطاق علم البيانات صعودا وهبوطا أثناء تتبع دورة حياة النموذج.

هام

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

المتطلبات الأساسية

التثبيت

يتطلب ملحق التعلم الآلي الجديد إصدار >=2.15.0Azure CLI . تأكد من استيفاء هذا المطلب:

az version

إذا لم يكن كذلك، فقم بترقية Azure CLI.

تحقق من ملحقات Azure CLI التي قمت بتثبيتها:

az extension list

تأكد من عدم تثبيت أي إضافة متعارضة باستخدام ml مساحة الاسم، بما في ذلك الإضافة azure-cli-ml :

az extension remove -n azure-cli-ml
az extension remove -n ml

الآن ، قم بتثبيت الإضافة ml :

az extension add -n ml -y

قم بتشغيل أمر التعليمات للتحقق من التثبيت والاطلاع على الأوامر الفرعية المتوفرة:

az ml -h

يمكنك ترقية الإضافة إلى أحدث إصدار:

az extension update -n ml

التثبيت على لينكس

إذا كنت تستخدم Linux ، فإن أسرع طريقة لتثبيت إصدار CLI الضروري وملحق التعلم الآلي هي:

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash 
az extension add -n ml -y

لمزيد من المعلومات، راجع تثبيت Azure CLI لنظام التشغيل Linux.

الإعداد

تسجيل الدخول:

az login

إذا كان لديك حق الوصول إلى اشتراكات Azure متعددة، فيمكنك تعيين اشتراكك النشط:

az account set -s "<YOUR_SUBSCRIPTION_NAME_OR_ID>"

اختياريا، قم بإعداد المتغيرات الشائعة في shell لاستخدامها في الأوامر اللاحقة:


GROUP="azureml-examples"

LOCATION="eastus"

WORKSPACE="main"

تحذير

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

إذا لم يكن موجودا بالفعل، فيمكنك إنشاء مجموعة موارد Azure:


az group create -n $GROUP -l $LOCATION

وإنشاء مساحة عمل للتعلم الآلي:


az ml workspace create -n $WORKSPACE -g $GROUP -l $LOCATION

تتطلب الأوامر الفرعية للتعلم الآلي المعلمات --workspace/-w والمعلمات --resource-group/-g . لتجنب كتابتها بشكل متكرر، قم بتكوين الإعدادات الافتراضية:

az configure --defaults group=$GROUP workspace=$WORKSPACE location=$LOCATION

تلميح

تفترض معظم أمثلة التعليمات البرمجية أنك قمت بتعيين مساحة عمل افتراضية ومجموعة موارد. يمكنك تجاوزها في سطر الأوامر.

يمكنك عرض الإعدادات الافتراضية الحالية باستخدام --list-defaults/-l:

az configure -l -o table

تلميح

الجمع مع --output/-o يسمح بتنسيقات إخراج أكثر قابلية للقراءة.

اتصالات آمنة

ml يرسل ملحق CLI (الذي يطلق عليه أحيانا "CLI v2") ل Azure التعلم الآلي البيانات التشغيلية (معلمات YAML وبيانات التعريف) عبر الإنترنت العام. ml تتصل جميع أوامر ملحق CLI Resource Manager Azure. يتم تأمين هذا الاتصال باستخدام HTTPS/TLS 1.2.

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

ملاحظة

مع الامتداد السابق (azure-cli-ml، الذي يطلق عليه أحيانا "CLI v1") ، تتصل بعض الأوامر فقط Resource Manager Azure. وعلى وجه التحديد، الأوامر التي تنشئ موارد Azure أو تحدثها أو تحذفها أو تسرد أو تظهرها. تتواصل عمليات مثل إرسال مهمة تدريب مباشرة مع مساحة عمل Azure التعلم الآلي. إذا تم تأمين مساحة العمل الخاصة بك باستخدام نقطة نهاية خاصة، فهذا يكفي لتأمين الأوامر التي يوفرها الملحق azure-cli-ml .

إذا كانت مساحة عمل Azure التعلم الآلي عامة (أي ليست خلف شبكة ظاهرية)، فلا يلزم إجراء تكوين إضافي. يتم تأمين الاتصالات باستخدام HTTPS/TLS 1.2

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