إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يمكنك إدارة حسابات وموارد Azure Batch باستخدام واجهة Azure Command-Line (Azure CLI). هناك أوامر لإنشاء وتحديث موارد الدفعة مثل المجمعات، والوظائف، والمهام. يمكنك أيضا إنشاء سكريبتات للعديد من نفس المهام التي تقوم بها من خلال واجهات برمجة التطبيقات الدفعية، وأوامر PowerShell، وبوابة Azure.
يمكنك تشغيل Azure CLI في Azure Cloud Shell أو تثبيت Azure CLI محليا. تتوفر نسخ لأنظمة تشغيل ويندوز وماك ولينكس.
تشرح هذه المقالة كيفية استخدام واجهة الأرقام Azure مع حسابات وموارد Batch (الحسابات المشتركة).
إعداد Azure CLI
اختر كيف تريد إعداد واجهة زر الأزرع:
- تشغيل واجهة Azure CLI في Cloud Shell.
-
قم بتثبيت واجهة برمجة Azure محليا.
- تثبيت Azure CLI على Windows
- تثبيت Azure CLI على macOS
- قم بتثبيت واجهة برمجة Azure على لينكس لتوزيعات لينكس متعددة.
إذا كنت جديدا في استخدام Azure CLI، راجع البدء مع Azure CLI قبل أن تستمر.
إذا كنت قد قمت بتثبيت واجهة Azure محليا سابقا، تأكد من تحديث تثبيتك إلى أحدث إصدار.
المصادقة باستخدام واجهة تحكم Azure
لاستخدام واجهة الأزرار مع الدفعة، قم أولا بتسجيل الدخول إلى حساب Azure الخاص بك، ثم تسجيل الدخول إلى حسابك في Batch الخاص بك.
تسجيل الدخول إلى حساب Azure
لاستخدام واجهة Azure CLI، قم أولا بتسجيل الدخول إلى حسابك في Azure. تمنحك هذه الخطوة الوصول إلى أوامر Azure Resource Manager، والتي تشمل أوامر خدمة إدارة الدفعات . بعد ذلك، يمكنك تشغيل أوامر لإدارة حسابات الدفعات، والمفاتيح، وحزم التطبيقات، والحصص.
يمكنك التحقق من حساب Azure الخاص بك في واجهة Azure CLI) بطريقتين. لتشغيل الأوامر بنفسك، قم بتسجيل الدخول إلى واجهة Azure CLI بشكل تفاعلي. واجهة Azure CLI تحفظ بيانات اعتمادك مؤقتا، ويمكنها استخدام نفس بيانات الدخول إلى حسابك في Batch بعد ذلك. لتشغيل الأوامر من سكريبت أو تطبيق، قم بتسجيل الدخول إلى واجهة Azure CLI باستخدام رئيسة الخدمة.
لتسجيل الدخول إلى واجهة Azure CLI بشكل تفاعلي، قم بتشغيل az login:
az login
تسجيل الدخول إلى حساب Batch
بعد ذلك، سجل الدخول إلى حسابك في Batch في واجهة Azure باستخدام أمر تسجيل الدخول إلى حساب az batch للحساب. تمنحك هذه الخطوة الوصول إلى أوامر خدمة الدفعة. بعدها، يمكنك إدارة موارد الدفعة مثل البرك، الوظائف، والمهام.
يمكنك التحقق من حساب Batch الخاص بك في واجهة Azure CLI بطريقتين. الطريقة الافتراضية هي المصادقة باستخدام Microsoft Entra ID. نوصي باستخدام هذه الطريقة في معظم الحالات. خيار آخر هو استخدام مصادقة المفتاح المشترك.
إذا كنت تنشئ سكريبتات Azure CLI لأتمتة أوامر Batch (Batch Command)، يمكنك استخدام أي من طريقتي المصادقة. في بعض الحالات، قد يكون التحقق من المفتاح المشترك أبسط من إنشاء مبدأ خدمة.
المصادقة باستخدام معرف Microsoft Entra
الطريقة الافتراضية للمصادقة مع حساب Batch هي من خلال Microsoft Entra ID. عند تسجيل الدخول إلى واجهة الأزرق بشكل تفاعلي أو مع مدير الخدمة، يمكنك استخدام نفس بيانات الاعتماد المخزنة مؤقتا لتسجيل الدخول إلى حساب Batch الخاص بك باستخدام معرف Microsoft Entra ID. تقدم هذه الطريقة أيضا التحكم في الوصول القائم على الأدوار في Azure (Azure RBAC). مع Azure RBAC، يعتمد وصول المستخدم على الدور المعين له، وليس على مفاتيح الحساب. كل ما تحتاجه هو إدارة أدوار Azure، وليس مفاتيح الحساب. بعد ذلك، يتولى Microsoft Entra ID الوصول والمصادقة.
لتسجيل الدخول إلى حسابك في Batch باستخدام معرف Microsoft Entra، قم بتشغيل az batch login. تأكد من تضمين معايير المطلوبة لاسم حساب Batch الخاص بك (-n)، واسم مجموعة الموارد الخاصة بك (-g).
az batch account login -g <your-resource-group> -n <your-batch-account>
المصادقة باستخدام المفتاح المشترك
يمكنك أيضا استخدام مصادقة المفتاح المشترك لتسجيل الدخول إلى حسابك في Batch الخاص بك. تستخدم هذه الطريقة مفاتيح الوصول إلى حسابك للمصادقة على أوامر Azure CLI لخدمة Batch الخاصة بها.
لتسجيل الدخول إلى حسابك في Batch باستخدام مصادقة المفتاح المشترك، قم بتشغيل az batch login المعلمة --shared-key-auth. تأكد من تضمين معايير المطلوبة لاسم حساب Batch الخاص بك (-n)، واسم مجموعة الموارد الخاصة بك (-g).
az batch account login -g <your-resource-group> -n <your-batch-account> --shared-key-auth
تعلم أوامر الدفعات
تسرد وثائق مرجع Azure CLI جميع أوامر Azure CLI للدفعة.
لسرد جميع أوامر الدفعة في واجهة الأزرق، قم بتشغيل az batch -h.
هناك عدة أمثلة على سكريبتات CLI لمهام الدفعات الشائعة. توضح هذه الأمثلة كيفية استخدام العديد من الأوامر المتاحة للدفعة في واجهة Azure CLI. يمكنك تعلم كيفية إنشاء وإدارة حسابات Batch ومجموعات الاستخدامات والمهام الخاصة ب Batch فقط.
استخدم أوامر امتداد CLI الدفعية
يمكنك استخدام امتداد Batch CLI لتشغيل مهام الدفعة دون كتابة كود. يوفر الامتداد أوامر لاستخدام قوالب JSON لإنشاء مجموعات ووظائف ومهام باستخدام واجهة برمجة أزرور. يوفر الامتداد أيضا أوامر للاتصال بحساب Azure Storage مرتبط بحسابك في Batch الخاص بك. ثم يمكنك رفع ملفات إدخال الوظائف وتحميل ملفات إدخال الوظائف.
أنشئ موارد باستخدام JSON
يمكنك إنشاء معظم موارد الدفعة باستخدام معلمات سطر الأوامر فقط. بعض الميزات تتطلب منك تحديد ملف تكوين JSON بدلا من ذلك. يحتوي ملف JSON على تفاصيل التكوين لمصدرك الجديد. على سبيل المثال، يجب عليك استخدام ملف JSON لتحديد ملفات الموارد لمهمة البدء.
على سبيل المثال، لاستخدام ملف JSON لتكوين مورد جديد لمجموعة الدفعات:
az batch pool <your-batch-pool-configuration>.json
عندما تحدد ملف JSON لمورد جديد، لا تستخدم معلمات أخرى في أمرك. تستخدم الخدمة ملف JSON فقط لتكوين المورد.
تسرد وثائق مرجعية API في Batch REST أي صيغة JSON مطلوبة لإنشاء مورد.
لرؤية بناء جملة JSON المطلوبة لإنشاء مورد، راجع وثائق مرجعية API الخاصة ب Batch REST . اذهب إلى قسم الأمثلة في صفحة المراجع لعملية الموارد. ثم ابحث عن القسم الفرعي بعنوان إضافة <نوع> الموارد. على سبيل المثال، أضف مهمة أساسية. استخدم كود JSON النموذجي كقوالب لملفات التكوين الخاصة بك.
للحصول على نموذج سكريبت يحدد ملف JSON، انظر تشغيل مهمة ومهام باستخدام دفعة.
استعلام موارد الدفعة بكفاءة
يمكنك الاستعلام من حسابك في Batch وسرد جميع الموارد باستخدام الأمر list . على سبيل المثال، لسرد مجموعات الحسابات والمهام في وظيفتك:
az batch pool list
az batch task list --job-id <your-job-id>
لتحديد كمية البيانات التي يعيدها استعلام الدفعة، حدد جملة OData. كل التصفية تتم على جانب الخادم، لذا أنت تستلم فقط البيانات التي تطلبها. استخدم هذه العبارات في OData لتوفير عرض النطاق الترددي والوقت أثناء العمليات list . لمزيد من المعلومات، راجع استعلامات القوائم الفعالة لموارد الدفعة.
| بند | الوصف |
|---|---|
--select-clause [select-clause] |
يرجع مجموعة فرعية من الخصائص لكل كيان. |
--filter-clause [filter-clause] |
يعيد فقط الكيانات التي تطابق تعبير OData المحدد. |
--expand-clause [expand-clause] |
يحصل على معلومات الكيان في مكالمة REST الأساسية واحدة. بند التوسيع يدعم حاليا فقط الخاصية stats . |
للحصول على مثال سكريبت يوضح كيفية استخدام هذه الجمل، انظر تشغيل مهمة ومهام مع دفعة.
Troubleshooting
للحصول على المساعدة في أي أمر من Batch Command، أضف -h إلى نهاية أمرك. لا تضيف خيارات أخرى. على سبيل المثال، للحصول على مساعدة في إنشاء حساب Batch قم بتشغيل az batch account create -h.
لإرجاع مخرجات الأوامر المفصلة، أضف -v أو -vv إلى نهاية أمرك. استخدم هذه المفاتيح لعرض مخرج الخطأ الكامل.
-vv العلم يعيد طلبات REST الفعلية والاستجابات.
لعرض مخرج الأوامر بصيغة JSON، أضف --json إلى نهاية أمرك. على سبيل المثال، لعرض خصائص مجموعة تسمى pool001، قم بتشغيل az batch pool show pool001 --json. ثم نسخ وتعديل المخرجات لإنشاء موارد دفعية باستخدام ملف تكوين JSON.
استكشاف أخطاء Azure CLI العامة وإصلاحها
يمكن تشغيل Azure CLI في عِدة بيئات shell، ولكن مع تباينات بسيطة في التنسيق. إذا كانت لديك نتائج غير متوقعة مع أوامر Azure CLI، فراجع كيفية استخدام Azure CLI بنجاح.