Partilhar via

Comparar JSON e Bicep para modelos

  • Artigo

Este artigo compara a sintaxe bicep com a sintaxe JSON para modelos de Resource Manager do Azure (modelos do ARM). Na maioria dos casos, o Bicep fornece sintaxe menos verbosa do que a equivalente em JSON.

Se estiver familiarizado com a utilização de JSON para desenvolver modelos do ARM, utilize os seguintes exemplos para saber mais sobre a sintaxe equivalente para Bicep.

Comparar ficheiros completos

O Bicep Playground permite-lhe ver Bicep e JSON equivalente lado a lado. Pode comparar as implementações da mesma infraestrutura.

Por exemplo, pode ver o ficheiro para implementar um servidor SQL e uma base de dados. O Bicep tem cerca de metade do tamanho do modelo do ARM.

Captura de ecrã de modelos lado a lado

Expressions (Expressões)

Para criar uma expressão:

func()

"[func()]"

Parâmetros

Para declarar um parâmetro com um valor predefinido:

param orgName string = 'Contoso'

"parameters": {
  "orgName": {
    "type": "string",
    "defaultValue": "Contoso"
  }
}

Para obter um valor de parâmetro, utilize o nome que definiu:

name: orgName

"name": "[parameters('orgName')]"

Variáveis

Para declarar uma variável:

var description = 'example value'

"variables": {
  "description": "example value"
}

Para obter um valor de variável, utilize o nome que definiu:

workloadSetting: description

"workloadSetting": "[variables('description')]"

Cadeias

Para concatenar cadeias:

name: '${namePrefix}-vm'

"name": "[concat(parameters('namePrefix'), '-vm')]"

Operadores lógicos

Para devolver o AND lógico:

isMonday && isNovember

[and(parameter('isMonday'), parameter('isNovember'))]

Para definir condicionalmente um valor:

isMonday ? 'valueIfTrue' : 'valueIfFalse'

[if(parameters('isMonday'), 'valueIfTrue', 'valueIfFalse')]

Âmbito da implementação

Para definir o âmbito de destino da implementação:

targetScope = 'subscription'

"$schema": "https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#"

Recursos

Para declarar um recurso:

resource virtualMachine 'Microsoft.Compute/virtualMachines@2024-03-01' = {
  ...
}

"resources": [
  {
    "type": "Microsoft.Compute/virtualMachines",
    "apiVersion": "2024-03-01",
    ...
  }
]

Para implementar condicionalmente um recurso:

resource virtualMachine 'Microsoft.Compute/virtualMachines@2024-03-01' = if(deployVM) {
  ...
}

"resources": [
  {
    "condition": "[parameters('deployVM')]",
    "type": "Microsoft.Compute/virtualMachines",
    "apiVersion": "2024-03-01",
    ...
  }
]

Para definir uma propriedade de recurso:

sku: '2016-Datacenter'

"sku": "2016-Datacenter",

Para obter o ID de recurso de um recurso no modelo:

nic1.id

[resourceId('Microsoft.Network/networkInterfaces', variables('nic1Name'))]

Ciclos

Para iterar itens numa matriz ou contagem:

[for storageName in storageAccountNames: {
  ...
}]

"copy": {
  "name": "storagecopy",
  "count": "[length(parameters('storageAccountNames'))]"
},
...

Dependências de recursos

Para o Bicep, pode definir uma dependência explícita, mas esta abordagem não é recomendada. Em vez disso, dependa de dependências implícitas. É criada uma dependência implícita quando uma declaração de recurso referencia o identificador de outro recurso.

O seguinte mostra uma interface de rede com uma dependência implícita num grupo de segurança de rede. Faz referência ao grupo de segurança de rede com netSecurityGroup.id.

resource netSecurityGroup 'Microsoft.Network/networkSecurityGroups@2023-11-01' = {
  ...
}

resource nic1 'Microsoft.Network/networkInterfaces@2023-11-01' = {
  name: nic1Name
  location: location
  properties: {
    ...
    networkSecurityGroup: {
      id: netSecurityGroup.id
    }
  }
}

Se tiver de definir uma dependência explícita, utilize:

dependsOn: [ storageAccount ]

"dependsOn": ["[resourceId('Microsoft.Storage/storageAccounts', 'parameters('storageAccountName'))]"]

Recursos de referência

Para obter uma propriedade de um recurso no modelo:

storageAccount.properties.primaryEndpoints.blob

[reference(resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))).primaryEndpoints.blob]

Para obter uma propriedade de um recurso existente que não está implementado no modelo:

resource storageAccount 'Microsoft.Storage/storageAccounts@2023-04-01' existing = {
  name: storageAccountName
}

// use later in template as often as needed
storageAccount.properties.primaryEndpoints.blob

// required every time the property is needed
"[reference(resourceId('Microsoft.Storage/storageAccounts/', parameters('storageAccountName')), '2019-06-01').primaryEndpoints.blob]"

No Bicep, utilize o acessório aninhado (::) para obter uma propriedade num recurso aninhado num recurso principal:

VNet1::Subnet1.properties.addressPrefix

Para JSON, utilize a função de referência:

[reference(resourceId('Microsoft.Network/virtualNetworks/subnets', variables('subnetName'))).properties.addressPrefix]

Saídas

Para produzir uma propriedade a partir de um recurso no modelo:

output hostname string = publicIP.properties.dnsSettings.fqdn

"outputs": {
  "hostname": {
    "type": "string",
    "value": "[reference(resourceId('Microsoft.Network/publicIPAddresses', variables('publicIPAddressName'))).dnsSettings.fqdn]"
  },
}

Para gerar condicionalmente um valor:

output hostname string = condition ? publicIP.properties.dnsSettings.fqdn : ''

"outputs": {
  "hostname": {
    "condition": "[variables('condition')]",
    "type": "string",
    "value": "[reference(resourceId('Microsoft.Network/publicIPAddresses', variables('publicIPAddressName'))).dnsSettings.fqdn]"
  }
}

O operador ternary Bicep é o equivalente à função if num modelo do ARM JSON e não à propriedade da condição. A sintaxe ternary tem de ser avaliada como um valor ou outro. Se a condição for falsa nos exemplos anteriores, o Bicep produz um nome de anfitrião com uma cadeia vazia, mas JSON não produz valores.

Reutilização de código

Para separar uma solução em vários ficheiros:

Passos seguintes