O que é o Bicep?

O Bicep é uma linguagem específica do domínio que usa sintaxe declarativa para implantar recursos do Azure. Em um arquivo Bicep, você define a infraestrutura que deseja implantar no Azure e, em seguida, usa esse arquivo durante todo o ciclo de vida de desenvolvimento para implantar repetidamente essa infraestrutura. Seus recursos são implantados de maneira consistente.

O Bicep fornece sintaxe concisa, segurança de tipo confiável e suporte para reutilização de código. O Bicep oferece uma experiência de criação de primeira classe para suas soluções de infraestrutura como código no Azure.

Benefícios do Bíceps

O bíceps oferece as seguintes vantagens:

• Suporte para todos os tipos de recursos e versões de API: o Bicep suporta imediatamente todas as versões de visualização e GA para serviços do Azure. Assim que um provedor de recursos introduzir novos tipos de recursos e versões de API, você poderá usá-los em seu arquivo Bicep. Você não precisa esperar que as ferramentas sejam atualizadas antes de usar os novos serviços.

• Sintaxe simples: Quando comparados ao modelo JSON equivalente, os arquivos Bicep são mais concisos e fáceis de ler. O Bicep não requer conhecimento prévio de linguagens de programação. A sintaxe do bíceps é declarativa e especifica quais recursos e propriedades de recursos você deseja implantar.

  Os exemplos a seguir mostram a diferença entre um arquivo Bicep e o modelo JSON equivalente. Ambos os exemplos implantam uma conta de armazenamento:

  • Bicep
  • JSON

  param location string = resourceGroup().location
  param storageAccountName string = 'toylaunch${uniqueString(resourceGroup().id)}'
  
  resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
    name: storageAccountName
    location: location
    sku: {
      name: 'Standard_LRS'
    }
    kind: 'StorageV2'
    properties: {
      accessTier: 'Hot'
    }
  }
  

• Experiência de criação: Quando você usa a extensão Bicep para VS Code para criar seus arquivos Bicep, você obtém uma experiência de criação de primeira classe. O editor fornece segurança de tipo avançada, IntelliSense e validação de sintaxe.

  

  Você também pode criar arquivos Bicep no Visual Studio com a extensão Bicep para Visual Studio.

• Resultados repetíveis: implante sua infraestrutura durante todo o ciclo de vida de desenvolvimento com a confiança de que seus recursos serão implantados de forma consistente. Os arquivos Bicep são idempotentes, o que significa que você pode implantar o mesmo arquivo muitas vezes e obter os mesmos tipos de recursos no mesmo estado. Você pode desenvolver um arquivo que representa o estado desejado em vez de desenvolver muitos arquivos separados para representar atualizações. Por exemplo, o arquivo a seguir cria uma conta de armazenamento. Se você implantar esse modelo e a conta de armazenamento quando as propriedades especificadas já existirem, as alterações não serão feitas:

  • Bicep
  • JSON

  param location string = resourceGroup().location
  
  resource mystore 'Microsoft.Storage/storageAccounts@2023-05-01' = {
    name: 'mystorageaccount'
    location: location
    sku: {
      name: 'Standard_LRS'
    }
    kind: 'StorageV2'
  }
  

• Orquestração: Você não precisa se preocupar com as complexidades das operações de ordenação. O Resource Manager orquestra a implantação de recursos interdependentes para que eles sejam criados na ordem correta. Quando possível, o Resource Manager implanta recursos em paralelo, o que ajuda suas implantações a serem concluídas mais rapidamente do que as implantações seriais. Você implanta o arquivo por meio de um em vez de vários comandos imperativos.

  

• Modularidade: use módulos para segmentar seu código Bicep em partes gerenciáveis. Os módulos ajudam a reutilizar o código e simplificar o desenvolvimento. Um módulo implanta um conjunto de recursos relacionados. Adicione um módulo a um arquivo Bicep quando precisar implantar esses recursos.

• Integração com serviços do Azure: o Bicep integra-se com serviços do Azure, como a Política do Azure, especificações de modelo e Azure Blueprints.

