learn-bicep.md

Get Comfortable with Azure Bicep

Meta

• Short link to this Gist: timw.info/bicep2022
• Tim's website
• Tim's Twitter
• Tim's "Frankenstein" repository

Tools

• PowerShell 7
• Azure PowerShell
• Azure CLI
• Visual Studio Code
  • PowerShell extension
  • ARM Tools extension
  • Azure CLI extension
  • Azure Bicep extension
• Azure Bicep repository (releases)
• Azure Bicep PowerShell module
• Azure Bicep CI/CD with Azure DevOps
• Azure Bicep CI/CD with GitHub Actions

Training

• ARM/Bicep Template Reference
• Bicep docs
• Bicep @ Microsoft Learn
• Bicep Playground
• Bicep Authoring Devcontainer
• Bicep Pluralsight course
• Bicep private module registry

Common Bicep operations

Install Bicep CLI in Azure CLI

az bicep install

az bicep version

az bicep upgrade

Convert .bicep to .json

bicep build .\main.bicep --outfile .\arm-main.json

az bicep build --file .\main.bicep

Convert .json to .bicep

bicep decompile .\arm-main.json --outfile .\arm.bicep

az bicep decompile --file .\arm-main.json

Resource group deployments

PowerShell

New-AzResourceGroupDeployment -ResourceGroupName 'test-rg' -TemplateFile '.\main.bicep' -WhatIf

Azure CLI

az deployment group create --resource-group 'test-rg' --template-file '.\main.bicep'

Bicep PowerShell Module

Installation and discovery

Install-Module -Name Bicep -Verbose -Force

Update-Help -Force -ErrorAction SilentlyContinue

Get-Command -Module Bicep

Create JSON parameter file from a Bicep file

New-BicepParameterFile -Path '.\AzureFirewall.bicep' -Parameters All

Validate a Bicep file

PS C:\> Test-BicepFile -Path 'MyBicep.bicep' -AcceptDiagnosticLevel 'Warning'