مشاركة عبر

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

  • مقالة

توضح هذه المقالة كيفية حل الأخطاء المحتملة في تثبيت Bicep.

خطأ في وقت التشغيل .NET

قد تواجه رسائل الخطأ التالية عند تثبيت امتداد Bicep لـ Visual Studio Code:

Failed to install .NET runtime v5.0

Failed to download .NET 5.0.x ....... Error!

تحذير

هذا هو الحل الأخير الذي قد يسبب مشاكل عند تحديث الإصدارات.

لحل المشكلة، يمكنك تثبيت ‎.NET يدويًا من موقع ويب ‎.NET ، ثم تكوين Visual Studio Code لإعادة استخدام تثبيت موجود من ‎.NET مع الإعدادات التالية:

Windows

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "C:\\Program Files\\dotnet\\dotnet.exe"
  }
]

ماك

إذا كنت بحاجة إلى تثبيت x64، فاستخدم:

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "/usr/local/share/dotnet/x64/dotnet"
  }
]

بالنسبة إلى عمليات تثبيت macOS الأخرى، استخدم:

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "/usr/local/share/dotnet/dotnet"
  }
]

راجع إعدادات المستخدم ومساحة العمل لتكوين إعدادات Visual Studio Code.

خطأ في Visual Studio Code

إذا رأيت النافذة المنبثقة لرسالة الخطأ التالية في Visual Studio Code:

The Bicep server crashed 5 times in the last 3 minutes. The server will not be restarted.

من VS Code، افتح طريقة العرض Output في الجزء الموجود أسفل الشاشة، ثم حدد Bicep:

جزء إخراج Visual Studio Code

إذا رأيت الإخراج التالي في الجزء، وكنت تستخدم إصدار Bicep CLI 0.4.1124 أو أحدث، فتحقق مما إذا كنت قد أضفت dotnetAcquisitionExtension.existingDotnetPath خيار التكوين إلى VS Code. راجع خطأ وقت التشغيل ‎.NET. إذا كان خيار التكوين هذا موجودا، فقم بإزالته وإعادة تشغيل VS Code.

It was not possible to find any compatible framework version.

خلاف ذلك، قم برع المشكلة في مستودع Bicep، وقم بتضمين رسائل الإخراج.

إصدارات متعددة من Bicep CLI مثبتة

إذا قمت بتثبيت Bicep CLI يدويًا في أكثر من موقع، فقد تلاحظ سلوكًا غير متوقع مثل Bicep CLI لا يتم تحديثه عند تشغيل أمر الترقية. أو قد تلاحظ أن تشغيل az bicep version يُرجع إصدارًا واحدًا، لكن bicep --version يُرجع إصدارًا مختلفًا.

لحل هذه المشكلة، يمكنك إما تحديث كافة المواقع أو تحديد موقع واحد للحفاظ على المواقع الأخرى وحذفها.

أولاً، افتح موجه الأوامر (وليس PowerShell)، ثم قم بتشغيل where bicep. يرجع هذا الأمر مواقع تثبيتات Bicep. إذا كنت تستخدم مثيل Bicep CLI الذي تتم إدارته بواسطة Azure CLI، فلن ترى هذا التثبيت لأنه لا تتم إضافته إلى PATH. إذا where bicep قام بإرجاع موقع واحد فقط، فقد تكون الإصدارات المتعارضة التي تراها موجودة بين التثبيت اليدوي وتثبيت Azure CLI.

من أجل الاحتفاظ بكافة مواقع التثبيت، استخدم نفس الطريقة التي استخدمتها سابقًا لتثبيت Bicep CLI يدويًا لكافة المواقع التي تريد الاحتفاظ بها. إذا كنت تستخدم Azure CLI، قم بتشغيل az bicep upgrade لتحديث هذا الإصدار.

من أجل الاحتفاظ بموقع تثبيت واحد فقط، استخدم الخطوات التالية:

  1. حذف الملفات الخاصة بالتثبيتات التي لا تريد الاحتفاظ بها.
  2. إزالة هذه المواقع من متغير البيئة PATH.

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

  1. حذف موقع التثبيت اليدوي.
  2. إضافة موقع Bicep CLI المثبت بواسطة Azure CLI إلى متغير PATH. بالنسبة Windows، الموقع الذي تحتفظ به Azure CLI هو %USERPROFILE%\.Azure\bin.

بعد إضافة مثيل Azure CLI إلى PATH، يمكنك استخدام هذا الإصدار مع إما az bicep أو bicep.

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

للحصول على مزيدٍ من المعلومات حول استخدام Visual Studio Code وامتداد Bicep، راجع التشغيل السريع: إنشاء ملفات Bicep باستخدام Visual Studio Code.