Support deploying Azure resources with parameters file described with the Bicep language (#21567)

* add integration test for deployment using bicepparam

* add changes for bicepparam file deployment

* updated changelog

---------

Co-authored-by: Yunchi Wang <[email protected]>

Author: Usman0111

src/Resources/ResourceManager/Implementation/CmdletBase/ResourceWithParameterCmdletBase.cs

@@ -19,7 +19,7 @@
 using Microsoft.Azure.Management.ResourceManager;
 using Microsoft.Azure.Management.ResourceManager.Models;
 using Microsoft.WindowsAzure.Commands.Utilities.Common;
-
+using Newtonsoft.Json.Bson;
 using Newtonsoft.Json.Linq;
 
 using System;
@@ -191,9 +191,19 @@ protected override void OnBeginProcessing()
                 throw new NotSupportedException($"'-TemplateUri {TemplateUri}' is not supported. Please download the bicep file and pass it using -TemplateFile.");
             }
 
+            if (BicepUtility.IsBicepparamFile(TemplateParameterFile) && !BicepUtility.IsBicepFile(TemplateFile))
+            {
+                throw new NotSupportedException($"Bicepparam file {TemplateParameterFile} is only supported with a Bicep template file");
+            }
+
             if (BicepUtility.IsBicepFile(TemplateFile))
+            {
                 BuildAndUseBicepTemplate();
 
+                if (BicepUtility.IsBicepparamFile(TemplateParameterFile))
+                    BuildAndUseBicepParameters();
+            }
+               
             if (!this.IsParameterBound(c => c.SkipTemplateParameterPrompt))
             {
                 // Resolve the static parameter names for this cmdlet:
@@ -460,5 +470,10 @@ protected void BuildAndUseBicepTemplate()
         {
             TemplateFile = BicepUtility.BuildFile(this.ResolvePath(TemplateFile), this.WriteVerbose, this.WriteWarning);
         }
+
+        protected void BuildAndUseBicepParameters()
+        {
+            TemplateParameterFile = BicepUtility.BuildParamFile(this.ResolvePath(TemplateParameterFile), this.WriteVerbose, this.WriteWarning);
+        }
     }
 }

src/Resources/ResourceManager/Properties/Resources.Designer.cs

@@ -512,4 +512,10 @@ You can help us improve the accuracy of the result by opening an issue here: htt
   <data name="BuildBicepFileToJsonFailed" xml:space="preserve">
     <value>Build bicep file '{0}' to json failed.</value>
   </data>
+  <data name="InvalidBicepparamFilePath" xml:space="preserve">
+    <value>Invalid Bicepparam file path.</value>
+  </data>
+  <data name="BuildBicepparamFileToJsonFailed" xml:space="preserve">
+    <value>Build bicepparam file '{0}' to json failed.</value>
+  </data>
 </root>

src/Resources/ResourceManager/Properties/Resources.resx

@@ -32,11 +32,16 @@ internal static class BicepUtility
 
         private const string MinimalVersionRequirementForBicepPublishWithOptionalDocumentationUriParameter = "0.14.46";
 
+        private const string MinimalVersionRequirementForBicepparamFileBuild = "0.16.1";
+
         public delegate void OutputCallback(string msg);
 
         public static bool IsBicepFile(string templateFilePath) =>
             ".bicep".Equals(Path.GetExtension(templateFilePath), StringComparison.OrdinalIgnoreCase);
 
