Exercício - Criar modelos de bíceps

  • 3 minutos

É hora de criar seu primeiro modelo de Bíceps. 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 o primeiro modelo

Abra seu VS Code e crie um novo arquivo chamado main.bicep. Quando terminar, abra o arquivo e comece a digitar o armazenamento. Você verá um menu a partir do qual selecione a primeira opção res-storage pressionando Enter ou Tab. Você deve acabar com um trecho 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 modificá-lo para torná-lo pronto para implantação. Primeiro, vamos adicionar dois parâmetros, um para o nome, uma vez que deve ser exclusivo, e outro para o local.

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

O valor atribuído aos parâmetros é o valor padrão que torna os parâmetros opcionais. Substitua a propriedade name por storageName e, como o local já está usado, é bom prosseguir com a implantação.

Visualizar recursos

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

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

Compilar o ficheiro

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

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

Sinta-se à vontade para dar uma olhada no modelo 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 terminar, você receberá uma mensagem indicando que a implantação foi bem-sucedida.

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

Próximos passos

Agora que você aprendeu como criar um modelo básico e implantá-lo, vá para a próxima unidade para saber mais sobre as construções em um arquivo Bicep.