تثبيت وإعداد CLI (v2)
APPLY TO: Azure CLI ml extension
v1
v2 (معاينة)
ملاحظة
تستخدم هذه المقالة أحدث إصدار من الإصدار 2 من CLI الموجود في المعاينة العامة. للحصول على إرشادات حول تحديث أحدث إصدار وتثبيته، راجع مستند تثبيت CLI (الإصدار 2) وإعداده .
الامتداد ml (المعاينة) إلى Azure CLI هو الواجهة المحسنة ل Azure التعلم الآلي. فهو يتيح لك تدريب النماذج ونشرها من سطر الأوامر، مع ميزات تسرع من توسيع نطاق علم البيانات صعودا وهبوطا أثناء تتبع دورة حياة النموذج.
هام
تُعد هذه الميزة قيد المعاينة العامة في الوقت الحالي. يجري توفير إصدار المعاينة هذا من دون اتفاقية على مستوى الخدمة، ولا يوصى به لأحمال العمل الخاصة بالإنتاج. بعض الميزات ربما لا تكون مدعمة أو بها بعض القدرات المقيدة. لمزيد من المعلومات، راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.
المتطلبات الأساسية
- لاستخدام CLI، يجب أن يكون لديك اشتراك Azure. إذا لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانياً قبل أن تبدأ. جرب الإصدار المجاني أو المدفوع الخاص بـ Azure Machine Learning اليوم.
- لاستخدام أوامر CLI في هذا المستند من بيئتك المحلية، فإنك تحتاج إلى Azure CLI.
التثبيت
يتطلب ملحق التعلم الآلي الجديد إصدار >=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