تثبيت أدوات Bicep

قم بإعداد بيئتك للعمل مع ملفات Bicep. لتأليف ملفات Bicep ونشرها، نوصي بأي من الخيارات التالية:

Tasks Options تثبيت Bicep CLI
Author تعليمة Visual Studio برمجية وملحق Bicep automatic
ملحق Visual Studio وBicep automatic
Deploy Azure CLI automatic
Azure PowerShell manual
تعليمة Visual Studio برمجية وملحق Bicep manual
سحابة ذات فجوة هوائية download

Warning

لا يضمن استقرار Bicep CLI في البيئات المحاكية، لأن أدوات المحاكاة مثل Rosetta2 وQEMU عادة لا تحاكي البنية بشكل مثالي.

تعليمة Visual Studio برمجية وملحق Bicep

أنت بحاجة إلى محرر Bicep جيد لإنشاء ملفات Bicep. نوصي بما يلي:

  • تعليمة Visual Studio برمجية - إذا لم يكن لديك بالفعل تعليمة Visual Studio برمجية، فثبته.

  • امتداد Bicep لـ تعليمة Visual Studio برمجية. يوفر تعليمة Visual Studio برمجية مع امتداد Bicep دعمًا للغة وإكمالًا تلقائيًا للموارد. يساعدك الامتداد في إنشاء ملفات Bicep والتحقق من صحتها.

    لتثبيت الامتداد، ابحث عن Bicep في علامة التبويب الامتدادات أو في Visual Studio marketplace.

    حدد تثبيت.

    لقطة شاشة لتثبيت ملحق Bicep.

للتحقق من تثبيت الامتداد، افتح أي ملف بامتداد الملف .bicep. يجب أن ترى وضع اللغة في الزاوية اليمنى السفلية يتغير إلى العضلة ذات الرأسين.

لقطة شاشة لوضع لغة Bicep.

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

يمكنك نشر ملفات Bicep مباشرة من محرر تعليمة Visual Studio برمجية. لمزيد من المعلومات، راجع نشر ملفات Bicep باستخدام تعليمة Visual Studio برمجية.

تكوين ملحق Bicep

للاطلاع على الإعدادات:

  1. من View القائمة، حدد Extensions.

  2. حدد Bicep من قائمة الملحقات.

  3. حدد علامة التبويب FEATURE .

  4. حدد الإعدادات.

    لقطة شاشة لإعدادات ملحق Bicep.

    يحتوي ملحق Bicep على هذه الإعدادات والقيم الافتراضية:

    ID القيمة الافتراضية Description
    bicep.completions.getAllAccessibleAzureContainerRegistries false عند إكمال مراجع الوحدة النمطية 'br:'، استعلم عن Azure لجميع سجلات الحاويات التي يمكن للمستخدم الوصول إليها (قد تكون بطيئة). إذا كان هذا الخيار قيد التشغيل، إدراج السجلات التي تم تكوينها ضمن الاسم المستعار في الوحدة النمطية في bicepconfig.json فقط.
    bicep.decompileOnPaste true تحويل قيم JSON الملصقة أو قوالب JSON ARM أو الموارد تلقائيا من قالب JSON ARM إلى Bicep (استخدم تراجع للرجوع).
    bicep.enableOutputTimestamps true إلحاق كل سطر معروض في قناة إخراج عمليات Bicep باستخدام طابع زمني.
    bicep.enableSurveys true تمكين الاستطلاعات العرضية لجمع الملاحظات التي تساعدنا على تحسين ملحق Bicep.
    bicep.suppressedWarnings تم الضغط على التحذيرات التي يتم منعها بسبب الضغط على الزر "عدم العرض مرة أخرى". إزالة العناصر لإعادة تعيينها.
    bicep.trace.server off تكوين تتبع الرسائل المرسلة إلى خادم لغة Bicep.

لتكوين الإعدادات:

  1. من القائمة ملف، حدد تفضيلات ثم إعدادات.

  2. قم بتوسيع الملحقات لتحديد Bicep:

    لقطة شاشة لتكوين إعدادات ملحق Bicep.

ملحق Visual Studio وBicep

لتأليف ملف Bicep من Visual Studio، تحتاج إلى:

  • Visual Studio - إذا لم يكن لديك Visual Studio بالفعل، فقم بتثبيته.
  • ملحق Bicep ل Visual Studio. يوفر Visual Studio مع ملحق Bicep دعم اللغة والإكمال التلقائي للموارد. يساعدك الامتداد في إنشاء ملفات Bicep والتحقق من صحتها. تثبيت الملحق من Visual Studio Marketplace.

