Bicep araçlarını yükleme

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
Yazar	VS Code ve Bicep uzantısı	otomatik
	Visual Studio ve Bicep uzantısı	otomatik
Dağıt	Azure CLI	otomatik
	Azure PowerShell	El ile
	VS 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 VS Code düzenleyicisinden dağıtabilirsiniz. Daha fazla bilgi için bkz . Visual Studio Code'dan Bicep dosyalarını 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:

   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 . Bicep olarak yapıştırma.
   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'daki 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. 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ı yüklemek veya güncelleştirmek için bkz:

• Windows'a Azure CLI yükleme
• Linux'a Azure CLI yükleme
• macOS'a Azure CLI 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 ş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önetilen konumdan 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.

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 üzerinin yüklenmesi 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

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

• macOS

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

• Windows

  1. Bicep-win-x64.exe Bicep yayın sayfasından havayla eşlenmeyen bir ortamda indirin.
  2. 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 trueayarlamanı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 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.