Azure Bicep

For all you need to know about the Bicep language, check out the Bicep documentation.

What is Bicep?

Bicep is an infrastructure-as-code (IaC) programming language that uses declarative syntax to deploy Azure resources. In a Bicep file, you define the infrastructure you want to deploy to Azure and then use that file throughout the development lifecycle to repeatedly deploy that infrastructure. Your resources are deployed in a consistent manner.

Learn more about the language and benefits of using Bicep in the What is Bicep documentation.

Get started with Bicep

To get started with Bicep:

1. Install the tooling.
2. Complete the Fundamentals of Bicep Learning Path.
3. See the full list of Learn modules for Bicep.

[!TIP] If you're new to Bicep, start by installing the Bicep VS Code extension and deploying a simple resource (like a storage account) to get comfortable with the end-to-end workflow before moving to larger templates.

If you have an existing Azure Resource Manager (ARM) template or set of Azure resources that you want to convert to .bicep format, see the recommended workflow for migrating resources to Bicep and Decompiling an ARM Template.

Also, there's a rich library of Bicep modules in Azure Verified Modules and examples in the azure-quickstart-templates repo to help you get started. You can also use the Bicep Playground to try out Bicep in your browser.

If you're looking for production-ready and tested Bicep templates, you can find them in the bicep-registry-modules repo. Learn more about these templates on the Azure Verified Modules website: https://aka.ms/avm.

How does Bicep work?

First, author your Bicep code by using the Bicep language service as part of the Bicep VS Code extension.

Both Azure CLI (2.20.0+) and the PowerShell Az module (v5.6.0+) have Bicep support built in. This support means you can use the standard deployment commands with your *.bicep files. The tooling transpiles the code and sends it to ARM on your behalf. For example, to deploy main.bicep to a resource group my-rg, use the CLI command:

az deployment group create -f ./main.bicep -g my-rg

Goals

1. Build the best possible language for describing, validating, and deploying infrastructure to Azure.
2. The language should provide a transparent abstraction for the underlying platform. There must be no "onboarding step" to enable Bicep support for a new resource type or API version.
3. Code should be easy to understand at a glance and straightforward to learn, regardless of your experience with other programming languages.
4. Users should have a lot of freedom to modularize and re-use their code. Code re-use shouldn't require any 'copy/paste'-ing.
5. Tooling should provide a high level of resource discoverability and validation. Develop it alongside the compiler rather than adding it at the end.
6. Users should have a high level of confidence that their code is 'syntactically valid' before deploying.

Non-goals

1. Build a general-purpose language to meet any need. This language doesn't replace general-purpose languages. You might still need to do pre or post-Bicep execution tasks in a script or high-level programming language.
2. Provide a first-class provider model for non-Azure related tasks. While the extensibility model supports Microsoft Graph, official extension points are intended to be focused on Azure infra or application deployment related tasks.

FAQ

What unique benefits do you get with Bicep?

This is the beginning of the README. Read the rest at the original. Read the full README ↗