Bicep araçlarını yükleme
Ortamınızı Bicep dosyalarıyla çalışmaya hazırlayın. Bicep dosyalarını yazmak ve dağıtmak için aşağıdaki seçeneklerden birini öneririz:
Görevler | Seçenekler | Bicep CLI yüklemesi |
---|---|---|
Yazma | Visual Studio Code ve Bicep uzantısı | otomatik |
Visual Studio ve Bicep uzantısı | otomatik | |
Dağıtma | Azure CLI | otomatik |
Azure PowerShell | El ile | |
Visual Studio Code ve Bicep uzantısı | El ile | |
Havayla kaplı bulut | download |
Uyarı
Rosetta2 ve QEMU gibi öykünme araçları genellikle mimariye mükemmel şekilde öykünmediğinden, Bicep CLI'nin öykünülmüş ortamlardaki kararlılığı garanti edilemez.
Visual Studio Code ve Bicep uzantısı
Bicep dosyaları oluşturmak için iyi bir Bicep düzenleyicisi gerekir. Şunları öneririz:
Visual Studio Code - Henüz Visual Studio Code'nuz yoksa yükleyin.
Visual Studio Code için Bicep uzantısı. Bicep uzantısına sahip Visual Studio Code, dil desteği ve kaynak otomatik tamamlama sağlar. Uzantı, Bicep dosyalarını oluşturmanıza ve doğrulamanıza yardımcı olur.
Uzantıyı yüklemek için Uzantılar sekmesinde veya Visual Studio marketinde biceparaması yapın.
Yükle'yi seçin.
Uzantıyı yüklediğinizi doğrulamak için dosya uzantısına .bicep
sahip herhangi bir dosyayı açın. Sağ alt köşedeki dil modunun Bicep olarak değiştiğini görmeniz gerekir.
Yükleme sırasında hata alırsanız bkz . Bicep yükleme sorunlarını giderme.
Bicep dosyalarınızı doğrudan Visual Studio Code düzenleyicisinden dağıtabilirsiniz. Daha fazla bilgi için bkz . Visual Studio Code ile Bicep dosyalarını dağıtma.
Bicep uzantısını yapılandırma
Ayarları görmek için:
Menüden
View
öğesini seçinExtensions
.Uzantı listesinden öğesini seçin
Bicep
.Sekmeyi
FEATURE CONTRIBUTIONS
seçin:Bicep uzantısı şu ayarlara ve varsayılan değerlere sahiptir:
Kimlik Varsayılan değer Açıklama bicep.decompileOnPaste true Yapıştırılan JSON değerlerini, JSON ARM şablonlarını veya kaynaklarını bir JSON ARM şablonundan Bicep'e otomatik olarak dönüştürün (geri almak için Geri Al'ı kullanın). Daha fazla bilgi için Bkz. JSON'yi Bicep Olarak Yapıştır komutu. bicep.enableOutputTimestamps true Bicep İşlemleri çıkış kanalında görüntülenen her satırın başına bir zaman damgası ekleyin. bicep.suppressedWarnings 'Bir daha gösterme' düğmesine basıldığından gizlenen uyarılar. Sıfırlanması gereken öğeleri kaldırın. bicep.enableSurveys true Bicep uzantısını geliştirmemize yardımcı olacak geri bildirim toplamak için ara sıra anketleri etkinleştirin. bicep.completions.getAllAccessibleAzureContainerRegistries yanlış 'br:' modül başvurularını tamamlarken, kullanıcı tarafından erişilebilen tüm kapsayıcı kayıt defterleri için Azure'ı sorgulayabilirsiniz (yavaş olabilir). Bu seçenek kapalıysa, yalnızca bicepconfig.json dosyalarındakimoduleAliases altında yapılandırılan kayıt defterleri listelenir. bicep.trace.server kapalı Bicep dil sunucusuna gönderilen iletilerin izlemeyi yapılandırın.
Ayarları yapılandırmak için:
Dosya menüsünden Tercihler'i ve ardından Ayarlar'ı seçin.
Bicep'i seçmek için Uzantılar'ı genişletin:
Visual Studio ve Bicep uzantısı
Visual Studio'dan Bicep dosyası yazmak için şunları yapmanız gerekir:
- Visual Studio - Henüz Visual Studio'nuz yoksa yükleyin.
- Visual Studio için Bicep uzantısı. Bicep uzantısına sahip Visual Studio, dil desteği ve kaynak otomatik tamamlama sağlar. Uzantı, Bicep dosyalarını oluşturmanıza ve doğrulamanıza yardımcı olur. Uzantıyı Visual Studio Market'ten yükleyin.
Öğreticide yol göstermesi için bkz . Hızlı Başlangıç: Visual Studio ile Bicep dosyaları oluşturma.
Azure CLI
Azure CLI'yı Bicep ile kullandığınızda, Bicep dosyalarını dağıtmak ve derlemek için ihtiyacınız olan her şeye sahip olursunuz. Azure CLI, ihtiyacı olan bir komut yürütürken Bicep CLI'yi otomatik olarak yükler.
Azure CLI sürüm 2.20.0 veya üzeri yüklü olmalıdır. Azure CLI'yı farklı işletim sistemlerine yüklemek veya güncelleştirmek için bkz:
Geçerli sürümünüzü doğrulamak için şunu çalıştırın:
az --version
Bicep CLI yüklemenizi doğrulamak için şunları kullanın:
az bicep version
En son sürüme yükseltmek için şunu kullanın:
az bicep upgrade
Daha fazla komut için bkz . Bicep CLI.
Önemli
Azure CLI, Bicep CLI'nin bağımsız bir örneğini yükler. Bu örnek, el ile yüklemiş olabileceğiniz sürümlerle çakışmaz. Azure CLI, Bicep CLI'yi PATH'inize eklemez.
Bicep ortamınızı ayarlama işleminiz tamamlandı. Bu makalenin geri kalanında Azure CLI kullanırken ihtiyacınız olmayan yükleme adımları açıklanmaktadır.
Azure PowerShell
Azure PowerShell sürüm 5.6.0 veya üzeri yüklü olmalıdır. Güncelleştirmek veya yüklemek için bkz . Azure PowerShell'i yükleme.
Azure PowerShell, Bicep CLI'yi otomatik olarak yüklemez. Bunun yerine, Bicep CLI'yı el ile yüklemeniz gerekir.
Önemli
Azure CLI tarafından yüklenen Bicep CLI'nin bağımsız örneği PowerShell komutlarına kullanılamaz. Bicep CLI'yi el ile yüklemediyseniz Azure PowerShell dağıtımları başarısız olur.
Bicep CLI'yı el ile yüklediğinizde, Azure CLI söz dizimi yerine az bicep
söz dizimi ile bicep
Bicep komutlarını çalıştırın.
Bicep CLI sürümünüzü denetlemek için şunu çalıştırın:
bicep --version
El ile yükleme
Aşağıdaki yöntemler Bicep CLI'sini yükler ve PATH'inize ekler. Azure CLI dışında herhangi bir kullanım için el ile yüklemeniz gerekir.
El ile yüklerken, Azure CLI tarafından yönetilenden farklı bir konum seçin. Aşağıdaki örneklerin tümü bicep veya .bicep adlı bir konum kullanır. Bu konum, .azure kullanan Azure CLI tarafından yönetilen konumla çakışmaz.
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!
Not
Alpine gibi basit Linux dağıtımları için önceki betikte bicep-linux-x64 yerine bicep-linux-musl-x64 kullanın.
macOS
Homebrew aracılığıyla
# Add the tap for bicep
brew tap azure/bicep
# Install the tool
brew install bicep
BASH aracılığıyla
# 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!
Not
Bicep CLI sürüm 0.16.X veya üzeri bir yükleme için Ağ Geçidi Denetleyicisi özel durumu gerekmez. Ancak, Bicep CLI'nın her gece yapılan derlemeleri yine de özel durum gerektirir.
Windows
Windows Installer
En son Windows yükleyicisini indirip çalıştırın. Yükleyici yönetici ayrıcalıkları gerektirmez. Yüklemeden sonra Bicep CLI, kullanıcı PATH'inize eklenir. PATH değişikliğinin etkili olması için açık komut kabuğu pencerelerini kapatın ve yeniden açın.
Çikolata rengi
choco install bicep
Winget
winget install -e --id Microsoft.Bicep
PowerShell ile el ile
# 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!
Hava ile eşlenen buluta yükleme
bicep install
ve bicep upgrade
komutları havayla kaplı bir ortamda çalışmaz. Bicep CLI'yi havayla eşlenen bir ortama yüklemek için Bicep CLI yürütülebilir dosyasını el ile indirmeniz ve .azure/bin'e kaydetmeniz gerekir. Bu konum, Azure CLI tarafından yönetilen örneğin yüklendiği konumdur.
Linux
macOS
Windows
- Bicep-win-x64.exe Bicep yayın sayfasından havayla eşlenmeyen bir ortamda indirin.
- Yürütülebilir dosyayı havayla eşlenen bir makinede %UserProfile%/.azure/bin dizinine kopyalayın. Dosyayı bicep.exe olarak yeniden adlandırın.
Azure CLI görevini havayla eşlenen bulutta kullanırken, görevin özelliğini olarak true
ayarlamanız useGlobalConfig
gerekir. Varsayılan değer şudur: false
. Örnek için bkz . Azure Pipelines ve Bicep dosyaları ile CI/CD.
Gecelik derlemeleri yükleme
Yayınlanmadan önce Bicep'in en son yayın öncesi bitlerini denemek isterseniz bkz . Gecelik derlemeleri yükleme.
Uyarı
Bu yayın öncesi derlemelerde bilinen veya bilinmeyen hatalar olması çok daha olasıdır.
NuGet paketini yükleme
Bicep ekibi, Azure.Bicep.Core NuGet paketini nuget.org'da genel kullanıma sunmunu sağladı. Genel kullanıma açık olsa da desteklenen bir paket değildir. Bu pakete yaptığınız tüm bağımlılıklar riski size aittir ve bu pakete herhangi bir zamanda hataya neden olan değişiklikleri gönderme hakkımızı saklıyoruz.
NuGet paketlerini yükleme ve kullanma hakkında daha fazla bilgi için bkz . Paketleri kullanma.
Sonraki adımlar
Visual Studio Code ve Bicep uzantısını kullanma hakkında daha fazla bilgi için bkz . Hızlı Başlangıç: Visual Studio Code ile Bicep dosyaları oluşturma.
Bicep yüklemenizle ilgili sorun yaşıyorsanız bkz . Bicep yükleme sorunlarını giderme.
Bicep dosyalarını azure pipeline'dan dağıtmak için bkz . Bicep'i Azure Pipelines ile tümleştirme. Bicep dosyalarını GitHub Actions aracılığıyla dağıtmak için bkz . GitHub Actions kullanarak Bicep dosyalarını dağıtma.