للاطلاع على برنامج تعليمي، راجع التشغيل السريع: إنشاء ملفات Bicep باستخدام Visual Studio.

Azure CLI

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

يجب أن يكون لديك إصدار Azure CLI 2.20.0 أو إصدار أحدث مثبتًا. لتثبيت أو تحديث Azure CLI على أنظمة تشغيل مختلفة، راجع:

للتحقق من إصدارك الحالي، شغّل:

az --version

للتحقق من صحة تثبيت Bicep CLI، استخدم:

az bicep version

للترقية إلى أحدث إصدار، استخدم:

az bicep upgrade

لمزيدٍ من الأوامر، راجع Bicep CLI.

Important

يقوم Azure CLI بتثبيت مثيل مكتف ذاتيا من Bicep CLI. لا يتعارض هذا المثيل مع أي إصدارات ربما تكون قد قمت بتثبيتها يدويا. لا يضيف Azure CLI Bicep CLI إلى PATH الخاص بك.

لقد انتهيت من إعداد بيئة Bicep الخاصة بك. تصف بقية هذه المقالة خطوات التثبيت التي لا تحتاجها عند استخدام Azure CLI.

Azure PowerShell

يجب أن يكون لديك إصدار Azure PowerShell 5.6.0 أو إصدار أحدث مثبتًا. للتحديث أو التثبيت، راجع تثبيت Azure PowerShell.

لا يقوم Azure PowerShell بتثبيت Bicep CLI تلقائيًا. بدلا من ذلك، يجب تثبيت Bicep CLI يدويا.

Important

المثيل القائم بذاته لواجهة سطر الأوامر (CLI) المثبتة بواسطة Azure CLI غير متوفر لأوامر PowerShell. تفشل عمليات نشر Azure PowerShell إذا لم تكن قد قمت بتثبيت Bicep CLI يدويًا.

عند تثبيت Bicep CLI يدويا، قم بتشغيل أوامر Bicep باستخدام بناء bicep الجملة بدلا من بناء az bicep جملة Azure CLI.

للتحقق من إصدار Bicep CLI الخاص بك، شغّل:

bicep --version

التثبيت يدويا

تقوم الطرق التالية بتثبيت Bicep CLI وإضافته إلى مسارك. يجب تثبيت يدويا لأي استخدام آخر غير Azure CLI.

عند التثبيت يدويا، حدد موقعا مختلفا عن الموقع الذي يديره Azure CLI. يستخدم جميع الأمثلة التالية موقعاً باسم bicep أو .bicep. لن يتعارض هذا الموقع مع الموقع الذي تديره Azure CLI، والذي يستخدم .azure.

Linux

# Fetch the latest Bicep CLI binary
curl -Lo bicep https://github.com/Azure/bicep/releases/latest/download/bicep-linux-x64
# Mark it as executable
chmod +x ./bicep
# Add bicep to your PATH (requires admin)
sudo mv ./bicep /usr/local/bin/bicep
# Verify you can now access the 'bicep' command
bicep --help
# Done!

Note

بالنسبة إلى توزيعات Linux الخفيفة مثل Alpine، استخدم bicep-linux-musl-x64 بدلاً من bicep-linux-x64 في النص السابق.

macOS

عبر البيرة المنزلية

# Add the tap for bicep
brew tap azure/bicep

# Install the tool
brew install bicep

عبر باش

# Fetch the latest Bicep CLI binary
curl -Lo bicep https://github.com/Azure/bicep/releases/latest/download/bicep-osx-x64
# Mark it as executable
chmod +x ./bicep
# Add Gatekeeper exception (requires admin)
sudo spctl --add ./bicep
# Add bicep to your PATH (requires admin)
sudo mv ./bicep /usr/local/bin/bicep
# Verify you can now access the 'bicep' command
bicep --help
# Done!

Note

لا يحتاج تثبيت Bicep CLI الإصدار 0.16.X أو أحدث إلى استثناء Gatekeeper. ومع ذلك، لا تزال البنيات الليلية ل Bicep CLI تتطلب الاستثناء.

Windows

Windows Installer

قم بتنزيل وتشغيل أحدث Windows Installer. لا يتطلب المثبت امتيازات إدارية. بعد التثبيت، تتم إضافة Bicep CLI إلى مسار المستخدم الخاص بك. أغلق وأعد فتح أي نوافذ أوامر مفتوحة حتى يسري تغيير PATH.

Chocolatey

choco install bicep

Winget

winget install -e --id Microsoft.Bicep

دليل مع PowerShell

