Visual Studio Code kullanarak Bicep dosyaları oluşturma

Makale
07/18/2024

Bu makalede, Bicep dosyaları oluşturmak için Visual Studio Code'un nasıl kullanılacağı gösterilmektedir.

VS Code yükleme

Ortamınızı Bicep geliştirme için ayarlamak için bkz . Bicep araçlarını yükleme. Bu adımları tamamladıktan sonra Visual Studio Code ve Bicep uzantısına sahip olursunuz. Ayrıca en son Azure CLI veya en son Azure PowerShell modülüne de sahipsiniz.

Bicep komutları

Visual Studio Code birkaç Bicep komutuyla birlikte gelir.

VS Code'da bir Bicep dosyası açın veya oluşturun, Görünüm menüsünü ve ardından Komut Paleti'ni seçin. Komut paletini açmak için F1 veya Ctrl+Shift+P tuş bileşimini de kullanabilirsiniz. Bicep komutlarını listelemek için Bicep yazın.

Komut paletindeki Visual Studio Code Bicep komutlarının ekran görüntüsü.

Bu komutlar şunlardır:

ARM Şablonu Oluşturma
Bicep Yapılandırma Dosyası Oluşturma
Bicep'e kaynak koda dönüştürme
Bicep Dosyasını Dağıtma
Parametre Dosyası Oluştur
Kubernetes Bildirimini İçeri Aktarma (önizleme)
Kaynak Ekle
Bicep Görselleştiricisi'nin açılması
Bicep Görselleştiricisi'ni yan tarafa açma
Bicep Modüllerini Geri Yükleme (Zorla)

Bu komutlar, bir Bicep dosyasına sağ tıkladığınızda bağlam menüsünde de gösterilir:

Bir JSON dosyasına sağ tıkladığınızda:

ARM şablonu oluşturma

Komutu, build bicep dosyasını Azure Resource Manager şablonuna (ARM şablonu) dönüştürür. Yeni JSON şablonu aynı dosya adıyla aynı klasörde depolanır. Aynı dosya adına sahip bir dosya varsa, eski dosyanın üzerine yazar. Daha fazla bilgi için bkz . Bicep CLI komutları.

Bicep yapılandırma dosyası oluşturma

Bicep yapılandırma dosyası (bicepconfig.json), Bicep geliştirme deneyiminizi özelleştirmek için kullanılabilir. Birden çok dizin ekleyebilirsiniz bicepconfig.json . Dizin hiyerarşisindeki bicep dosyasına en yakın yapılandırma dosyası kullanılır. Bu komutu seçtiğinizde, uzantı bir klasör seçmeniz için bir iletişim kutusu açar. Varsayılan klasör, Bicep dosyasını depoladığınız klasördür. Klasörde zaten bir bicepconfig.json dosya varsa, var olan dosyanın üzerine yazabilirsiniz.

Bicep yapılandırma dosyası oluşturmak için:

Visual Studio Code'u açın.
Görünüm menüsünden Komut Paleti'ni seçin (veya Ctrl/Cmd+Shift+P tuşlarına basın) ve ardından Bicep: Bicep Yapılandırma Dosyası Oluştur'u seçin.
Dosyayı yerleştirmek istediğiniz dosya dizinini seçin.
İşiniz bittiğinde yapılandırma dosyasını kaydedin.

Bicep'e kaynak koda dönüştürme

Bu komut, ARM JSON şablonunu bir Bicep dosyasına derler ve ARM JSON şablonuyla aynı dizine yerleştirir. Yeni dosya , .bicep uzantısıyla aynı dosya adına sahiptir. Aynı klasörde aynı dosya adına sahip bir Bicep dosyası zaten varsa, Visual Studio Code varolan dosyanın üzerine yazmanızı veya bir kopya oluşturmanızı ister.

Bicep dosyasını dağıtma

Bicep dosyalarını doğrudan Visual Studio Code'dan dağıtabilirsiniz. Komut paletinden veya bağlam menüsünden Bicep dosyasını dağıt'ı seçin. Uzantı sizden Azure'da oturum açmanızı, aboneliği seçmenizi, kaynak grubu oluşturmanızı/seçmenizi ve parametre değerlerini girmenizi ister.

Not

Vscode içindeki Bicep deploy komutu kimlik doğrulaması için Azure Hesabı uzantısını kullanır. bicepconfig.json bulut profillerini kullanmaz.

Parametre dosyası oluşturma

Bu komut, Bicep dosyasıyla aynı klasörde bir parametre dosyası oluşturur. Bicep parametre dosyası veya JSON parametre dosyası oluşturmayı seçebilirsiniz. Yeni Bicep parametre dosya adı olurken <bicep-file-name>.bicepparam, yeni JSON parametre dosya adı şeklindedir <bicep-file-name>.parameters.json.

Kubernetes bildirimini içeri aktarma (Önizleme)

Bu komut bir Kubernetes bildirim dosyasını içeri aktarır ve bir Bicep modülü oluşturur. Daha fazla bilgi için bkz . Bicep genişletilebilirlik Kubernetes sağlayıcısı ve Hızlı Başlangıç: Bicep Kubernetes sağlayıcısını (Önizleme) kullanarak Azure uygulamalarını Azure Kubernetes Service (AKS) kümesine dağıtma.

Kaynak ekle

komutu, insert resource var olan bir kaynağın kaynak kimliğini sağlayarak Bicep dosyasına bir kaynak bildirimi ekler. Kaynak Ekle'yi seçtikten sonra komut paletine kaynak kimliğini girin. Kaynağın eklenmesi birkaç dakika sürer.

