Bicep nedir?

Bicep, Azure kaynaklarını dağıtmak için bildirim temelli söz dizimi kullanan etki alanına özgü bir dildir. Bicep dosyasında, Azure'a dağıtmak istediğiniz altyapıyı tanımlarsınız ve sonra bu altyapıyı sürekli dağıtmak için geliştirme yaşam döngüsü boyunca bu dosyayı kullanırsınız. Kaynaklarınız tutarlı bir şekilde dağıtılır.

Bicep kısa söz dizimi, güvenilir tür güvenliği ve kodu yeniden kullanma desteği sağlar. Bicep, Azure'daki kod olarak altyapı çözümleriniz için birinci sınıf bir yazma deneyimi sunar.

Bicep'in avantajları

Bicep aşağıdaki avantajları sağlar:

• Tüm kaynak türleri ve API sürümleri için destek: Bicep, Azure hizmetleri için tüm önizleme ve GA sürümlerini hemen destekler. Bir kaynak sağlayıcısı yeni kaynak türlerini ve API sürümlerini kullanıma sunar sunmaz bunları Bicep dosyanızda kullanabilirsiniz. Yeni hizmetleri kullanmadan önce araçların güncelleştirilmesini beklemeniz gerekmez.

• Basit söz dizimi: Eşdeğer JSON şablonuyla karşılaştırıldığında, Bicep dosyaları daha kısadır ve daha kolay okunur. Bicep, programlama dilleri hakkında önceden bilgi sahibi olmayı gerektirmez. Bicep söz dizimi bildirim temellidir ve dağıtmak istediğiniz kaynakları ve kaynak özelliklerini belirtir.

  Aşağıdaki örneklerde Bicep dosyası ile eşdeğer JSON şablonu arasındaki fark gösterilmektedir. Her iki örnek de depolama hesabı dağıtır:

  • Bicep
  • JSON

  param location string = resourceGroup().location
  param storageAccountName string = 'toylaunch${uniqueString(resourceGroup().id)}'
  
  resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
    name: storageAccountName
    location: location
    sku: {
      name: 'Standard_LRS'
    }
    kind: 'StorageV2'
    properties: {
      accessTier: 'Hot'
    }
  }
  

• Yazma deneyimi: Bicep dosyalarınızı oluşturmak için VS Code için Bicep Uzantısı'nı kullandığınızda birinci sınıf bir yazma deneyimi elde edersiniz. Düzenleyici zengin tür güvenliği, IntelliSense ve söz dizimi doğrulaması sağlar.

  

  Visual Studio için Bicep uzantısıyla Visual Studio'da Bicep dosyaları da oluşturabilirsiniz.

• Yinelenebilir sonuçlar: Altyapınızı geliştirme yaşam döngüsü boyunca kaynaklarınızın tutarlı bir şekilde dağıtıldığından güvenle dağıtın. Bicep dosyaları bir kez etkili olur, yani aynı dosyayı birçok kez dağıtabilir ve aynı kaynak türlerini aynı durumda alabilirsiniz. Güncelleştirmeleri temsil eden çok sayıda ayrı dosya geliştirmek yerine istenen durumu temsil eden bir dosya geliştirebilirsiniz. Örneğin, aşağıdaki dosya bir depolama hesabı oluşturur. Belirtilen özellikler zaten mevcut olduğunda bu şablonu ve depolama hesabını dağıtırsanız, değişiklikler yapılmaz:

  • Bicep
  • JSON

  param location string = resourceGroup().location
  
  resource mystore 'Microsoft.Storage/storageAccounts@2023-05-01' = {
    name: 'mystorageaccount'
    location: location
    sku: {
      name: 'Standard_LRS'
    }
    kind: 'StorageV2'
  }
  

• Düzenleme: İşlemleri sıralamanın karmaşıklıkları konusunda endişelenmeniz gerekmez. Resource Manager, birbirine bağlı kaynakların doğru sırada oluşturulması için dağıtımını düzenler. Mümkün olduğunda Resource Manager kaynakları paralel olarak dağıtır ve bu da dağıtımlarınızın seri dağıtımlardan daha hızlı bitimine yardımcı olur. Dosyayı birden çok kesinlik temelli komut yerine tek bir komutla dağıtırsınız.

  

• Modülerlik: Bicep kodunuzu yönetilebilir parçalara ayırmak için modülleri kullanın. Modüller kodu yeniden kullanmanıza ve geliştirmeyi basitleştirmenize yardımcı olur. Modül, bir dizi ilgili kaynağı dağıtır. Bu kaynakları dağıtmanız gerektiğinde Bicep dosyasına modül ekleyin.

• Azure hizmetleriyle tümleştirme: Bicep, Azure İlkesi, şablon özellikleri ve Azure Blueprints gibi Azure hizmetleriyle tümleştirilir.

