Bicep araçlarını yükleme

Şimdi ortamınızın Bicep dosyalarıyla çalışmak için ayarlandığından emin olalım. 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	VS Code ve Bicep uzantısı	otomatik
	Visual Studio ve Bicep uzantısı	otomatik
Dağıtma	Azure CLI	otomatik
	Azure PowerShell	El ile
	VS Code ve Bicep uzantısı	El ile
	Hava ile kaplı bulut	indirin

Visual Studio Code ve Bicep uzantısı

Bicep dosyaları oluşturmak için iyi bir Bicep düzenleyicisine ihtiyacınız vardır. Şunları öneririz:

• Visual Studio Code - Henüz Visual Studio Code yoksa yükleyin.

• Visual Studio Code için Bicep uzantısı. Bicep uzantısıyla 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 marketindebicep araması 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 VS Code düzenleyicisinden dağıtabilirsiniz. Daha fazla bilgi için bkz. bicep dosyalarını Visual Studio Code dağıtma.

Bicep uzantısını yapılandırma

Ayarları görmek için:

1. Menüden View öğesini seçin Extensions.

2. Uzantı listesinden öğesini seçin Bicep .

3. Sekmeyi FEATURE CONTRIBUTIONS seçin:

   

   Bicep uzantısı şu ayarlara ve varsayılan değerlere sahiptir:

   ID	Varsayılan değer	Description
   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 döndürmek için Geri Al'ı kullanın). Daha fazla bilgi için bkz. Bicep Olarak Yapıştır.
   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ının erişebildiği tüm kapsayıcı kayıt defterleri için Azure'ı sorgula (yavaş olabilir). Bu seçenek kapalıysa, yalnızca bicepconfig.json dosyasında moduleAliases 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:

1. Menüden File öğesini ve Preferencesardından öğesini seçin Settings.

2. öğesini genişletin Extensionsve ardından öğesini seçin Bicep:

   

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. Visual Studio Market'ten uzantıyı 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 kaynak koda 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ı yüklemek veya güncelleştirmek için bkz:

• Windows'da Azure CLI'yi yükleme
• Linux'ta Azure CLI'yi yükleme
• macOS’ta Azure CLI'yi yükleme

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 şunu kullanın:

az bicep version

En son sürüme yükseltmek için şunu kullanın:

az bicep upgrade

Diğer komutlar için bkz . Bicep CLI.

Önemli

Azure CLI, Bicep CLI'nın 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 bitti. 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. yükleme Azure PowerShell.

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'nın kendi kendine bulunan ö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
• macOS
• Windows

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.

Mac OS

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 veya üzerinin yüklenmesi için Gatekeeper ö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 indirin ve ç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.

Çikolatalı

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!

Havadan 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 yerdir.

• Linux

  1. Bicep yayın sayfasındanbicep-linux-x64'i havayla eşlenmeyen bir ortamda indirin.
  2. Yürütülebilir dosyayı havayla eşlenmiş bir makinede $HOME/.azure/bin dizinine kopyalayın. Dosyayı bicep olarak yeniden adlandırın.

• macOS

  1. Bicep yayın sayfasındanbicep-osx-x64'i havayla eşlenmeyen bir ortamda indirin.
  2. Yürütülebilir dosyayı havayla eşlenmiş bir makinede $HOME/.azure/bin dizinine kopyalayın. Dosyayı bicep olarak yeniden adlandırın.

• Windows

  1. bicep-win-x64.exeBicep yayın sayfasından havayla eşlenmeyen bir ortamda indirin.
  2. Yürütülebilir dosyayı havayla eşlenmiş bir makinede %UserProfile%/.azure/bin dizinine kopyalayın. dosyayı bicep.exeolarak yeniden adlandırın.

Azure CLI görevini havadan eşlenen bulutta kullanırken, görevin özelliğini olarak trueayarlamanız useGlobalConfig gerekir. false varsayılan değerdir. Ö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 olsa da desteklenen bir paket değildir. Bu pakete alacağınız tüm bağımlılıklar sizin riskinize göre yapılır ve bu pakete herhangi bir zamanda hataya neden olan değişiklikler gönderme hakkını saklıyız.

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 sorunlarınız varsa bkz. Bicep yükleme sorunlarını giderme.

Bicep dosyalarını Azure Pipelines'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.