Visual Studio Code kullanarak Bicep dosyaları oluşturma
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.
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:
az resource list
Ş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.
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.
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.