Azure/bicep v0.35.1

on GitHub

Highlights

• GA release for the @secure() decorator on module outputs! You can now output secure values from a child module and read them in a parent module. (#16796)

• Visual Studio Bicep extension support for .bicepparam files! (#16861)

• New functions for working with URIs - parseUri() and buildUri() (#16802)
  Example usage:

  /* 
  Returns
  {
    scheme: 'https'
    host: 'example.com'
    port: 1234
    path: '/foo/bar'
  }
  */
  output parsedUri object = parseUri('https://example.com:1234/foo/bar')
  
  /*
  Returns:
  'https://example.com:1234/foo/bar'
  */
  output builtUri string = buildUri({
    scheme: 'https'
    host: 'example.com'
    port: 1234
    path: 'foo/bar'
  })

• New functions for working with Availaiblity Zones (#16985)

  • toLogicalZone() - converts physical zones to logical zones
  • toPhysicalZone() - converts logical zones to physical zones
  • Array versions for bulk conversions (toLogicalZones() & toPhysicalZones())

  var subscriptionId = subscription().subscriptionId
  var location = 'westus2'
  /*
  Returns the physical AZ corresponding to the specified logical AZ in the specified subscription and location.
  For westus2 location, this will be one of 'westus2-az1', 'westus2-az2', 'westus2-az3' depending on the subscription.
  */
  output singlePhysicalZone string = toPhysicalZone(subscriptionId, location, '1')
  /*
  Returns an array of physical AZs corresponding to the specified logical AZs in the specified subscription and location.
  */
  output physicalZones string[] = toPhysicalZones(subscriptionId, location, ['1', '2'])
  /*
  Returns the logical AZ corresponding to the specified physical AZ in the specified subscription and location.
  Returns '1', '2', or '3' depending on the subscription.
  */
  output singleLogicalZone string = toLogicalZone(subscriptionId, location, 'westus2-az2')
  /*
  Returns an array of logical AZs corresponding to the specified physical AZs in the specified subscription and location.
  */
  output logicalZones string[] = toLogicalZones(subscriptionId, location, [
    'westus2-az1'
    'westus2-az2'
  ])

• use-secure-value-for-secure-inputs linter rule: Use resource type information to catch more unsafe passing of non-secure values (#16873)

• [requires the onlyIfNotExists experimental feature] Resource Existence Checks using @onlyIfNotExists() decorator (#16655)
  Attaching this decorator to a resource declaration means deployment of the resource will only take place if it hasn't already been deployed. Example usage:

  @onlyIfNotExists()
  resource onlyDeployIfNotExists 'Microsoft...' = {
    name: 'example'
    location: 'eastus'
    properties: {
      ...
    }
  }

• [requires the typedVariables experimental feature] Support importing and declaring types in .bicepparam files with typedVariables decorator (#16929)

  • Allow usage of the type keyword in .bicepparam files
  • Allow importing types from .bicep files in .bicepparam files
  • Allow usage of inline types in .bicepparam files

• [requires the externalInputFunction experimental feature] External Input function - externalInput function to allow reading input that will be resolved later by external tooling in order to inject values at deployment time. (#16726)

Bugs and Features

• Decompiler support for user-defined functions (#16883)
• use-parent-property linter rule: Fix incorrect warning with blobContainer and fileShare (#16738)
• Raise diagnostic for unsupported usage of spread (#16739)
• Add friendly name to Playground link (#16803)
• Revert #16442 - Fixed bug VSCode extension does not read values from parameter file (#16789)
• no-hardcoded-env-urls linter rule: Remove URLs not present in environment() function output (#16863)
• Fix for intellisense of symbols inside import statement (#16936)
• fixing dotnet format issues, and addressing IDE0305: Collection initialization can be simplified errors/warnings (#16808)
• Use symbolic name for list function calls (#16862)
• Enhance substring type inference - updated parameter types for substring to infer acceptable ranges based on the other arguments provided to the function. (#16859)
• Prevent infinite recursion during type narrowing (#17028)
• Fix command binding comment in bicepconfig.json (#16807)
• use-resource-id-functions linter rule: Set to off by default (#16869)

.bicepparam Bug Fixes

• Suggest the experimental feature on the extends keyword for extendableparamfiles (#16744)
• adding checks to ensure the given file exists before building the bicepparam file (#16742)
• Clarifying parameter file generation logic and error message (#16662)

Local Deploy

• Local Deploy: process kill should be best-effort only (#16786)
• Local Deploy: Support deploying Azure modules (#16752)
• Local Deploy: Support long-running operations for local and Azure modules (#16797)
• Documentation: Replace deploy pane content with link to MSDocs (#16736)
• Local deploy: ensure languageversion 2.2-experimental emitting is enabled (#16945)

Community Contributions

• Remove unused methods (#16927) - thanks @eerhardt !
• Update DSC schema v3 (#16685) - thanks @Gijsreyn !
• support --pattern --outdir (#16882) - Thanks @NaridaL !
  Example usage:

  bicep build --pattern './foo/**/*.bicep' --outdir ./bar
  bicep build-params --pattern './foo/**/*.bicepparam' --outdir ./bar