تثبيت أدوات Bicep

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

المهام الخيارات تثبيت Bicep CLI
المؤلف VS Code وملحق Bicep تلقائي
ملحق Visual Studio وBicep تلقائي
نشر Azure CLI تلقائي
Azure PowerShell يدوي
VS Code وملحق Bicep يدوي
السحب غير المتصلة تنزيل

تحذير

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

Visual Studio Code وملحق Bicep

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

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

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

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

    حدد تثبيت.

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

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

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

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

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

تكوين ملحق Bicep

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

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

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

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

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

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

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

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

  1. من File القائمة، حدد Preferences، ثم حدد Settings.

  2. قم بتوسيع Extensions، ثم حدد 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.

هام

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

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

Azure PowerShell

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

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

هام

لا يكون المثيل المستقل لـ Bicep 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. يستخدم جميع الأمثلة التالية موقعاً باسم bicep أو .bicep. لا يتعارض هذا الموقع مع الموقع المُدار بواسطة واجهة سطر الأوامر في Azure، والذي يستخدم .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!

إشعار

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

macOS

عبر HomeBrew

# Add the tap for bicep
brew tap azure/bicep

# Install the tool
brew install bicep

عبر BASH

# 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!

إشعار

تثبيت 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 للإصدار التجريبي قبل إصدارها، فراجع تثبيت البنيات الليلية.

تحذير

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

تثبيت حزمة NuGet

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

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

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

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

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

لنشر ملفات Bicep من Azure Pipeline، راجع دمج Bicep مع Azure Pipeline. لنشر ملفات Bicep من خلال إجراءات GitHub، راجع نشر ملفات Bicep باستخدام إجراءات GitHub.