• Visualizar alterações: você pode usar a operação hipotética para visualizar as alterações antes de implantar o arquivo Bicep. A operação hipotética mostra quais recursos criar, atualizar ou excluir e todas as propriedades de recursos a serem alteradas. Ele também verifica o estado atual do seu ambiente e elimina a necessidade de gerenciar esse estado.

• Nenhum arquivo de estado ou estado para gerenciar: o Azure armazena todo o estado. Você pode colaborar com outras pessoas e ter certeza de que suas atualizações são tratadas conforme o esperado.

• Sem custo e código aberto: Como o Bicep é gratuito, você não precisa pagar por recursos premium. O Suporte da Microsoft oferece suporte a isso.

Começar agora

Para começar a utilizar o Bicep:

1. Instale as ferramentas. Para obter mais informações, consulte Configurar ambientes de desenvolvimento e implantação do Bicep ou usar o repositório devcontainer/Codespaces do VS Code para obter um ambiente de criação pré-configurado.
2. Conclua os módulos de início rápido e aprendizado para o Bicep.

Para descompilar um modelo existente do Gerenciador de Recursos para Bicep, consulte Descompilando modelo ARM JSON para Bicep. Você pode usar o Bicep Playground para ver o Bicep e seu equivalente, JSON, lado a lado.

Para saber mais sobre os recursos disponíveis no seu ficheiro do Bicep, veja Referência de recursos do Bicep.

Você pode encontrar exemplos de Bicep no repositório Bicep GitHub.

Sobre a língua

O Bicep não se destina a ser uma linguagem de programação geral para escrever aplicações. Um arquivo Bicep declara recursos e propriedades de recursos do Azure sem escrever uma sequência de comandos de programação para criá-los.

Para acompanhar o status do trabalho do Bicep, consulte o repositório do projeto Bicep.

Para saber mais sobre o Bicep, assista ao seguinte vídeo:

Você pode usar Bicep em vez de JSON para desenvolver modelos do Gerenciador de Recursos. A sintaxe JSON para criar um modelo do Gerenciador de Recursos pode ser detalhada e exigir expressões complicadas. A sintaxe do bíceps reduz essa complexidade e melhora a experiência de desenvolvimento. Bicep é uma abstração transparente sobre um modelo JSON do Resource Manager que não perde os recursos de um modelo JSON. Durante a implantação, a CLI do Bicep converte um arquivo Bicep em um modelo JSON do Resource Manager.

Tipos de recursos, versões de API e propriedades válidas em um modelo do Gerenciador de Recursos são válidos em um arquivo Bicep.

O bíceps oferece uma sintaxe mais fácil e concisa quando comparado ao seu equivalente, JSON. Você não usa expressões [...]entre colchetes. Em vez disso, você chama diretamente funções e obtém valores de parâmetros e variáveis. Você dá a cada recurso implantado um nome simbólico, o que facilita a referência a esse recurso em seu modelo.

Para obter uma comparação completa da sintaxe, consulte Comparando JSON e Bicep para modelos.

O Bicep gerencia automaticamente as dependências entre recursos. Você pode evitar a configuração dependsOn quando o nome simbólico de um recurso é usado em outra declaração de recurso.

A estrutura do arquivo Bicep é mais flexível do que um modelo JSON. Você pode declarar parâmetros, variáveis e saídas em qualquer lugar do arquivo. Em JSON, você precisa declarar todos os parâmetros, variáveis e saídas dentro das seções correspondentes do modelo.

Obter suporte

Aqui estão as etapas para abrir um tíquete de suporte para problemas relacionados ao modelo do Azure Resource Manager (ARM):

1. Abra o portal do Azure.

2. Selecione o ícone Suporte + Solução de problemas no canto superior direito.

3. Em Descreva brevemente o problema, insira o modelo ARM e selecione Ir.

4. Em Qual serviço você está tendo um problema?, selecione Portal em Monitoramento & Gerenciamento e, em seguida, selecione Avançar.

5. Selecione uma subscrição e, em seguida, selecione Seguinte.

6. Selecione Problema com modelos ARM e, em seguida, selecione Avançar.

   

Próximos passos

Para começar, consulte o Guia de início rápido.

Para obter respostas a perguntas comuns, consulte Perguntas frequentes sobre o Bicep.