إنشاء ملف معلمات لتوزيع Bicep

using '<path>/<file-name>.bicep'

param <first-parameter-name> = <first-value>
param <second-parameter-name> = <second-value>

يمكنك تطبيق العبارة using باستخدام ملف Bicep وقوالب JSON Azure Resource Manager ووحدات Bicep النمطية ومواصفات القالب. على سبيل المثال:

using './main.bicep'
...

using './azuredeploy.json'
...

using 'br/public:avm/res/storage/storage-account:0.9.0' 
...

using 'br:myacr.azurecr.io/bicep/modules/storage:v1'
...

using 'ts:00000000-0000-0000-0000-000000000000/myResourceGroup/storageSpec:1.0'
...

لمزيد من المعلومات، راجع استخدام عبارة .

من الممكن استخدام التعبيرات المحتوية القيمة الافتراضية. على سبيل المثال:

using 'main.bicep'

param storageName = toLower('MyStorageAccount')
param intValue = 2 + 2

يمكنك الرجوع إلى متغيرات البيئة كقيم معلمات. على سبيل المثال:

using './main.bicep'

param intFromEnvironmentVariables = int(readEnvironmentVariable('intEnvVariableName'))

يمكنك تعريف المتغيرات واستخدامها. يجب استخدام Bicep CLI الإصدار 0.21.X أو أحدث لاستخدام المتغيرات في .bicepparam الملفات. انظر الأمثلة التالية:

using './main.bicep'

var storagePrefix = 'myStorage'
param primaryStorageName = '${storagePrefix}Primary'
param secondaryStorageName = '${storagePrefix}Secondary'

using './main.bicep'

var testSettings = {
  instanceSize: 'Small'
  instanceCount: 1
}

var prodSettings = {
  instanceSize: 'Large'
  instanceCount: 4
}

param environmentSettings = {
  test: testSettings
  prod: prodSettings
}

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "<first-parameter-name>": {
      "value": "<first-value>"
    },
    "<second-parameter-name>": {
      "value": "<second-value>"
    }
  }
}

using './main.bicep'

param exampleString = 'test string'
param exampleInt = 2 + 2
param exampleBool = true
param exampleArray = [
  'value 1'
  'value 2'
]
param exampleObject = {
  property1: 'value 1'
  property2: 'value 2'
}

استخدم بناء جملة Bicep للإعلان عن الكائنات والصفائف.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "exampleString": {
      "value": "test string"
    },
    "exampleInt": {
      "value": 4
    },
    "exampleBool": {
      "value": true
    },
    "exampleArray": {
      "value": [
        "value 1",
        "value 2"
      ]
    },
    "exampleObject": {
      "value": {
        "property1": "value1",
        "property2": "value2"
      }
    }
  }
}

ملحق الملف لملف معلمات Bicep هو .bicepparam.

للنشر في بيئات متعددة، يمكنك إنشاء أكثر من ملف معلمات واحد. عند استخدام ملفات معلمات متعددة، قم بتسميةها وفقا لاستخدامها. على سبيل المثال، لنشر الموارد، استخدم التسمية main.dev.bicepparam للتطوير والتسمية main.prod.bicepparam للإنتاج.

اصطلاح التسمية العام لملف المعلمات هو تضمين معلمات في اسم ملف Bicep. على سبيل المثال، إذا كان ملف Bicep الخاص بك يسمى azuredeploy.bicep، فسيسمى ملف المعلمات azuredeploy.parameters.json. يساعدك اصطلاح التسمية هذا على رؤية العلاقة بين ملف Bicep والمعلمات.

للنشر في بيئات مختلفة، يمكنك إنشاء أكثر من ملف معلمات واحد. عند استخدام ملفات معلمات متعددة، قم بتسميةها وفقا لاستخدامها. على سبيل المثال، لنشر الموارد، استخدم azuredeploy.parameters-dev.json التسمية للتطوير azuredeploy.parameters-prod.json التسمية للإنتاج.

using 'main.bicep'

param storagePrefix
param storageAccountType

تربط using العبارة ملف معلمات Bicep إلى ملف Bicep. لمزيد من المعلومات، راجع استخدام عبارة .

عند كتابة الكلمة الأساسية param في Visual Studio Code، فإنه يطالبك بالمعلمات المتوفرة ووصفها من ملف Bicep المرتبط.

عند المرور فوق param اسم، يمكنك مشاهدة نوع بيانات المعلمة ووصفها.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
    },
    "storageAccountType": {
    }
  }
}

using 'main.bicep'

param storagePrefix = ''
param storageAccountType = ''

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "value": ""
    },
    "storageAccountType": {
      "value": ""
    }
  }
}

using 'main.bicep'

param storagePrefix = '' // This value must be provided.
param storageAccountType = '' // This value is optional. Bicep uses default value if not provided.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "value": "" // This value must be provided.
    },
    "storageAccountType": {
      "value": "" // This value is optional. Bicep uses default value if not provided.
    }
  }
}

using 'main.bicep'

param storagePrefix = 'storage'
param storageAccountType = 'Standard_ZRS'

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "value": "storage"
    },
    "storageAccountType": {
      "value": "Standard_ZRS"
    }
  }
}

يمكنك نشر ملف Bicep باستخدام ملف معلمات Bicep مع الإصدار 2.53.0 من Azure CLI أو أحدث وإصدار Bicep CLI 0.22.X أو أحدث. باستخدام العبارة using داخل ملف معلمات Bicep، ليست هناك حاجة لتوفير --template-file مفتاح التبديل عند تحديد ملف معلمات Bicep للتبديل --parameters .

az deployment group create \
  --name ExampleDeployment \
  --resource-group ExampleGroup \
  --parameters storage.bicepparam

az deployment group create \
  --name ExampleDeployment \
  --resource-group ExampleGroup \
  --template-file storage.bicep \
  --parameters storage.parameters.json

az deployment group create \
  --name ExampleDeployment \
  --resource-group ExampleGroup \
  --parameters storage.bicepparam \
  --parameters storageAccountType=Standard_LRS

az deployment group create \
  --name ExampleDeployment \
  --resource-group ExampleGroup \
  --template-file storage.bicep \
  --parameters storage.parameters.json \
  --parameters storageAccountType=Standard_LRS

New-AzResourceGroupDeployment `
  -Name ExampleDeployment `
  -ResourceGroupName ExampleResourceGroup `
  -TemplateFile C:\MyTemplates\storage.bicep `
  -TemplateParameterFile C:\MyTemplates\storage.bicepparam

New-AzResourceGroupDeployment `
  -Name ExampleDeployment `
  -ResourceGroupName ExampleResourceGroup `
  -TemplateFile C:\MyTemplates\storage.bicep `
  -TemplateParameterFile C:\MyTemplates\storage.parameters.json

New-AzResourceGroupDeployment `
  -Name ExampleDeployment `
  -ResourceGroupName ExampleResourceGroup `
  -TemplateFile C:\MyTemplates\storage.bicep `
  -TemplateParameterFile C:\MyTemplates\storage.bicepparam `
  -storageAccountType Standard_LRS

New-AzResourceGroupDeployment `
  -Name ExampleDeployment `
  -ResourceGroupName ExampleResourceGroup `
  -TemplateFile C:\MyTemplates\storage.bicep `
  -TemplateParameterFile C:\MyTemplates\storage.parameters.json `
  -storageAccountType Standard_LRS