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:

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:

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. 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:

1. Dosya menüsünden Tercihler'i ve ardından Ayarlar'ı seçin.

2. 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:

• Windows’a yükle
• Linux'a yükleme
• MacOS’ta 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.

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.

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!

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!

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.

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.