البحث عن رموز الخطأ

عندما يفشل توزيع مورد Azure باستخدام قوالب Azure Resource Manager (قوالب ARM) أو ملفات Bicep، يتم تلقي رمز خطأ. توضح هذه المقالة كيفية العثور على رموز الخطأ حتى تتمكن من استكشاف المشكلة وإصلاحها. لمزيد من المعلومات حول رموز الأخطاء، راجع أخطاء التوزيع الشائعة.

أنواع الأخطاء

هناك ثلاثة أنواع من الأخطاء المرتبطة بالنشر:

• تُحدث أخطاء التحقق من صحة البيانات قبل بدء عملية التوزيع، وهي ناتجة عن أخطاء بناء الجملة في الملف. يمكن لمحرر التعليمات البرمجية مثل Visual Studio Code تحديد هذه الأخطاء.
• تحدث أخطاء التحقق من صحة الاختبار المبدئي عند تشغيل أمر التوزيع دون توزيع الموارد. يتم العثور على هذه الأخطاء قبل بدء النشر. على سبيل المثال، إذا كانت قيمة معلمة غير صحيحة، يستطيع الاختبار المبدئي العثور على الخطأ.
• أخطاء التوزيع تظهر أثناء عملية التوزيع ولا يمكن العثور عليها إلا بتقييم سير عملية التوزيع في بيئة Azure.

ومع كل خطا يظهر رمز خطأ مميز يستخدم لاستكشاف أخطاء النشر وإصلاحها. تظهر أخطاء التحقق من الصحة وأخطاء الاختبار المبدئي في سجل النشاط ولكن لا تظهر في محفوظات التوزيع. لا يتم تحويل ملف Bicep مع أخطاء بناء الجملة برمجيا إلى JSON ولا يظهر في سجل النشاط.

لتحديد أخطاء بناء الجملة، يمكنك استخدام Visual Studio Code مع أحدث ملحق Bicep أو ملحق Azure Resource Manager Tools.

أخطاء التحقق من الصحة

يتم التحقق من صحة القوالب أثناء عملية النشر ويتم عرض رموز الخطأ. قبل تشغيل التوزيع، يمكنك تحديد أخطاء التحقق من الصحة والإضاءة المسبقة عن طريق تشغيل اختبارات التحقق من الصحة باستخدام Azure PowerShell أو Azure CLI.

بوابة

يمكن نشر قالب ARM من المدخل. إذا كان القالب يحتوي على أخطاء في بناء الجملة، فسترى خطأ في التحقق من الصحة عند محاولة تشغيل النشر. لمزيد من المعلومات حول عمليات نشر المدخل، راجع نشر الموارد من قالب مخصص.

يحاول المثال التالي نشر حساب تخزين ويحدث خطأ في التحقق من الصحة.

حدد الرسالة لمزيد من التفاصيل. يحتوي القالب على خطأ في بناء الجملة مع رمز InvalidTemplateالخطأ . يظهر الملخص أن تعبيرا يفتقد قوس إغلاق.

بوويرشيل

للتحقق من صحة قالب ARM قبل التوزيع، قم بتشغيل Test-AzResourceGroupDeployment.

Test-AzResourceGroupDeployment `
  -ResourceGroupName examplegroup `
  -TemplateFile azuredeploy.json

يعرض الإخراج رموز الخطأ مثل InvalidTemplateDeployment أو AccountNameInvalid التي يمكنك استخدامها لاستكشاف القالب وإصلاحه.

بالنسبة لملف Bicep، يظهر الإخراج لمشكلة التحقق من صحة بناء الجملة خطأ معلمة.

Test-AzResourceGroupDeployment: Cannot retrieve the dynamic parameters for the cmdlet.
Cannot find path '/tmp/11111111-1111-1111-1111-111111111111/main.json' because it does not exist.

للحصول على مزيد من معلومات استكشاف الأخطاء وإصلاحها، استخدم الأمر Bicep build . يظهر الإخراج رقم سطر كل خطأ وعمود بين قوسين، ورسالة الخطأ.

bicep build main.bicep

/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
  unexpected new line character.

نطاقات أخرى

هناك أوامر cmdlets Azure PowerShell للتحقق من صحة قوالب التوزيع للاشتراك ومجموعة الإدارة ونطاقات المستأجر.

النطاق	cmdlets
الاشتراك	اختبار AzDeployment
مجموعة الإدارة	Test-AzManagementGroupDeployment
مستأجر	Test-AzTenantDeployment

