Hızlı başlangıç: Visual Studio Code bicep dosyaları oluşturma

Bu hızlı başlangıç, Visual Studio Code bir bicep dosyası oluşturma adımlarında size rehberlik eder. Bir depolama hesabı ve bir sanal ağ oluşturacaksınız. Ayrıca, tür güvenliği, sözdizimi doğrulaması ve otomatik tamamlama sağlayarak Bıcep uzantısının geliştirmeyi nasıl basitleştireceğinizi öğreneceksiniz.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Bıcep geliştirme için ortamınızı ayarlamak için bkz. bıcep araçları 'Nı kurma. bu adımları tamamladıktan sonra, Visual Studio Code ve bıcep uzantısıolacaktır. ayrıca en son Azure clı veya en son Azure PowerShell modülünüzünolması gerekir.

Kaynak kod parçacığı Ekle

Visual Studio Code başlatın ve main. bıcep adlı yeni bir dosya oluşturun.

bicep uzantılı VS Code, önceden tanımlanmış kod parçacıkları sunarak geliştirmeyi basitleştirir. Bu hızlı başlangıçta, sanal ağ oluşturan bir kod parçacığı ekleyeceksiniz.

Main. bıcep' de VNET yazın. Listeden res-VNET ' i seçin ve ardından sekme veya ENTER tuşuna tıklayın.

Bıcep dosyanız şu 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ımlamanız için gereken 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. nameÖzelliğini olarak değiştirin examplevnet .

name: 'examplevnet'

Bu Bıcep 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 şunu ekleyin:

param storageName

Storagename öğesinden sonra bir boşluk eklediğinizde, IntelliSense 'in parametre için kullanılabilir veri türlerini sunduğunu görürsünüz. Dize seçin.

Şu parametreye sahipsiniz:

param storageName string

Bu parametre sorunsuz şekilde çalışıyor, ancak depolama hesaplarının ad uzunluğu sınırı vardır. Ad en az 3 karakter uzunluğunda ve en fazla 24 karakter uzunluğunda olmalıdır. Parametreye dekoratörler ekleyerek bu gereksinimleri belirtebilirsiniz.

Parametresinin üzerine bir satır ekleyin ve yazın @ . Kullanılabilir dekoratlarını görürsünüz. Hem minLength hem de MaxLength için dekoratörler olduğuna dikkat edin.

Her iki dekoratörler ekleyin ve aşağıda gösterildiği gibi karakter sınırlarını belirtin:

@minLength(3)
@maxLength(24)
param storageName string

Ayrıca parametresi için bir açıklama ekleyebilirsiniz. Bicep dosyasını dağıtan kişilerin sağlanacak değeri anlamasına yardımcı olan bilgileri içerir.

@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

Parametrizin kullanıma hazırlanıyor.

Kaynak Ekle

Depolama hesabını tanımlamak için bir kod parçacığı kullanmak yerine, IntelliSense 'i kullanarak değerleri ayarlama yapacağız. IntelliSense, bu adımı, değerleri el ile yazmak zorunda kalmadan çok daha kolay hale getirir.

Bir kaynak tanımlamak için resource anahtar sözcüğünü kullanın. Sanal ağınızın altına kaynak exampleStorage yazın:

resource exampleStorage

örnek depolama , dağıttığınız kaynak için bir sembolik addır. Bu adı, Bıcep dosyanızın diğer bölümlerinde kaynağa başvurmak için kullanabilirsiniz.

Sembolik adından sonra bir boşluk eklediğinizde, kaynak türlerinin bir listesi görüntülenir. Mevcut seçeneklerden seçim yapana kadar depolama yazmaya devam edin.

Microsoft. Depolama seçildikten sonra /storageAccounts, KULLANILABILIR API sürümleri sunulur. 2021-02-01 öğesini seçin.

Kaynak türü için tek tekliften sonra, = bir boşluk ekleyin. Kaynağa özellik ekleme seçenekleri sunulur. Gerekli özellikler' i seçin.

Bu seçenek, dağıtım için gerekli olan kaynak türü için tüm özellikleri ekler. Bu seçeneği belirledikten 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. Yalnızca bu özellikler için değerler sağlayın.

IntelliSense size yardımcı olur. name storageName Öğesini, depolama hesabı için bir ad içeren parametresi olan olarak ayarlayın. İçin location , olarak ayarlayın 'eastus' . SKU adı ve türü eklenirken, IntelliSense geçerli seçenekleri gösterir.

İşiniz bittiğinde şunları yapabilirsiniz:

@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'
}

Bıcep sözdizimi hakkında daha fazla bilgi için bkz. bıcep yapısı.

Kaynakları görselleştirin

Dosyanızdaki kaynakların gösterimini görüntüleyebilirsiniz.

Sol üst köşedeki görselleştiricisi düğmesini seçerek Bıcep Görselleştiricisini açın.

Görselleştirici, Bıcep dosyasında tanımlanan kaynakları kaynak bağımlılığı bilgileriyle gösterir. Bu hızlı başlangıçta tanımlanan iki kaynak bağımlılık ilişkisine sahip değildir, bu nedenle iki kaynak arasında bir bağlayıcı görmezsiniz.

Bıcep dosyasını dağıtma

Oluşturduğunuz dosyayı dağıtmak için PowerShell veya Azure CLı 'yi açın. tümleşik Visual Studio Code terminali kullanmak istiyorsanız, ctrl + ` anahtar birleşimini seçin. Geçerli dizini Bıcep dosyasının bulunduğu konum olarak değiştirin.

az group create --name exampleRG --location eastus

az deployment group create --resource-group exampleRG --template-file main.bicep --parameters storageName=uniquename

New-AzResourceGroup -Name exampleRG -Location eastus

New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -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ına artık ihtiyaç duyulmadığında hızlı başlangıç kaynak grubunu silmek için azure clı veya Azure PowerShell modülünü kullanın.

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Sonraki adımlar