![Forrest logo](/images/logo.png)
az-bicep:tldr:d8d8a
The az bicep upgrade
command is used to upgrade an existing Azure Resource Manager (ARM) template to the latest version of the Bicep language.
Bicep is a domain-specific language (DSL) that simplifies the authoring and management of Azure resource deployments. It serves as a declarative syntax on top of ARM templates, providing a more intuitive and concise way to define and deploy Azure resources.
The az bicep upgrade
command allows you to convert an existing ARM template (in JSON format) to its equivalent Bicep representation. This conversion helps leverage the benefits of Bicep's improved readability, modularity, and maintainability while working with Azure resource deployments.
By running this command, you provide the path to the existing ARM template file or folder that contains multiple templates. Bicep will analyze the templates, detect the target version of Bicep, and automatically convert them to the latest Bicep format. It will preserve the original JSON template file(s) and create new Bicep files with the .bicep
extension.
Upgrading to the latest version of Bicep ensures compatibility with the latest features, improvements, and bug fixes. However, it is important to review the converted Bicep files and validate any required changes or updates to the code after the conversion process.