Változók a Bicepben
Ez a cikk azt ismerteti, hogyan definiálhat és használhat változókat a Bicep-fájlban. Változókkal egyszerűsítheti a Bicep-fájlfejlesztést. Ahelyett, hogy bonyolult kifejezéseket ismétel meg a Bicep-fájlban, definiálhat egy változót, amely tartalmazza a bonyolult kifejezést. Ezután szükség szerint használja ezt a változót a Bicep-fájlban.
Resource Manager feloldja a változókat az üzembehelyezési műveletek megkezdése előtt. Bárhol is használja a változót a Bicep-fájlban, Resource Manager lecseréli a feloldott értékre.
Egy Bicep-fájlban legfeljebb 256 változó lehet. További információ: Sablonkorlátok.
Változó definiálása
A változók meghatározásának szintaxisa a következő:
var <variable-name> = <variable-value>
A változók neve nem lehet ugyanaz, mint egy paraméter, modul vagy erőforrás neve.
Figyelje meg, hogy nem ad meg adattípust a változóhoz. A típus az értékből származik. Az alábbi példa egy változót egy sztringre állít be.
var stringVar = 'example value'
A változó létrehozásakor használhatja egy paraméter vagy egy másik változó értékét.
param inputValue string = 'deployment parameter'
var stringVar = 'preset variable'
var concatToVar = '${stringVar}AddToVar'
var concatToParam = '${inputValue}AddToParam'
output addToVar string = concatToVar
output addToParam string = concatToParam
Az előző példa a következőt adja vissza:
{
"addToParam": {
"type": "String",
"value": "deployment parameterAddToParam"
},
"addToVar": {
"type": "String",
"value": "preset variableAddToVar"
}
}
A bicep függvényekkel létrehozhatja a változó értékét. Az alábbi példa a Bicep-függvényeket használja a tárfiók nevének sztringértékének létrehozásához.
param storageNamePrefix string = 'stg'
var storageName = '${toLower(storageNamePrefix)}${uniqueString(resourceGroup().id)}'
output uniqueStorageName string = storageName
Az előző példa a következőhöz hasonló értéket ad vissza:
"uniqueStorageName": {
"type": "String",
"value": "stghzuunrvapn6sw"
}
Változók definiálásakor iteratív hurkokat használhat. Az alábbi példa három tulajdonságokkal rendelkező objektumtömböt hoz létre.
param itemCount int = 3
var objectArray = [for i in range(0, itemCount): {
name: 'myDataDisk${(i + 1)}'
diskSizeGB: '1'
diskIndex: i
}]
output arrayResult array = objectArray
A kimenet egy tömböt ad vissza a következő értékekkel:
[
{
"name": "myDataDisk1",
"diskSizeGB": "1",
"diskIndex": 0
},
{
"name": "myDataDisk2",
"diskSizeGB": "1",
"diskIndex": 1
},
{
"name": "myDataDisk3",
"diskSizeGB": "1",
"diskIndex": 2
}
]
A változókkal használható hurkok típusairól további információt a Bicep iteratív ciklusai című témakörben talál.
Változó használata
Az alábbi példa bemutatja, hogyan használhatja a változót egy erőforrástulajdonsághoz. A változó értékére a változó nevének megadásával hivatkozhat: storageName
.
param rgLocation string
param storageNamePrefix string = 'STG'
var storageName = '${toLower(storageNamePrefix)}${uniqueString(resourceGroup().id)}'
resource demoAccount 'Microsoft.Storage/storageAccounts@2021-02-01' = {
name: storageName
location: rgLocation
kind: 'Storage'
sku: {
name: 'Standard_LRS'
}
}
output stgOutput string = storageName
Mivel a tárfiókneveknek kisbetűket kell használniuk, a storageName
változó a toLower
függvény használatával kisbetűssé teszi az storageNamePrefix
értéket. A uniqueString
függvény egyedi értéket hoz létre az erőforráscsoport-azonosítóból. Az értékek sztringgel vannak összefűzve.
Konfigurációs változók
Definiálhat olyan változókat, amelyek a környezet konfigurálásához kapcsolódó értékeket tartalmaznak. A változót objektumként definiálja az értékekkel. Az alábbi példa egy olyan objektumot mutat be, amely két környezet értékeit tartalmazza – teszt és prod. Adja meg ezeket az értékeket az üzembe helyezés során.
@allowed([
'test'
'prod'
])
param environmentName string
var environmentSettings = {
test: {
instanceSize: 'Small'
instanceCount: 1
}
prod: {
instanceSize: 'Large'
instanceCount: 4
}
}
output instanceSize string = environmentSettings[environmentName].instanceSize
output instanceCount int = environmentSettings[environmentName].instanceCount
Következő lépések
- A változók elérhető tulajdonságairól a Bicep-fájlok szerkezetének és szintaxisának ismertetése című témakörben olvashat.
- A hurokszintaxis használatáról további információt az Iteratív hurkok a Bicepben című témakörben talál.