Kaynak kimliğini şu yöntemlerden birini kullanarak bulabilirsiniz:

Visual Studio Code için Azure Kaynak uzantısını kullanın.
Azure portalını kullanın.
Azure CLI veya Azure PowerShell kullanın:
- CLI
- PowerShell
```
az resource list
```
```
Get-AzResource
```

Şablon dışarı aktarma işlemine benzer şekilde işlem, kullanılabilir bir kaynak oluşturmaya çalışır. Ancak eklenen kaynakların çoğu, Azure kaynaklarını dağıtmak için kullanılmadan önce bazı değişiklikler yapılmasını gerektirir.

Daha fazla bilgi için bkz . ARM şablonu JSON'yi Bicep'e derleme.

Bicep görselleştiriciyi açma

Görselleştirici, Kaynak bağımlılığı bilgileriyle Bicep dosyasında tanımlanan kaynakları gösterir. Diyagram, Linux sanal makinesi Bicep dosyasının görselleştirmesidir.

Görselleştiriciyi Bicep dosyasıyla yan yana da açabilirsiniz.

Bicep modüllerini geri yükleme

Bicep dosyanız bir kayıt defterinde yayımlanan modülleri kullandığında, geri yükleme komutu kayıt defterinden tüm gerekli modüllerin kopyalarını alır. Bu kopyaları yerel önbellekte depolar. Daha fazla bilgi için bkz . geri yükleme.

Görünüm türü belgesi

Visual Studio Code'da, üzerinde çalıştığınız kaynak türü için şablon başvuruyu açabilirsiniz. Bunu yapmak için imlecinizi kaynak sembolik adının üzerine getirin ve görünüm türü belgesini seçin.

Visual Studio Code Bicep görünüm türü belgesinin ekran görüntüsü.

Tanıma git

Modül tanımlarken, başvuruda bulunılan dosyanın türlerine bakılmaksızın ( yerel bir dosya, modül kayıt defteri dosyası, şablon belirtimi olsun), modül yolunu seçerek veya vurgulayarak başvuruda bulunılan dosyayı açabilir ve [F12] tuşuna basabilirsiniz. Başvuruda bulunılan dosya bir Azure Doğrulanmış Modüller (AVM) ise, derlenmiş JSON veya Bicep dosyası arasında geçiş yapabilirsiniz. Özel bir kayıt defteri modülünün Bicep dosyasını açabilmek için modülün anahtar etkin olarak kayıt defterinde yayımlandığından WithSource emin olun. Daha fazla bilgi için bkz . Dosyaları kayıt defterinde yayımlama. Visual Studio Code Bicep uzantısı sürüm 0.27.1 veya üzeri, özel modül kayıt defterinden Bicep dosyasını açmak için gereklidir.

Bicep olarak yapıştır

ARM şablonundan Bicep dosyasına JSON kod parçacığı yapıştırabilirsiniz. Visual Studio Code, JSON'ı otomatik olarak Bicep'e ayrıştırıyor. Bu özellik yalnızca Bicep uzantısının 0.14.0 veya daha yeni bir sürümüyle kullanılabilir. Varsayılan olarak bu özellik etkindir. Özelliği devre dışı bırakmak için bkz . VS Code ve Bicep uzantısı.

Bu özelliği kullanarak şunları yapıştırabilirsiniz:

Tam ARM JSON şablonları.
Tek kaynak veya birden çok kaynak.
Nesneler, diziler ve dizeler gibi JSON değerleri. Çift tırnaklı bir dize tek tırnak işaretine dönüştürülür.

Örneğin, aşağıdaki Bicep dosyasıyla başlayabilirsiniz:

@description('Storage Account type')
@allowed([
  'Standard_LRS'
  'Standard_GRS'
  'Standard_ZRS'
  'Premium_LRS'
])
param storageAccountsku string = 'Standard_LRS'

@description('Location for all resources.')
param location string = resourceGroup().location

var storageAccountName = '${uniqueString(resourceGroup().id)}storage'

resource storageAccount 'Microsoft.Storage/storageAccounts@2023-04-01' = {
  name: storageAccountName
  location: location
  sku: {
    name: storageAccountsku
  }
  kind: 'StorageV2'
  tags: {
    ObjectName: storageAccountName
  }
  properties: {}
}

output storageAccountName string = storageAccountName

Ve aşağıdaki JSON dosyasını yapıştırın:

{
  "type": "Microsoft.Batch/batchAccounts",
  "apiVersion": "2024-02-01",
  "name": "[parameters('batchAccountName')]",
  "location": "[parameters('location')]",
  "tags": {
    "ObjectName": "[parameters('batchAccountName')]"
  },
  "properties": {
    "autoStorage": {
      "storageAccountId": "[resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))]"
    }
  }
}

Visual Studio Code, JSON'ı otomatik olarak Bicep'e dönüştürür. adlı batchAccountNameparametreyi de eklemeniz gerektiğini fark edin.

Ctrl+Z tuşlarını kullanarak ayrıştırma işlemini geri alabilirsiniz. Özgün JSON dosyasında görünür.

Sorun giderme

Bölme, Problems Bicep dosyanızdaki hataları ve uyarıyı özetler.

Visual Studio Code Bicep sorunları bölmesinin ekran görüntüsü.

Hata/uyarı kodları listesi için bkz . Bicep hata/uyarı kodları.

Sonraki adımlar

Hızlı başlangıç adımlarını görmek için bkz . Hızlı Başlangıç: Visual Studio Code ile Bicep dosyaları oluşturma.

Aracılığıyla paylaş