O que é 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. Os seus recursos são implementados de forma 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 ideal 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, eles ficarão disponíveis para uso no seu arquivo Bicep. Você não precisa esperar que as ferramentas sejam atualizadas antes de usar 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 Bicep é declarativa e especifica quais recursos e propriedades de recursos 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:

  • Bíceps
  • 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:

  • Bíceps
  • 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 de ordenar as operações. O Azure 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 dividir o seu código Bicep em partes manejá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: Pode usar a opção de cenários hipotéticos para visualizar as alterações antes de implantar o arquivo Bicep. A operação 'e se' mostra quais recursos criar, atualizar ou excluir e quaisquer 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 estado ou arquivos de estado para gerenciar: o Azure armazena todos os estados. 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 paga por recursos premium. O Suporte da Microsoft oferece suporte a isso.

Introdução

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 use o repositório devcontainer/Codespaces do VS Code para obter um ambiente de criação pré-configurado.

2. Completa o Quickstart.

Para descompilar um modelo existente do Resource Manager para Bicep, consulte Descompilar um modelo JSON Azure Resource Manager para Bicep. Você pode usar Bicep Playground para ver o Bicep e o 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.

Bicep oferece uma sintaxe mais fácil e concisa do que 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 ARM templates e, em seguida, selecione Avançar.

   

Contribua para o projeto Bicep

O Bicep é um projeto de código aberto. Isso significa que podes contribuir para o desenvolvimento do Bicep e participar na comunidade Bicep mais abrangente. Os tipos de contribuição incluem:

• Modelos de início rápido do Azure. Você pode contribuir com arquivos Bicep de exemplo e modelos ARM para o repositório de Modelos de Início Rápido do Azure. Para obter mais informações, consulte o guia de contribuição de Modelos de Início Rápido do Azure.
• Documentação. A documentação do Bicep também está aberta a contribuições. Para obter mais informações, consulte nossa visão geral do guia do colaborador.
• Trechos. Você tem um trecho favorito do qual você acha que a comunidade se beneficiaria? Você pode adicioná-lo à coleção de trechos da extensão Visual Studio Code. Para obter mais informações, consulte Contribuindo para o Bicep.
• Alterações de código. Se você é um desenvolvedor e tem ideias que gostaria de ver na linguagem ou ferramentas do Bicep, você pode contribuir com uma solicitação pull. Para obter mais informações, consulte Contribuindo para o Bicep.

Próximos passos

• Para começar, consulte Guia de início rápido: criar arquivos Bicep com o Visual Studio Code.
• Para obter respostas a perguntas comuns, consulte Perguntas frequentes sobre o Bicep.