Hızlı Başlangıç: Visual Studio Code ile Bicep dosyaları oluşturma
Bu hızlı başlangıç, Visual Studio Code ile bicep dosyası oluşturma adımlarını gösterir. Bir depolama hesabı ve sanal ağ oluşturacaksınız. Ayrıca tür güvenliği, söz dizimi doğrulaması ve otomatik tamamlama sağlayarak Bicep uzantısının geliştirmeyi nasıl kolaylaştırdığı hakkında bilgi edineceksiniz.
Benzer yazma deneyimi Visual Studio'da da desteklenir. Bkz . Hızlı Başlangıç: Visual Studio ile Bicep dosyaları oluşturma.
Önkoşullar
Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
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.
Kaynak parçacığı ekleme
Visual Studio Code başlatın ve main.bicep adlı yeni bir dosya oluşturun.
Bicep uzantısına sahip VS Code, önceden tanımlanmış kod parçacıkları sağlayarak geliştirmeyi kolaylaştırır. Bu hızlı başlangıçta, sanal ağ oluşturan bir kod parçacığı ekleyeceksiniz.
main.bicep'evnet yazın. Listeden res-vnet'i ve ardından Sekme veya Enter'ı seçin.
İpucu
VS Code'da bu IntelliSense seçeneklerini görmüyorsanız , Önkoşullar bölümünde belirtildiği gibi Bicep uzantısını yüklediğinizden emin olun. Uzantıyı yüklediyseniz Bicep dil hizmetine Bicep dosyanızı açtıktan sonra başlaması için biraz zaman tanıyın. Genellikle hızlı bir şekilde başlar, ancak başlayana kadar IntelliSense seçenekleriniz olmaz. Sağ alt köşedeki bildirim, hizmetin başlatıldığını gösterir. Bu bildirim kaybolduğunda hizmet çalışır durumda olur.
Bicep dosyanız artık aşağıdaki kodu içerir:
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2019-11-01' = {
name: 'name'
location: resourceGroup().location
properties: {
addressSpace: {
addressPrefixes: [
'10.0.0.0/16'
]
}
subnets: [
{
name: 'Subnet-1'
properties: {
addressPrefix: '10.0.0.0/24'
}
}
{
name: 'Subnet-2'
properties: {
addressPrefix: '10.0.1.0/24'
}
}
]
}
}
Bu kod parçacığı, bir sanal ağ tanımlamak için ihtiyacınız olan tüm değerleri içerir. Ancak bu kodu gereksinimlerinizi karşılayacak şekilde değiştirebilirsiniz. Örneğin, name sanal ağ için harika bir ad değildir. özelliğini olarak nameexamplevnetdeğiştirin.
name: 'examplevnet'
Bu Bicep dosyasını dağıtabilirsiniz, ancak dağıtmadan önce bir parametre ve depolama hesabı ekleyeceğiz.
Parametre ekleme
Şimdi depolama hesabı adı için bir parametre ekleyeceğiz. Dosyanın en üstüne şunları ekleyin:
param storageName
storageName'in ardından bir alan eklediğinizde IntelliSense'in parametresi için kullanılabilen veri türlerini sunduğuna dikkat edin. Dizeyi seçin.
Aşağıdaki parametreye sahipsiniz:
param storageName string
Bu parametre düzgün çalışır, ancak depolama hesaplarının adın uzunluğuyla ilgili sınırları vardır. Adın en az 3 karakteri ve en fazla 24 karakteri olmalıdır. Parametresine dekoratör ekleyerek bu gereksinimleri belirtebilirsiniz.
parametresinin üstüne bir çizgi ekleyin ve yazın @. Kullanılabilir dekoratörleri görürsünüz. Hem minLength hem de maxLength için dekoratörler olduğuna dikkat edin.
Aşağıda gösterildiği gibi her iki dekoratörü de ekleyin ve karakter sınırlarını belirtin:
@minLength(3)
@maxLength(24)
param storageName string
Parametresi için bir açıklama da ekleyebilirsiniz. Bicep dosyasını dağıtan kişilerin sağlayabilecekleri değeri anlamasına yardımcı olacak bilgiler ekleyin.
@minLength(3)
@maxLength(24)
@description('Provide a name for the storage account. Use only lower case letters and numbers. The name must be unique across Azure.')
param storageName string
Parametreniz kullanıma hazır.
Kaynak ekle
Depolama hesabını tanımlamak için kod parçacığı kullanmak yerine intellisense kullanarak değerleri ayarlayacağız. IntelliSense bu adımı, değerleri el ile yazmaktan çok daha kolay hale getirir.
Kaynak tanımlamak için anahtar sözcüğünü resource kullanın. Sanal ağınızın altına kaynak örneğiDepolama yazın:
resource exampleStorage
exampleStorage , dağıttığınız kaynağın sembolik adıdır. Bicep dosyanızın diğer bölümlerinde kaynağa başvurmak için bu adı kullanabilirsiniz.
Simgesel adından sonra boşluk eklediğinizde, kaynak türlerinin listesi görüntülenir. Kullanılabilir seçenekler arasından seçene kadar depolama yazmaya devam edin.
Microsoft seçtikten sonra. Storage/storageAccounts, size kullanılabilir API sürümleriyle sunulur. 2021-02-01'i seçin.
Kaynak türü için tek tırnak işaretinden sonra ve alanını ekleyin = . Kaynağa özellik ekleme seçenekleri sunulur. Gerekli özellikler'i seçin.
Bu seçenek, dağıtım için gereken kaynak türünün tüm özelliklerini ekler. Bu seçeneği seçtikten sonra depolama hesabınız aşağıdaki özelliklere sahiptir:
resource exampleStorage 'Microsoft.Storage/storageAccounts@2021-02-01' = {
name:
location:
sku: {
name:
}
kind:
}
Neredeyse bitti. Bu özellikler için değerleri sağlamanız yeter.
IntelliSense de size yardımcı olur. storageNamedepolama hesabı için bir ad içeren parametre olarak ayarlayınname. için locationolarak ayarlayın 'eastus'. SKU adı ve türü eklenirken IntelliSense geçerli seçenekleri sunar.
İşiniz bittiğinde şunları elde etmiş olacaksınız:
@minLength(3)
@maxLength(24)
param storageName string
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2019-11-01' = {
name: 'examplevnet'
location: resourceGroup().location
properties: {
addressSpace: {
addressPrefixes: [
'10.0.0.0/16'
]
}
subnets: [
{
name: 'Subnet-1'
properties: {
addressPrefix: '10.0.0.0/24'
}
}
{
name: 'Subnet-2'
properties: {
addressPrefix: '10.0.1.0/24'
}
}
]
}
}
resource exampleStorage 'Microsoft.Storage/storageAccounts@2021-02-01' = {
name: storageName
location: 'eastus'
sku: {
name: 'Standard_LRS'
}
kind: 'StorageV2'
}
Bicep söz dizimi hakkında daha fazla bilgi için bkz. Bicep yapısı.
Kaynakları görselleştirme
Dosyanızdaki kaynakların bir gösterimini görüntüleyebilirsiniz.
Sağ üst köşeden görselleştirici düğmesini seçerek Bicep Görselleştiricisi'ni açın.
Görselleştirici, Kaynak bağımlılığı bilgileriyle birlikte Bicep dosyasında tanımlanan kaynakları gösterir. Bu hızlı başlangıçta tanımlanan iki kaynağın bağımlılık ilişkisi yoktur, bu nedenle iki kaynak arasında bağlayıcı görmezsiniz.
Bicep dosyasını dağıtma
VSCode içinde Bicep dosyasına sağ tıklayın ve ardından Bicep dosyasını dağıt'ı seçin.
Üstteki Kaynak Grubu Seç liste kutusundan Yeni Kaynak Grubu Oluştur'u seçin.
Kaynak grubu adı olarak exampleRG yazın ve [ENTER] tuşuna basın.
Kaynak grubu için bir konum seçin ve [ENTER] tuşuna basın.
Parametre dosyası seçin'denYok'a tıklayın.
Benzersiz bir depolama hesabı adı girin ve [ENTER] tuşuna basın. Depolama hesabının zaten alındığını belirten bir hata iletisi alırsanız, sağladığınız depolama adı kullanımdadır. Benzersiz olma olasılığı daha yüksek bir ad sağlayın.
Bu dağıtımda kullanılan değerlerden parametre dosyası oluştur? bölümünde Hayır'ı seçin.
Kaynakların oluşturulması birkaç dakika sürer. Daha fazla bilgi için bkz . Visual Studio Code ile Bicep dosyalarını dağıtma.
Bicep dosyasını Azure CLI veya Azure PowerShell kullanarak da dağıtabilirsiniz:
az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters storageName=uniquename
Dağıtım tamamlandığında, dağıtımın başarılı olduğunu belirten bir ileti görmeniz gerekir.
Kaynakları temizleme
Azure kaynakları artık gerekli olmadığında, hızlı başlangıç kaynak grubunu silmek için Azure CLI veya Azure PowerShell modülünü kullanın.
az group delete --name exampleRG