Bicep araçlarını yükleyin

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:

Tasks	Options	Bicep CLI yüklemesi
Author	Visual Studio Code ve Bicep uzantısı	automatic
	Visual Studio ve Bicep uzantısı	automatic
Deploy	Azure CLI	automatic
	Azure PowerShell	manual
	Visual Studio Code ve Bicep uzantısı	manual
	Havayla kaplı bulut	download

Warning

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 bir hata alırsanız, Bicep yükleme sorunlarını giderme bölümüne bakın.

Bicep dosyalarınızı doğrudan Visual Studio Code düzenleyicisinden dağıtabilirsiniz. Daha fazla bilgi için Visual Studio Code ile Bicep dosyalarını dağıtma bölümüne bakın.

Bicep uzantısını yapılandırın

Ayarları görmek için:

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

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

3. FEATURE sekmesini seçin.

4. Ayarlarseçin.

   

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

   ID	Varsayılan değer	Description
   bicep.completions.getAllAccessibleAzureContainerRegistries	false	'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.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).
   bicep.enableOutputTimestamps	true	Bicep İşlemleri çıkış kanalında görüntülenen her satırın başına bir zaman damgası ekleyin.
   bicep.enableSurveys	true	Bicep uzantısını geliştirmemize yardımcı olacak geri bildirim toplamak için ara sıra anketleri etkinleştirin.
   bicep.suppressedWarnings		'Bir daha gösterme' düğmesine basıldığından gizlenen uyarılar. Sıfırlanması gereken öğeleri kaldırın.
   bicep.trace.server	off	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. Uzantılar'ı genişletin ve Bicep'i seçin:

   

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.

Öğreticiyi tamamlamak 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.

Important

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'yi el ile yüklemeniz gerekir.

Important

Azure CLI tarafından yüklenen Bicep CLI'nin kendi kendine bulunan örneği PowerShell komutları için 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 bicep söz dizimi ile az 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!

Note

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!

Note

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'nin günlük yapıları hala istisna 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.

Chocolatey

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!

Fiziksel olarak izole edilmiş buluta yükleme

bicep install ve bicep upgrade komutları havayla kaplı bir ortamda çalışmaz. Bicep CLI'yi havasız ağ ortamına yüklemek için, Bicep CLI yürütülebilir dosyasını manuel olarak 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'ü internet bağlantısı olan bir ortamda indirin.
  2. İnternet bağlantısı olmayan bir makinedeki yürütülebilir dosyayı $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ı internet bağlantısı olmayan bir ortamda indirin.
  2. İnternet bağlantısı olmayan bir makinedeki yürütülebilir dosyayı $HOME/.azure/bin dizinine kopyalayın. Dosyayı bicep olarak yeniden adlandırın.

• Windows

  1. Bicep-win-x64.exe dosyasını Bicep yayın sayfasından ağ bağlantısı olan bir ortamda indirin.
  2. Yürütülebilir dosyayı internet bağlantısı bulunmayan bir makinede %UserProfile%/.azure/bin dizinine kopyalayın. Dosyayı bicep.exe olarak yeniden adlandırın.

Azure CLI görevini hava boşluklu bulutta kullanırken, görevin özelliğini olarak useGlobalConfig ayarlamanız gerekir. Varsayılan değer şudur: false. Örnek için Azure Pipelines ve Bicep dosyaları ile CI/CD'ye bakın.

Gecelik derlemeleri yükleyin

Yayınlanmadan önce Bicep'in en son ön sürüm parçalarını denemek isterseniz Gecelik derlemeleri yükleyin kısmına bakın.

Warning

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 Microsoft bu pakete herhangi bir zamanda hataya neden olan değişiklikler gönderme hakkını saklıdır.

NuGet paketlerini yükleme ve kullanma hakkında daha fazla bilgi için bkz. Paket tüketimi iş akışı.

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 Bicep yüklemesi sorunlarını giderme bölümüne bakın.
• Bicep dosyalarını Azure Pipeline'dan dağıtmak için bkz Hızlı Başlangıç: Bicep'i Azure Pipelines ile tümleştirme. GitHub Actions aracılığıyla Bicep dosyalarını dağıtmak için bkz . Hızlı Başlangıç: GitHub Actions kullanarak Bicep dosyalarını dağıtma.