مشاركة عبر

إدارة موارد Batch باستخدام Azure CLI

  • مقالة

يمكنك إدارة حسابات Azure الدفعية والموارد باستخدام واجهة سطر أوامر Azure (Azure CLI). توجد أوامر لإنشاء وتحديث موارد Batch مثل التجمعات والوظائف والمهام. يمكنك أيضاً إنشاء برامج نصية للعديد من المهام نفسها التي تقوم بها من خلال Batch APIs وPowerShell cmdlets ومدخل Microsoft Azure.

يمكنك تشغيل Azure CLI في Azure Cloud Shell أو تثبيت Azure CLI محلياً. الإصدارات متوفرة لأنظمة تشغيل Windows وMac وLinux (OS).

تشرح هذه المقالة كيفية استخدام Azure CLI مع حسابات وموارد مجمعة.

إعداد Azure CLI

اختر كيف تريد إعداد Azure CLI:

إذا كنت حديث العهد باستخدام Azure CLI، فراجع بدء استخدام Azure CLI قبل المتابعة.

إذا سبق لك تثبيت Azure CLI محلياً، فتأكد من تحديث التثبيت إلى أحدث إصدار.

المصادقة باستخدام Azure CLI

لاستخدام Azure CLI مع Batch، أولاً سجّل الدخول إلى حسابك في Azure، ثم سجّل الدخول إلى حسابك الدفعي.

سجّل الدخول إلى حساب Azure

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

يمكنك مصادقة حساب Azure الخاص بك في Azure CLI) بطريقتين. لتشغيل الأوامر بنفسك، قم بتسجيل الدخول إلى Azure CLI بشكل تفاعلي. يقوم Azure CLI بتخزين معلومات تسجيل الدخول الخاصة بك مؤقتاً، ويمكنه استخدام معلومات تسجيل الدخول نفسها لتسجيل دخولك إلى حساب Batch الخاص بك بعد ذلك. لتشغيل أوامر من برنامج نصي أو تطبيق ما، قم بتسجيل الدخول إلى Azure CLI باستخدام مدير خدمة.

من أجل تسجيل الدخول إلى Azure CLI بشكل تفاعلي، قم بتشغيل az login:

az login

قم بتسجيل الدخول إلى حساب Batch

بعد ذلك، قم بتسجيل الدخول إلى حساب الدُفعات الخاص بك في Azure CLI باستخدام الأمر تسجيل الدخول إلى حساب الدُفعات من az. تتيح لك هذه الخطوة الوصول إلى أوامر خدمة Batch. بعد ذلك، يمكنك إدارة موارد الدُفعات مثل مجموعات التخزين والوظائف والمهام.

يمكنك مصادقة حساب الدُفعات الخاص بك في Azure CLI بطريقتين. الأسلوب الافتراضي هو المصادقة باستخدام معرف Microsoft Entra. نوصي باستخدام هذه الطريقة في معظم السيناريوهات. هناك خيار آخر وهو استخدام مصادقة المفتاح المشترك.

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

المصادقة باستخدام معرف Microsoft Entra

الطريقة الافتراضية للمصادقة باستخدام حساب Batch الخاص بك هي من خلال معرف Microsoft Entra. عند تسجيل الدخول إلى Azure CLI بشكل تفاعلي أو باستخدام كيان خدمة، يمكنك استخدام نفس بيانات الاعتماد المخزنة مؤقتا لتسجيل دخولك إلى حساب Batch الخاص بك باستخدام معرف Microsoft Entra. توفر طريقة المصادقة هذه أيضاً التحكم في الوصول المستند إلى الدور Azure (Azure RBAC). باستخدام Azure RBAC، يعتمد وصول المستخدم على الدور المعين له، وليس مفاتيح الحساب. تحتاج فقط إلى إدارة أدوار Azure، وليس مفاتيح الحساب. ثم يعالج معرف Microsoft Entra الوصول والمصادقة.

لتسجيل الدخول إلى حساب Batch الخاص بك باستخدام معرف Microsoft Entra، قم بتشغيل az batch login. تأكد من تضمين المعلمات المطلوبة لاسم حساب الدُفعة (-n)، واسم مجموعة الموارد (-g).

az batch account login -g <your-resource-group> -n <your-batch-account>

المصادقة باستخدام المفتاح المشترك

يمكنك أيضاً استخدام مصادقة المفتاح المشترك لتسجيل الدخول إلى حسابك الدفعي. تستخدم هذه الطريقة مفاتيح الوصول إلى حسابك لمصادقة أوامر Azure CLI لخدمة Batch.

