az-bicep:tldr:d8d8a

az-bicep: Upgrade Bicep CLI to the latest version.

$ az bicep upgrade

try on your machine

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.

This explanation was created by an AI. In most cases those are correct. But please always be careful and never run a command you are not sure if it is safe.

back to the az tool