Azure CLI

للتحقق من صحة قالب ARM قبل النشر، قم بتشغيل az deployment group validate.

az deployment group validate \
  --resource-group examplegroup \
  --template-file azuredeploy.json

يعرض الإخراج رموز الخطأ مثل InvalidTemplateDeployment أو AccountNameInvalid التي يمكنك استخدامها لاستكشاف القالب وإصلاحه.

بالنسبة إلى ملف Bicep، يظهر الإخراج رقم سطر الخطأ ورقم العمود بين قوسين، ورسالة الخطأ.

az deployment group validate \
  --resource-group examplegroup \
  --template-file main.bicep

/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
  unexpected new line character.

نطاقات أخرى

هناك أوامر Azure CLI للتحقق من صحة قوالب التوزيع للاشتراك ومجموعة الإدارة ونطاقات المستأجر.

النطاق	الأوامر
الاشتراك	التحقق من صحة التوزيع الفرعي من az
مجموعة الإدارة	التحقق من صحة نشر AZ
مستأجر	التحقق من صحة مستأجر توزيع az

أخطاء التوزيع

تتم معالجة العديد من العمليات لنشر مورد Azure. تحدث أخطاء التوزيع عندما تجتاز عملية التحقق من الصحة ولكنها تفشل أثناء النشر. يمكنك عرض رسائل حول كل عملية نشر وكل عملية نشر لمجموعة موارد.

بوابة

لمشاهدة الرسائل حول عمليات التوزيع، استخدم سجل نشاط مجموعة الموارد:

1. تسجيل الدخول إلى مدخل Microsoft Azure.

2. انتقل إلى Resource groups وحدد اسم مجموعة موارد التوزيع.

3. حدد سجل نشاط.

4. استخدم عوامل التصفية للعثور على سجل أخطاء العملية.

   

5. حدد سجل الأخطاء لمشاهدة تفاصيل العملية.

   

لعرض نتيجة التوزيع:

1. انتقل إلى مجموعة الموارد.

2. حدد Settings>Deployments.

3. حدد Error details للنشر.

   

4. يتم عرض رسالة الخطأ ورمز NoRegisteredProviderFound الخطأ.

   

بوويرشيل

لمشاهدة رسائل عمليات التوزيع باستخدام PowerShell، استخدم Get-AzResourceGroupDeploymentOperation.

لإظهار جميع العمليات الخاصة بالنشر:

Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

لتحديد نوع خاصية معين:

(Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup).StatusCode

للحصول على نتيجة التوزيع، استخدم Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

نطاقات أخرى

هناك أوامر cmdlets Azure PowerShell للحصول على معلومات التوزيع للاشتراك ومجموعة الإدارة ونطاقات المستأجر.

النطاق	cmdlets
الاشتراك	Get-AzDeploymentOperation الحصول على AzDeployment
مجموعة الإدارة	Get-AzManagementGroupDeploymentOperation Get-AzManagementGroupDeployment
مستأجر	Get-AzTenantDeploymentOperation الحصول على AzTenantDeployment

لمشاهدة رسائل عمليات التوزيع باستخدام Azure CLI، استخدم قائمة مجموعة عمليات التوزيع من az.

لإظهار جميع العمليات الخاصة بالنشر:

az deployment operation group list \
  --name exampledeployment \
  --resource-group examplegroup \
  --query "[*].properties"

لتحديد نوع خاصية معين:

az deployment operation group list \
  --name exampledeployment \
  --resource-group examplegroup \
  --query "[*].properties.statusCode"

للحصول على نتيجة التوزيع، استخدم az deployment group show.

az deployment group show \
  --resource-group examplegroup \
  --name exampledeployment

نطاقات أخرى

هناك أوامر Azure CLI للحصول على معلومات التوزيع للاشتراك ومجموعة الإدارة ونطاقات المستأجر.

النطاق	الأوامر
الاشتراك	قائمة فرعية لعملية توزيع az عرض فرعي للنشر من az
مجموعة الإدارة	قائمة MG لعملية نشر az عرض نشر AZ
مستأجر	قائمة مستأجري عملية النشر من الألف إلى الياء عرض مستأجر نشر az

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

• أخطاء التوزيع الشائعة
• تمكين تسجيل تتبع الأخطاء
• إنشاء قالب استكشاف الأخطاء وإصلاحها