لتسجيل الدخول إلى حساب Batch الخاص بك باستخدام مصادقة المفتاح المشترك، قم بتشغيل az batch login باستخدام المعلمة --shared-key-auth. تأكد من تضمين المعلمات المطلوبة لاسم حساب الدُفعة (-n)، واسم مجموعة الموارد (-g).

az batch account login -g <your-resource-group> -n <your-batch-account> --shared-key-auth

تعلم أوامر الدُفعات

تسرد الوثائق المرجعية لـ Azure CLI جميع أوامر Azure CLI للدُفعة.

لسرد كافة أوامر الدُفعات في Azure CLI، قم بتشغيل az batch -h.

توجد عدة أمثلة لنصوص CLI النصية لمهام الدُفعات الشائعة. توضح هذه الأمثلة كيفية استخدام العديد من الأوامر المتوفرة لـ Batch في Azure CLI. يمكنك معرفة كيفية إنشاء وإدارة حسابات مجمّعة ومجمّعات ووظائف ومهام.

استخدم أوامر Batch CLI للتمديد

يمكنك استخدام ملحق Batch CLI لتشغيل مهام مجمعة دون كتابة تعليمات برمجية. يوفر الملحق أوامر لاستخدام قوالب JSON لإنشاء تجمعات ووظائف ومهام باستخدام Azure CLI. يوفر الملحق أيضاً أوامر للاتصال بحساب Azure Storage المرتبط بحساب Batch الخاص بك. بعد ذلك، يمكنك تحميل ملفات إدخال المهام وتنزيل ملفات إدخال المهام.

أنشئ موارد باستخدام JSON

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

على سبيل المثال، لاستخدام ملف JSON لتكوين مورد تجمع دفعي جديد:

az batch pool <your-batch-pool-configuration>.json

عندما تحدد ملف JSON لمورد جديد، لا تستخدم معلمات أخرى في الأمر الخاص بك. تستخدم الخدمة ملف JSON فقط لتكوين المورد.

تسرد وثائق مرجع Batch REST API أي بنية JSON مطلوبة لإنشاء مورد.

للاطلاع على بنية JSON المطلوبة لإنشاء مورد، ارجع إلى وثائق مرجع Batch REST API. انتقل إلى قسم أمثلة في الصفحة المرجعية لعملية المورد. ثم ابحث عن القسم الفرعي بعنوان إضافة <نوع المورد>. على سبيل المثال، أضف مهمة أساسية. استخدم مثال كود JSON كقوالب لملفات التكوين الخاصة بك.

للحصول على نموذج نص برمجي يحدد ملف JSON، راجع تشغيل مهمة ومهام باستخدام Batch.

موارد دفعة الاستعلام بكفاءة

يمكنك الاستعلام عن حساب الدُفعات الخاص بك وإدراج جميع الموارد باستخدام الأمر list. على سبيل المثال، لسرد التجمعات في حسابك والمهام في الوظيفة:

az batch pool list
az batch task list --job-id <your-job-id>

للحد من كمية البيانات التي يعرضها استعلام الدُفعة، حدد عبارة OData. تتم جميع عمليات التصفية من جانب الخادم، لذلك لا تتلقى سوى البيانات التي تطلبها. استخدم عبارات OData هذه لتوفير النطاق الترددي والوقت مع عمليات list. لمزيد من المعلومات، راجع تصميم استعلامات قائمة فعالة لموارد الدُفعات.

Clause ‏‏الوصف
--select-clause [select-clause] تُرجع مجموعة فرعية من الخصائص لكل كيان.
--filter-clause [filter-clause] لا يُرجع سوى الكيانات التي تطابق تعبير OData المحدد.
--expand-clause [expand-clause] يحصل على معلومات الكيان في مكالمة REST أساسية واحدة. بند التوسيع يدعم حالياً خاصية stats فقط.

للحصول على مثال لبرنامج نصي يوضح كيفية استخدام هذه العبارات، راجع تشغيل مهمة ومهام باستخدام Batch.

استكشاف الأخطاء وإصلاحها

للحصول على مساعدة بشأن أي أمر دفعة، أضف -h إلى نهاية الأمر الخاص بك. لا تقم بإضافة خيارات أخرى. على سبيل المثال، للحصول على مساعدة في إنشاء حساب دفعي، قم بتشغيل 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 بنجاح.

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

Quickstart: قم بتشغيل أول وظيفة Batch باستخدام Azure CLI