[AzureResourceManagerTemplateDeployment@3] - support bicep deployment

[ozbillwang]

Note

Azure Bicep can be deployed via az deployment group create -f ./main.bicep -g my-rg now.

Required Information

When feed bicep files, the task marks it invalid

Question, Bug, or Feature?

Feature

Enter Task Name: here

• AzureResourceManagerTemplateDeployment@3

Environment

az version{
  "azure-cli": "2.27.1",
  "azure-cli-core": "2.27.1",
  "azure-cli-telemetry": "1.0.6",
  "extensions": {
  }
}

Issue Description

[error]Error: Ensure the Template file ( '/agent/_work/1/s/vm/main.bicep' ) is valid. Task failed while parsing with following error: Unexpected token p in JSON at position 0

[anthony-c-martin]

Looks like we'll need to:

• Copy the code in https://github.com/microsoft/azure-pipelines-tasks/blob/32a89fc20495ed0ddf3d8577f66b89739143e0a8/Tasks/Common/utility-common-v2/helmutility.ts to create a utility to install the Bicep executable.
• Check the file extension when this command is invoked, and if it is .bicep, ensure Bicep is installed before invoking a bicep build.
• Report errors from the build step if there are any, or start the deployment if not.

Happy to help with questions or to review a change if someone else feels like attempting it. Otherwise, I'll try to implement this myself if I get some free time.

[anthony-c-martin]

Looks like we'll need to:

• Copy the code in https://github.com/microsoft/azure-pipelines-tasks/blob/32a89fc20495ed0ddf3d8577f66b89739143e0a8/Tasks/Common/utility-common-v2/helmutility.ts to create a utility to install the Bicep executable.
• Check the file extension when this command is invoked, and if it is .bicep, ensure Bicep is installed before invoking a bicep build.
• Report errors from the build step if there are any, or start the deployment if not.

@bishal-pdMSFT - would you be willing to accept a contribution following this design? Is there anything missing/needing to be changed?

[johndowns]

This would be extremely helpful. @bishal-pdMSFT Any update on whether this might be accepted?

[bishal-pdMSFT]

Adding @NAGA-BANDI and @v-abajaj who own the ARM deploy task now

[marvinbuss]

Agreed. The GH Action also supports this and it would be great to get a consistent experience in ADO and GH.

[johndowns]

@NAGA-BANDI and @v-abajaj - any thoughts on @anthony-c-martin's proposal?

[johndowns]

@bishal-pdMSFT @NAGA-BANDI and @v-abajaj are you able to look at this please?

[t-dedah]

@marvinbuss @johndowns Raised a PR for mitigation. #15788

For first iteration, we are only supporting bicep if azure cli installed >= 2.20.0. we are still looking into installation script for bicep cli.

Also we are only adding this support for "Linked Artifact" case as for the other case url for the template and parameters are directly passed to armclient. We will need to see if support for bicep can be added directly to armclient for second case as downloading the file and then converting it to json and then treating it as "Linked Artifact" case doesnt seem efficient.

Please review the PR and let us know if anything else is needed.

[johndowns]

Thanks @t-dedah. Great to see this progressing!

@anthony-c-martin is probably best to review this from a code perspective. I've made a few minor suggestions around wording of messages and Markdown files.

cc @alex-frankel

[marvinbuss]

@t-dedah I think this can be closed, since #15788 was merged?
Thanks for fixing this!