+        public static bool IsBicepparamFile(string parametersFilePath) =>
+            ".bicepparam".Equals(Path.GetExtension(parametersFilePath), StringComparison.OrdinalIgnoreCase);
+
         public static string BuildFile(string bicepTemplateFilePath, OutputCallback writeVerbose = null, OutputCallback writeWarning = null)
         {
             if (!FileUtilities.DataStore.FileExists(bicepTemplateFilePath))
@@ -58,6 +63,27 @@ public static string BuildFile(string bicepTemplateFilePath, OutputCallback writ
             return buildResultPath;
         }
 
+        public static string BuildParamFile(string bicepParamFilePath, OutputCallback writeVerbose = null, OutputCallback writeWarning = null)
+        {
+            if (!FileUtilities.DataStore.FileExists(bicepParamFilePath))
+            {
+                throw new AzPSArgumentException(Properties.Resources.InvalidBicepparamFilePath, "TemplateParameterFile");
+            }
+
+            string tempDirectory = Path.Combine(Path.GetTempPath(), Guid.NewGuid().ToString());
+            Directory.CreateDirectory(tempDirectory);
+
+            string buildResultPath = Path.Combine(tempDirectory, Path.GetFileName(bicepParamFilePath)).Replace(".bicepparam", ".json");
+            RunBicepCommand($"bicep build-params '{bicepParamFilePath}' --outfile '{buildResultPath}'", MinimalVersionRequirementForBicepparamFileBuild, writeVerbose, writeWarning);
+
+            if (!FileUtilities.DataStore.FileExists(buildResultPath))
+            {
+                throw new AzPSApplicationException(string.Format(Properties.Resources.BuildBicepparamFileToJsonFailed, bicepParamFilePath));
+            }
+
+            return buildResultPath;
+        }
+
         public static void PublishFile(string bicepFilePath, string target, string documentationUri = null, OutputCallback writeVerbose = null, OutputCallback writeWarning = null)
         {
             if (!FileUtilities.DataStore.FileExists(bicepFilePath))

src/Resources/ResourceManager/Utilities/BicepUtility.cs

@@ -29,6 +29,7 @@
     <None Update="Resources\*.json" CopyToOutputDirectory="PreserveNewest" />
     <None Update="*.json" CopyToOutputDirectory="PreserveNewest" />
     <None Update="*.bicep" CopyToOutputDirectory="PreserveNewest" />
+	<None Update="*.bicepparam" CopyToOutputDirectory="PreserveNewest" />
     <None Update="ScenarioTests\*.pfx" CopyToOutputDirectory="PreserveNewest" />
   </ItemGroup>
 

src/Resources/Resources.Test/Resources.Test.csproj

@@ -195,6 +195,13 @@ public void TestTestDeploymentFromBicepFile()
             TestRunner.RunTestScript("Test-TestDeploymentFromBicepFile");
         }
 
+        [Fact]
+        [Trait(Category.AcceptanceType, Category.LiveOnly)]
+        public void TestNewDeploymentFromBicepFileAndBicepparamFile()
+        {
+            TestRunner.RunTestScript("Test-NewDeploymentFromBicepFileAndBicepparamFile");
+        }
+
         //Please make sure to re-record this test if any changes are made to WhatIf, QueryString or ResourceGroupDeployments
         [Fact]
         [Trait(Category.AcceptanceType, Category.CheckIn)]

src/Resources/Resources.Test/ScenarioTests/DeploymentTests.cs

@@ -843,7 +843,7 @@ function Test-TestDeploymentFromBicepFile
         New-AzResourceGroup -Name $rgname -Location $location
 
         $list = Test-AzResourceGroupDeployment -ResourceGroupName $rgname -TemplateFile sampleDeploymentBicepFile.bicep
-
+        
         # Assert
         Assert-AreEqual 0 @($list).Count
     }
@@ -854,6 +854,39 @@ function Test-TestDeploymentFromBicepFile
     }
 }
 
+<#
+.SYNOPSIS
+Tests deployment via Bicep file.
+#>
+function Test-NewDeploymentFromBicepFileAndBicepparamFile
+{
+    # Setup
+    $rgname = Get-ResourceGroupName
+    $rname = Get-ResourceName
+    $rglocation = "West US 2"
+
+    try
+    {
+        # Test
+        New-AzResourceGroup -Name $rgname -Location $rglocation
+
+        $deployment = New-AzResourceGroupDeployment -Name $rname -ResourceGroupName $rgname -TemplateFile sampleDeploymentBicepFileWithoutParamValues.bicep -TemplateParameterFile sampleDeploymentBicepFileParams.bicepparam
+
+        # Assert
+        Assert-AreEqual Succeeded $deployment.ProvisioningState
+
+        $subId = (Get-AzContext).Subscription.SubscriptionId
+        $deploymentId = "/subscriptions/$subId/resourcegroups/$rgname/providers/Microsoft.Resources/deployments/$rname"
+        $getById = Get-AzResourceGroupDeployment -Id $deploymentId
+        Assert-AreEqual $getById.DeploymentName $deployment.DeploymentName
+    }
+    finally
+    {
+        # Cleanup
+        Clean-ResourceGroup $rgname
+    }
+}
+
 <#
 .SYNOPSIS
 is running live in target environment