v0.4.63

Highlights

• Fixed a critical perf issue on macOS (#3044)

Bug fixes and features

Bicep team:

• Fix Bicep playground (#2991)
• Fix span calculation in ValidateSnippetCompletionAfterPlaceholderReplacements (#3021)
• Put param/var names in linter messages where "Unused" (#2899)
• Make DTC error messages more informative (#2941)
• Block completions at positions where nodes should not be inserted (Part II) (#2995)
• Port arm tools snippets - part 6 (#2782)

Docs, examples, and snippet updates

Bicep team:

• edits for ttk use (#2989)

@ChristopherGLewis

• Additional samples for the 000 level syntax examples (#2896)

@MCKLMT

• Update homebrew to v0.4.1 (#2971)

@Strepto

• Remove duplicate 'get' from keyvault snippet (v2) (#2967)

@slavizh

• improves sql-database-with-management example (#2970)

@tw3lveparsecs

• 301-log-analytics-with-datasources-solutions (#2932)

v0.4.1

Highlights

Bicep team:

• Linter MVP (#2341)
  • Docs
• Strip out deprecated parameter modifier syntax (#2870)
  • this removes support for the already deprecated param foo string { minLength: 3 } modifier syntax
  • new syntax (i.e. @minLength(3)) is documented here
• More snippets
• More bug fixes

Other features and bug fixes

Bicep team:

• Bump types nuget -> 0.1.157 (#2898)
• Improved handling of array access base expression union types (#2696)
• Removed static analysis false positive (#2867)
• Blocked non-object assignment to module params (#2875)
• improved union type normalization (#2886)
• Fix a regression in nested resource completion (#2727)
• Handle more (if not all) corner cases in DTC validation (#2769)
• Intellisense for bicepconfig.json within vscode (#2874)
• Initial changes to add telemetry (#2774)

@miqm

• Fixed Key Vault Secret Reference usage with looped resource (#2872)

@slapointe

• managementGroup in module scope now generate as unqualified instead of tenantResourceId (#2719)
• Auto-close multi-line comments (#2843)

Docs, snippets, and examples

Bicep team:

• Linter doc updates (#2842)
• Small readme tweaks, removed a known limitation (#2778)

@emilguden

• Api Management Instance Snippet (#2758)

@MCKLMT

• Update Homebrew to v0.3.539 (#2836)

@akasnik

• WVDcreate hostpool (#2770)

v0.3.539

Highlights

• Bicep visualizer (#2357)
• Scaffold required resource snippet based on the resourceType & apiVersion (#2172)
  • also works for modules! (#2658)
• More snippets
  • Port ARM snippets to bicep - part 2 (#2207)
  • Port ARM snippets to bicep - part 3 (#2544)
  • Port ARM snippets to bicep - part 4 (#2651)
• Two part resource type completion (#2485)
  • This cleans up the completions list for resource types
• Lots of bug fixes

@miqm

• Key vault secret reference for secure string module param (#1571)
  • spec

Features and bug fixes

Bicep team:

• Support type checking on intermediary variables (#2444)
• Generate correct resourceIds for 3rd generation resource with non-parent-property parent (#2273)
• Support 'outer' scopes for decompilation (plus other minor fixes) (#2338)
• Decompiler - format output with the 'parent' property where possible (#2363)
• Decompile variable copy loops (#2370)
• Decompile reference() functions with resource name references (#2381)
• block any() in scope, parent and dependsOn (#2359)
• slash validation for loops (#2387)
• added cross scoping for tenant resources (#2386)
• Added invariant properties warning & fixed duplicate error in loops (#2465)
• include colon in property name completions (#2482)
• removed "parent" property from syntactically nested resources (#2603)
• Removed the colon character from commit chars on property name completions. (#2661)
• Fix scope for conditional resources (#2250)
• Support decompiling templates with extensions that are not .json (#2201)
• Block referencing location of existing resources (#2261)
• Improve deploy-time constant checking (#2345)
• Deploy time constant and direct resource/module collection reference fixes (#2461)
• Fix issue #2484 (#2503)
• Fix syntax highlighting for expressions in string interpolations (#2554)
• Provide completions immediately after '{' in string expressions (#2596)
• Block runtime property refs in runtime functions, fix a stack overflow (#2623)
• Improve error recovery for expressions (#2640)
• Block completions in locations where inserting nodes makes no sense (Part I) (#2670)

@piraces:

• Support the same 'Options' on bicep decompile as with bicep build (#2460)

@miqm

• Simplified Homebrew installation flow (#2208)

Docs, snippets, and examples

Bicep team:

• added docs for the msbuild task (#2191)
• Updated "known limitations" (#2492)
• added template spec deploy example (#2499)
• fix example to use parent syntax (#2550)
• completions for the "existing" keyword (#2253)
• decompile loops with conditions (#2259)
• Update AKS cluster snippet (#2244)
• Add snippets contribution guide (#2240)
• Remove diagnostics.json, add main.combined.bicep (#2257)
• Update snippets to latest api-versions (#2277)
• Snippet standards and naming conventions (#2307)

@afscrome:

• Add az bicep version to bug report template (#2282)

@masters3d:

• fix resource-scopes broken link missing .md (#2388)

@dracan:

• Fix param description (#2459)

@fberson:

• Contributed 3 new snippets for WVD resources (#2256)
• New Code Snippet example for Template Specs (#2298)
• New Snippet example for Shared Image Gallery (#2310)
• Corrected applicationGroupType Values (#2390)

@jesseloudon:

• New example for a DINE policy Azure Monitor Agent and Data Collection Rule (DCR) association (#2142)

@KaiWalter:

• fix issue #2311 - add location to firewall resource in examples/101/azurefirewall-create-with-zones (#2312)

@matsest:

• docs: add variable loops to spec (#2342)

@drmiru:

• added private endpoint for file storage account (#1651)

@MCKLMT:

• Update Homebrew to 0.3.255 (#2202)

@pinakighatak:

• Added examples for Modular API Management (101) and Importing API to APIM (301) (#2223)

@slavizh:

• Example: Add SQL Database with managemnet solution example (#2348)

@StefanIvemo:

• Added empty properties object to res-recovery-service-vault snippet (#2353)
• Added Virtual WAN Snippet (#2354)
• Minor formatting fixes for CONTRIBUTING.md (#2352)
• Updated all docs examples with higlighting (#2443)
• fixed parameter in loop example (#2480)
• Added VNet Peering snippet (#2383)
• Minor README.md fixes (#2570)

@takekazuomi:

• Example - ARM Template Create a Private AKS Cluster (#2155)
• typo fix. Fixed listKey to listKeys. (#2206)

@t-walker:

• updating cicd documentation s/files/file (#2657)

@wpouseele:

• Update readme.md (#2249)

@elasticdotventures:

• Update README.md (#2133)
• fixed invalid example (#2132)
• Example Improvements related to issue #2135 (KeyVault secretsObject) (#2139)

@ochzhen:

• Fix reference to the parent resource (#2309)

v0.3.255

Highlights

• var loops (#2077)
  • i.e. var foo = [for i in range(0,10): 'value${i}']
• Add type descriptions to completions and hovers, support method hovers. (#1915)
• Initial support for resource snippets for specific resource types
  • Eventually this will be at parity with the snippets in ARM Tools
• Add support for name discriminators on resource types (#1950)
  • allows us to properly validate resources like microsoft.keyVault/vaults/accessPolicies and microsoft.web/sites/config
• Add textmate grammar (#2069)
  • this will power syntax highlighting in GitHub and Azure DevOps very soon
• msbuild task and cli nugets (#1992)
  • this is to support converting our internal ARM Template usage to Bicep, but is available externally as well (docs available with #2191)

Features and bug fixes

Bicep team:

• Bump types package (#2200)
• Fix for issue 1985 (#1989)
• Flow dependsOn detection through 'existing' resource definitions (#1991)
• Fix bad string escaping in ARM template generation (#2006)
• Correct providers() return type (again...) (#2018)
• Added return types to signature help (#2089)
• no property value completions before the colon (#2121)
• Implement special handling for allowed array values (#2169)
• Update top level param with option to use @secure syntax (#2019)
• Update deprecated snippet for parameter types- secureObject, secureString (#2038)
• Update deprecated param snippet and move snippets to template files (#2130)

Docs and examples

Bicep Team:

• added unicode doc (#2094)
• Add badges for Good First Issue and Needs Feedback (#2083)
• Adding section for GetHelp, Report an Issue (#2035)
• Update to readme to include to common questions in FAQ (#1954)
• Update 05-loops-conditions-existing.md (#2102)

@ChristopherGLewis:

• Added Hello World syntax sample (#2011)

@jesseloudon:

• Updates to example for deployifnotexists-policy-with-initiative-and-assignment (#1953)

@Jaykul:

• Corrections for operator descriptions (#2016)

@kurtfurbush:

• bad link (#1947)

@thepaulmacca:

• updated outputs link (#1998)

@pinakighatak:

• Using Bicep CLI directly without installing binaries (#1903)

@StefanIvemo:

• Added missing colon to array output loop (#1948)
• Example - ARM Template Deployment Script development environment (#1961)

@sscchh2001:

• Update nic.bicep (#1577)

v0.3.126

Highlights

• Improvements to child resource declarations
  • Nested child resources (#1516) (@rynowak)
    • spec
  • Change resource access operator to :: (#1815) (@rynowak)
  • Parent property implementation (#1800)
    • spec
• Loop enhancements spec
  • index loop syntax (#1790)
  • batchSize(int) decorator and misc. decorator fixes (#1714)
  • resource/module loop filters (#1884)
  • Resource & property loop decompilation (#1640)
  • Add support for decompiling output loops (#1732)
• Parameter modifier syntax is now marked as deprecated in favor of decorators
  • Support for the old syntax will be removed in v0.4

Features and bug fixes

Bicep Team:

• Avoid unhandled exception for duplicate properties (#1771)
• Correct codegen for module name reference (#1733)
• Fix for issue 1817 (#1825)
• Fixes for nested resource and scope interop issues (#1827)
• Add decompiler support for templateLink.relativePath (#1850)
• Add type definitions for providers() (#1877)
• Add rewriter to simplify loop statements generated by the decompiler (#1873)
• Add test framework to evaluate a template containing expressions (#1875)
• Avoid showing completions inside strings (#1933)
• Display custom warning for resource type with /providers/ (#1943)
• Upgrade types libraries to 0.1.94 (#1940)
• Negative integer literals are compile-time constants (#1836)
• fixed misc. scope issues (#1834)
• Snippet for resource/module conditions (#1856)
• Fixed property value context with partially typed identifiers (#1907)
• Fix stack overflow when formatting large templates (#1668)
• Fix issue #1627 (#1901)
• Ensure minLength and maxLength take non-negative values (#1902)
• Add a job to build Bicep CLI for linux-musl-x64 (#1752)
• Ban duplicate decorators (#1854)

@miqm:

• Return "custom" in bicep's version when AssemblyInfromationalVersion does not have commit hash. (#1721)
• Using ApiVersionComparer to sort Resource Types (#1784)
• Improved error message on existing resource properties (#1881)

Doc updates

Bicep Team:

• Add documentation on updating baselines via GH Action (#1878)
• Update examples to use decorators (#1685)
• Mark parameter modifiers as deprecated and update spec (#1693)
• Fix typos in docs, test names and comments (#1751)

@lrottach:

• Changed 'name' parameter to avoid deployment errors while following the tutorial (#1861)

@thepaulmacca::

• fixed 'via Az CLI' link (#1678)

@pinakighatak:

• curl download file extension added (#1896)

@takekazuomi:

• fix sample code typo. without quote and extra comma. (#1666)

@wayneforrester:

• Update 06-creating-modules.md (#1747)

@barker1889:

• Update 05-loops-conditions-existing.md (#1844)

Examples

@vermegi:

• Added example app-service-regional-vnet-integration (#1744)

@jesseloudon:

• add DeployIfNotExists policy bicep example (#1763)

@jhueppauff:

• Fixed comments (#1775)

@MCKLMT:

• Add vm-copy-managed-disks example (#1700)

@StefanIvemo:

• Added example for looping outputs (#1681)

v0.3.1

Highlights

• Support for loops (#1469, #1521, #1628, #1647)
• Support for existing keyword (#1339)
• New "decorators"-style parameter modifier syntax (#1324)
• Support for multi-line strings (#1542)
• Allow output names to overlap with symbols (#1623)

Feature work and bug fixes

Bicep team:

• Include API version for generated reference() function calls on 'existing' resources (#1466)
• Block runtime properties for resource/module 'scope' (#1467)
• Fix for duplicate semantic tokens (#1503)
• Fix erroneous environment() type definition (#1528)
• Allow decompilation of and() & or() with >2 params (#1526)
• Add --outdir, --outfile params to build command (#1519)
• Block cross-scope resource deployment without modules (#1559)
• Added basic unicode support (#1370)
• module file path completions (#1236)
• Added ResourceGroup and SubscriptionId fields to nested deployment resource (#1433)
• Added generated metadata info (#1533)

@miqm:

• Fixed interpolated StringSyntax used in object's property name (#1375)
• ARM Integer type is now long instead int (#1334)
• Permitted resourceGroup -> subscription (self and named) and subscription -> resourceGroup in named subscription deployments. (#1420)
• Added single qoute as completion trigger character (#1377)
• Replacing coalesce function with double question mark ?? operator (#1489)

@StefanIvemo:

• Updated Bicep Playground Favicon (#1543)

Doc updates

@ciwchris:

• Fix typos in creating modules tutorial (#1654)

@JFolberth:

• Update Readme 'life better' section (#1481)

@piraces:

• Add new community contribution to README.md (#1419)

Examples

@fberson:

• New exmaple: Vnet with Subnet and USer Defined Route (#1459)

@JFolberth:

• added automation account with logging (#1381)

@johndowns:

• Fix default HTTPS port number in Front Door examples (#1397)
• Add example for HTTP-triggered function (#1437)
• Add sample for adding storage static website (with deployment script) (#1442)

@MarcusFelling:

• Add example to deploy app + data + identity + monitoring (#1395)

@ehrnst:

• Added example for custom policy definition with assignment (#1394)

@MCKLMT:

• Add traffic-manager-webapp example (#1414)

@sebader:

• Azure Portal Dashboard sample (#1486)

v0.2.328 (alpha)

Bicep Team:

• Addressed a versioning issue from the previous release that prevented publishing of the Bicep extension to the VS gallery (#1365)
• Stop triggering build on tags (#1345)

v0.2.317 (alpha)

Features and fixes

Bicep Team:

• setup.exe (bicep-setup-win-x64) and bicep.exe (bicep-release-win-x64) for windows are now both signed, so you will no longer trigger smartscreen on windows (#1344)
• Filter available resource types by target scope (#1321)
• Support resourceGroup function with targetScope set to tenant & managementGroup scopes (#1211)
• Added signature help (#1273)
• Enable completions inside parenthesized expressions (#1221)
• Block Runtime property references for resource and module names (#928)

@miqm:

• Detecting duplicate resource and module names (#1204)
• Added deployment().properties.templateLink.id property (#1311)

Docs

Bicep Team:

• misc updates to readme, added PR template, added small ci/cd doc (#1245)

@ctaggart:

• markdown fix for: Conditionally declare a property value (#1194)

@JFolberth:

• Updating modules to illustrate if condition (#1210)

Examples

@fberson:

• Adding Windows10 with NVidia Extension example (#1232)
• New Example: SIG with Image Definition and Role Assignment (#1251)
• Suggestion to use implicit Depends On for the DomaiJoin extension (#1258)

@JFolberth:

• Adding Example of modules with deploying web application with log analytics (#1200)
• Example of Condition deploy logging resource for Web App (#1199)

@MCKLMT:

• Add vnet-to-vnet-peering example (#1274)
• Add templatespec-create example (#1288)
• Add create-and-enable-ddos-protection-plans example (#1287)
• Add event-grid-servicebus-queue example (#1294)
• Add web-app-asev2-create example (#1295)
• Add private-endpoint-webapp example (#1296)
• Add media-services-create example (#1297)
• Add sqlmi-new-vnet example (#1298)
• Add expressroute-circuit-vnet-connection example (#1309)
• Add insights-alertrules-application-insights example (#1308)
• Add webapp-managed-mysql example (#1305)
• Add asev2-ilb-with-web-app example (#1307)

@Saglodha:

• adding batch account template (#1222)
• Adding msi and rbac template (#1260)

@StefanIvemo:

• Updated decompiling.md limitations (#1201)
• Added link to Bicep PowerShell Module in readme (#1333)

v0.2.212 (alpha)

Highlights

• Support for conditional resources (#1014) spec
  • Supported for decompilation (#1150)
• Support for the scope property for extension resources (#1162) spec
  • This allows you to configure resources like resource locks and role assignments on individual resources
  • Supported for decompilation (#1190)
• Major perf improvement when loading the extension (#1147)

Feature work and bug fixes

Bicep team:

• Add type definition for properties.templateLink.uri to deployments() return value (#986)
• Remove some limitations for decompiling nested/linked templates (#1001)
• Allow the list() function (#1065)
• Emit location automatically for non-rg module scopes (#1129)
• Allow cross-subscription deployments (#1165)
• Fix inlining behavior for modules (#1181)
• Set intellisense defaults (#1019)
• Fixed declaration type completions when extra whitespace is present (#1107)
• Fixed functions signatures in vararg functions (#1124)
• Added a function overload builder (#1126)
• upload language server artifact (#1152)
• Added function descriptions and parameter names (#1180)
• Implement retrying logic for VSCode E2E tests (#1096)
• Use relative path for user data and add logging (#1112)
• Fix an example file (#1184)

@miqm:

• Expanding Completion of objects & arrays to multiple lines (#1012)

@ljtill:

• Update bicep.rb (#993)

Doc updates

Bicep team:

• Add pointer to playground for decompilation (#1005)
• Brief document on decompile command (#998)
• Add decompiler info to README (#1172)

@JFolberth:

• Update CONTRIBUTING.md (#1068)

@jongio:

• Add blank file create command (#1008)

@vhorne:

• Update 01-simple-template.md (#1062)
• Update 01-simple-template.md (#1063)

@StefanIvemo:

• Updated 02-deploying-a-bicep-file.md (#1070)
• Updated 06-convert-arm-template.md (#1074)

@miqm:

• Update CONTRIBUTING.md with instruction to run Bicep VSCode extension when using WSL2 (#972)

@lawrencegripper:

• Add note about using devcontainer to get started (#1090)

@emilguden:

• Update 02-deploying-a-bicep-file.md (#1157)
• Update 03-using-expressions.md (#1160)
• Update 04-using-symbolic-resource-name.md (#1163)

Examples

Bicep team:

• deployment script example with no managed identity (#1006)

@fberson:

• TypeDiagnostics DesktopVirtualization (#1007)
• Bicep file that creates a basic WVD Backplane (#1003)
• added wvd-backplane example (#1009)
• diagnosticSettings WVD Workspaces (#1011)
• multi-module WVD deployment with some prereqs (#1010)
• Added readme.md (#1047)

@JFolberth:

• adding windows web app (#996)
• Added DataFactory Blob Copy Example, reordered missing types tests (#999)
• ReOrder examples on how they appear in Playground (#1040)
• Update CONTRIBUTING.md (#1068)
• Cosmosdb free (#1110)
• adding eventhub and missing type (#1111)

@miqm:

• [Example] Function App on Consumption Plan with Custom Domain and App Serivce Managed Certificate (#971)

@StefanIvemo:

• Added example modules-vwan-to-vnet-s2s-with-fw (#1018)

@wilfriedwoivre:

• Add sample for custom role definition and assignment (#1045)

@lr90:

• LR90 aadds example (#1158)

@MarcusFelling:

• Add web-app-linux example (#1148)

@mbsnl:

• Example: Azure Front Door w/ Web Application Firewall (#1076)

@MCKLMT:

• Add Data Lake Store example (#1029)
• Add Azure Search example (#1025)
• Add SQL database example (#1022)
• Add Azure DataFactory example (#1027)
• Add ACI Linux Public IP example (#1039)
• Add VM domain join example (#1038)
• Add API management with MSI example (#1037)
• Add ServiceBus and Queue example (#1032)
• Add VM scaleset with autoscaling example (#1033)
• Add Application Gateway v2 example (#1036)
• Add CDN with storage account example (#1030)
• Add WebApp and SQL database example (#1034)
• Add Cognitive Services example (#1052)
• Add WebApps Private Endpoint and Vnet-Injection example (#1053)
• Add expressroute-circuit-create example (#1059)
• Add function-premium-vnet-integration example (#1057)
• Add event-hub-and-consumer-group example (#1056)
• Add ServiceBus Namespace VNet (#1054)
• Add missing examples and sort them by name (#1066)
• Add nat-gateway-vnet example (#1091)
• Add azure-bastion example (#1122)
• Add azurefirewall-create-with-zones example (#1144)
• Add cosmosdb-private-endpoint example (#1127)
• Add hdinsight-spark-linux example (#1128)
• Add private-dns-zone example (#1130)
• Add azure-spring-cloud example (#1133)
• Add azure-sentinel example (#1132)
• Add aci-sftp-files example (#1159)
• Add api-management-create-all-resources example (#1131)

v0.2.59 (alpha)

@JFolberth:

• Update documentation (#908)

@johndowns

• Add missing examples (#919)
• Add Redis Cache example (#976)
• Fix string concatenation in Redis example (#984)

@ljtill:

• Bump homebrew from v0.2.6 to v0.2.14 (#915)

@miqm:

• Do not show completions inside comments (#974)

@StefanIvemo:

• Fixed typos (#975)

@wilfriedwoivre:

• Add sample for hub & spoke topology (#927)

@heikkiri:

• Update resource-scopes.md (#937)

@lr90:

• Multi Resource Group, Scope example (#921)
• Removing concats and polishing for 0.2.14 (#944)

Team Bicep:

• new any() doc, updates to arm2bicep doc, example cleanup (#936)
• Fix vscode launch commands (#913)
• Implement bicep decompile command (#833)
• Rename namespaces to avoid clashes with class names (#967)
• Make playground buttons look like buttons, display tooltips (#981)
• Add syntax rewriter framework and some decompiler simplification rewriters (#953)
• Add type definitions for environment() & deployment() built-ins (#983)
• Updated to .net 5 (#911)
• initial type system documentation (#914)
• Run VSIX tests on all platforms (#930)
• Create E2E tests for Bicep CLI commands (#938)
• Set PrivateAssets to all for analyzer packages (#948)
• Fix Span of ProgramSyntax (#954)
• Update spec for resource conditions (#966)