ماذا نعني باستكشاف أخطاء النشر وإصلاحها؟
قد يظهر خطأ عند توزيع موارد Azure مع ملفات Bicep أو قوالب Azure Resource Manager (قوالب ARM). تتوفر أدوات استكشاف الأخطاء وإصلاحها لمساعدتك في حل أخطاء بناء الجملة قبل التوزيع. يمكنك الحصول على مزيد من المعلومات حول رموز الخطأ وأخطاء التوزيع من مدخل Microsoft Azure وAzure PowerShell وAzure CLI. تساعدك هذه الوثائق في العثور على حلول لاستكشاف الأخطاء وإصلاحها.
أنواع الأخطاء
تحدث أخطاء التحقق من الصحة قبل بدء التوزيع، وتحدث بسبب بناء جملة غير صحيح يمكن تعريفه باستخدام محرر تعليمات برمجية مثل Visual Studio Code. على سبيل المثال، اسم خاصية به خطأ إملائي أو دالة تفتقد إلى وسيطة.
تحدث أخطاء التحقق من صحة الاختبار المبدئي عند تشغيل أمر التوزيع دون توزيع الموارد في Azure. على سبيل المثال، إذا اُستخدمت قيمة معلمة غير صحيحة، فإن أمر التوزيع يُرجع رسالة خطأ.
يمكن تحديد أخطاء النشر فقط عن طريق محاولة النشر والتفاعل مع بيئة Azure. على سبيل المثال، يتطلب جهاز ظاهري (VM) بطاقة واجهة شبكة اتصال (NIC). إذا لم تكن NIC موجودة بالفعل عند نشر الجهاز الظاهري، سيظهر لك خطأ في النشر.
أدوات استكشاف الأخطاء وإصلاحها
هناك العديد من أدوات استكشاف الأخطاء وإصلاحها المتاحة لحل الأخطاء.
أخطاء بناء الجملة
للمساعدة في التعرف على أخطاء بناء الجملة قبل النشر، استخدم أحدث إصدار من Visual Studio Code. ثبّت أحدث إصدار من الملحق لقوالب Bicep أو ARM.
لاتباع أفضل الممارسات لتطوير قوالب التوزيع، استخدم الأدوات التالية:
موفّر الموارد وإصدار واجهة برمجة التطبيقات
لاستكشاف أخطاء عمليات النشر وإصلاحها، من المفيد معرفة خصائص موفر الموارد أو إصدارات API. لمزيد من المعلومات، راجع تحديد الموارد مستخدماً قوالب Bicep وARM.
تفاصيل الخطأ
عند النشر، يمكنك العثور على سبب الأخطاء من مدخل Azure وذلك من خلال الاطلاع على سجل عمليات النشر أو نشاطلمجموعة موارد. إذا كنت تستخدم Azure PowerShell، استخدم أوامر مثل Get-AzResourceGroupDeploymentOperationو AzActivityLog. بالنسبة إلى Azure CLI، استخدم أوامر مثل az deployment operation group وaz monitor activity-log list.
الخطوات التالية
- لمعرفة المزيد حول كيفية العثور على رموز أخطاء التوزيع واستكشاف مشكلات التوزيع وإصلاحها، راجع البحث عن رموز الخطأ.
- للحصول على حلول تستند إلى رمز الخطأ، راجع استكشاف أخطاء نشر Azure الشائعة وإصلاحها.
- للحصول على مقدمة للبحث عن رمز الخطأ، راجع التشغيل السريع: استكشاف أخطاء عمليات توزيع JSON لقالب ARM وإصلاحها أو التشغيل السريع: استكشاف أخطاء عمليات توزيع ملف Bicep وإصلاحها.