# Create the install folder
$installPath = "$env:USERPROFILE\.bicep"
$installDir = New-Item -ItemType Directory -Path $installPath -Force
$installDir.Attributes += 'Hidden'
# Fetch the latest Bicep CLI binary
(New-Object Net.WebClient).DownloadFile("https://github.com/Azure/bicep/releases/latest/download/bicep-win-x64.exe", "$installPath\bicep.exe")
# Add bicep to your PATH
$currentPath = (Get-Item -path "HKCU:\Environment" ).GetValue('Path', '', 'DoNotExpandEnvironmentNames')
if (-not $currentPath.Contains("%USERPROFILE%\.bicep")) { setx PATH ($currentPath + ";%USERPROFILE%\.bicep") }
if (-not $env:path.Contains($installPath)) { $env:path += ";$installPath" }
# Verify you can now access the 'bicep' command.
bicep --help
# Done!

التثبيت على سحابة هوائية

لاحظ أن الأمرين bicep install وbicep upgrade لا يعملان في بيئة ذات فجوات فارغة. لتثبيت واجهة سطر الأوامر في Bicep في بيئة ذات فجوات فارغة، تحتاج إلى تنزيل واجهة سطر الأوامر في Bicep قابلة للتنفيذ يدوياً ثم حفظها في .azure/bin. في هذا الموقع، يتم تثبيت المثيل المُدار بواسطة واجهة سطر الأوامر في Azure.

  • Linux

    1. قم بتنزيل bicep-linux-x64 من صفحة إصدار Bicep في بيئة غير هوائية.
    2. انسخ الملف القابل للتنفيذ إلى الدليل $HOME/.azure/bin على جهاز ذو فجوة هوائية. أعد تسمية الملف إلى bicep.
  • macOS

    1. قم بتنزيل bicep-osx-x64 من صفحة إصدار Bicep في بيئة غير هوائية.
    2. انسخ الملف القابل للتنفيذ إلى الدليل $HOME/.azure/bin على جهاز ذو فجوة هوائية. أعد تسمية الملف إلى bicep.
  • Windows

    1. قم بتنزيل bicep-win-x64.exe من صفحة إصدار Bicep في بيئة غير هوائية.
    2. انسخ الملف القابل للتنفيذ إلى دليل %UserProfile%/.azure/bin على جهاز به فجوة هوائية. أعد تسمية الملف إلى bicep.exe.

عند استخدام مهمة Azure CLI على سحابة ذات هواء، يجب تعيين useGlobalConfig خاصية المهمة إلى true. القيمة الافتراضية هي false. راجع CI/CD مع Azure Pipelines وملفات Bicep للحصول على مثال.

ثبّت البنيات الليلية

إذا كنت ترغب في تجربة أحدث وحدات Bicep للإصدار التجريبي قبل إصدارها، فراجع تثبيت البنيات الليلية.

Warning

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

تثبيت حزمة NuGet

جعل فريق Bicep حزمة Azure.Bicep.Core NuGet متاحة للجمهور على nuget.org. في حين أنها عامة، فإنها ليست حزمة مدعومة. سيتم تنفيذ أي تبعية تقوم بها على هذه الحزمة على مسؤوليتك الخاصة، وتحتفظ Microsoft بالحق في دفع التغييرات العاجلة إلى هذه الحزمة في أي وقت.

لمزيد من المعلومات حول تثبيت حزم NuGet واستهلاكها، راجع سير عمل استهلاك الحزمة.

أداة .NET لخادم لغة Bicep

يتم نشر خادم لغة Bicep كأداة Azure.Bicep.LangServer .NET العالمية. قم بتثبيته لدمج Bicep الذكاء اللغوي (التشخيص، go-toالتعريف، معلومات التحميض) في أدوات البرمجة الذكية وعملاء بروتوكول خادم اللغة (LSP) الآخرين.

لتثبيت الأداة بشكل عام:

dotnet tool install --global Azure.Bicep.LangServer

هذا الأمر يجعل الأمر bicep-ls متاحا على مسار PATH الخاص بك. يمكنك أيضا استخدامه dnx لتشغيل الخادم عند الطلب دون الحاجة إلى تثبيت دائم:

dnx -y Azure.Bicep.LangServer

الاستخدام مع كود كلود

يدعم Claude Code إضافات LSP. لتكوين Bicep language intelligence، أضف الكود التالي إلى إضافتك.lsp.json:

{
  "bicep": {
    "command": "bicep-ls",
    "extensionToLanguage": {
      ".bicep": "bicep",
      ".bicepparam": "bicep"
    }
  }
}

لمزيد من المعلومات، راجع خوادم LSP في وثائق كود كلود.

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