• Değişiklikleri önizleme: Bicep dosyasını dağıtmadan önce değişiklikleri önizlemek için durum işlemini kullanabilirsiniz. Durum işlemi, hangi kaynakların oluşturulacağını, güncelleştirileceğini veya silineceğini ve değiştirilecek kaynak özelliklerini gösterir. Ayrıca ortamınızın geçerli durumunu denetler ve bu durumu yönetme gereksinimini ortadan kaldırır.

• Yönetecek durum veya durum dosyası yok: Azure tüm durumu depolar. Başkalarıyla işbirliği yapabilir ve güncelleştirmelerinizin beklendiği gibi ele alınacağından emin olabilirsiniz.

• Ücretsiz ve açık kaynak: Bicep ücretsiz olduğundan premium özellikler için ödeme yapmak zorunda değilsiniz. Microsoft Desteği destekliyor.

Kullanmaya başlayın

Bicep’i kullanmaya başlamak için:

1. Araçları yükleyin. Daha fazla bilgi için bkz. Bicep geliştirme ve dağıtım ortamlarını ayarlama veya önceden yapılandırılmış bir yazma ortamı almak için VS Code devcontainer/Codespaces deposunu kullanma.
2. Bicep için Hızlı Başlangıç ve Öğrenme modüllerini tamamlayın.

Var olan bir Resource Manager şablonunu Bicep'e derlemek için bkz . ARM şablonu JSON'yi Bicep'e derleme. Bicep'i ve onun eşdeğeri olan JSON'ı yan yana görüntülemek için Bicep Playground'ı kullanabilirsiniz.

Bicep dosyanızda bulunan kaynaklar hakkında bilgi edinmek için bkz. Bicep kaynak başvurusu.

Bicep örneklerini Bicep GitHub deposunda bulabilirsiniz.

Dil hakkında

Bicep, uygulama yazmak için genel bir programlama dili olarak tasarlanmamıştır. Bicep dosyası, azure kaynaklarını ve kaynak özelliklerini oluşturmak için bir dizi programlama komutu yazmadan bildirir.

Bicep çalışmasının durumunu izlemek için bkz . Bicep proje deposu.

Bicep hakkında bilgi edinmek için aşağıdaki videoyu izleyin:

Resource Manager şablonları geliştirmek için JSON yerine Bicep kullanabilirsiniz. Resource Manager şablonu oluşturmak için JSON söz dizimi ayrıntılı olabilir ve karmaşık ifadeler gerektirebilir. Bicep söz dizimi bu karmaşıklığı azaltır ve geliştirme deneyimini geliştirir. Bicep, Bir Resource Manager JSON şablonunun özelliklerini kaybetmeyen saydam bir soyutlamadır. Dağıtım sırasında Bicep CLI, bir Bicep dosyasını Resource Manager JSON şablonuna dönüştürür.

Resource Manager şablonunda geçerli olan kaynak türleri, API sürümleri ve özellikler bicep dosyasında geçerlidir.

Bicep, eşdeğeri olan JSON ile karşılaştırıldığında daha kolay ve daha kısa bir söz dizimi sunar. Köşeli ayraçlı ifadeler [...]kullanmazsınız. Bunun yerine, doğrudan işlevleri çağırır ve parametrelerden ve değişkenlerden değerler alırsınız. Dağıtılan her kaynağa sembolik bir ad verirsiniz ve bu da şablonunuzda bu kaynağa başvurmayı kolaylaştırır.

Söz diziminin tam karşılaştırması için bkz . Şablonlar için JSON ve Bicep karşılaştırması.

Bicep, kaynaklar arasındaki bağımlılıkları otomatik olarak yönetir. Bir kaynağın sembolik adı başka bir kaynak bildiriminde kullanıldığında ayarını dependsOn yapmaktan kaçınabilirsiniz.

Bicep dosyasının yapısı JSON şablonundan daha esnektir. Parametreleri, değişkenleri ve çıkışları dosyanın herhangi bir yerinde bildirebilirsiniz. JSON'da, şablonun ilgili bölümleri içinde tüm parametreleri, değişkenleri ve çıkışları bildirmeniz gerekir.

Destek alın

Azure Resource Manager (ARM) şablonuyla ilgili sorunlar için destek bileti açma adımları şunlardır:

1. Azure portalını açın.

2. Sağ üst köşedeki Destek + Sorun Giderme simgesini seçin.

3. Sorunu kısaca açıklayın bölümüne ARM şablonu yazın ve Git'i seçin.

4. Hangi hizmetle sorun yaşıyorsunuz? bölümünde İzleme ve Yönetim'in altında Portal'ı ve ardından İleri'yi seçin.

5. Bir abonelik seçin ve ardından İleri'yi seçin.

6. ARM şablonlarıyla ilgili sorun'a ve ardından İleri'ye tıklayın.

   

Sonraki adımlar

Başlamak için Hızlı Başlangıç'a bakın.

Sık sorulan soruların yanıtları için bkz . Bicep için sık sorulan sorular.