Exercício – Criar modelos do Bicep

Concluído

Já é hora de criar seu primeiro template Bicep. Depois de seguir esta unidade, você aprenderá como a extensão Bicep no VS Code simplifica o desenvolvimento fornecendo segurança de tipo, validação de sintaxe e preenchimento automático.

Pré-requisitos

Para acompanhar, você precisará ter acesso a uma assinatura do Azure. Você também precisa ter:

  • VS Code.
  • CLI do Azure.
  • Extensão Bicep para VS Code.

Criar seu primeiro modelo

Abra o VS Code e crie um novo arquivo chamado main.bicep. Quando concluir, abra o arquivo e comece a digitar armazenamento. Você deverá ver um menu exibido no qual selecione a primeira opção res-storage pressionando Enter ou Tab. Você deve acabar com um snippet que se parece com:

resource storageaccount 'Microsoft.Storage/storageAccounts@2021-02-01' = {
    name: 'name'
    location: location
    kind: 'StorageV2'
    sku: {
        name: 'Premium_LRS'
    }
}

Esse arquivo implantará uma Conta de Armazenamento do Azure , no entanto, precisamos modificar o arquivo para torná-lo pronto para a implantação. Primeiro, vamos adicionar dois parâmetros, um para o nome, pois ele deve ser exclusivo e outro para o local.

param storageName string = 'stg${uniqueString(resourceGroup().id)}'
param location string = resourceGroup().location

O valor que você atribui aos parâmetros é o valor padrão que torna os parâmetros opcionais. Substitua a propriedade 'name' por storageName e, como a localização já está em uso, você pode prosseguir com a implantação.

Visualizar recursos

Você pode usar o VS Code para visualizar os recursos definidos no arquivo Bicep. Clique no botão visualizador no canto superior direito:

captura de tela de um recurso do VS Code para fazer uma representação dos recursos do Bicep.

Compilar o arquivo

Você não precisa compilar o arquivo para poder implantá-lo, mas é bom saber como você pode fazer isso.

Abra o terminal integrado no VS Code clicando com o botão direito do mouse no arquivo Bicep e selecionando o menu Abrir no Terminal Integrado.

Use o comando build da seguinte maneira:

az bicep build -f ./main.bicep

Fique à vontade para dar uma olhada no modelo do ARM resultante e comparar os dois.

Implantando o arquivo Bicep

Agora é a hora de implantar o arquivo Bicep que você criou. No mesmo terminal, execute os seguintes comandos:

az group create --name Bicep --location eastus
az deployment group create --resource-group Bicep --template-file main.bicep --parameters storageName=uniqueName

Nota

Substitua o uniqueName por um nome exclusivo, mas você também pode ignorar o fornecimento do parâmetro, pois ele tem um valor padrão.

Quando a implantação for concluída, você receberá uma mensagem indicando que a implantação foi bem-sucedida.

Captura de tela da saída da mensagem de implantação bem-sucedida.

Próximas etapas

Agora que você aprendeu a criar um modelo básico e implantá-lo, vá para a próxima unidade para saber mais sobre os constructos em um arquivo Bicep.