Azure RM Templates. How to upload assets automatically with VS instead of fetching them from GitHub

Question

I would like to be able to deploy a complex ARM template that utilizes DSC extensions and nested templates from my local Visual Studio. The example is set to download assets from GitHub: https://github.com/Azure/azure-quickstart-templates/tree/master/active-directory-new-domain-ha-2-dc What changes do I have to make that I can tie the assets to my local Visual Studio project and use them instead of downloading them from GitHub? Here is the strip down version of the template responsible for downloading:

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    ...
    "adPDCVMName": {
      "type": "string",
      "metadata": {
        "description": "The computer name of the PDC"
      },
      "defaultValue": "adPDC"
    },
    "assetLocation": {
      "type": "string",
      "metadata": {
        "description": "The location of resources such as templates and DSC modules that the script is dependent"
      },
      "defaultValue": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/active-directory-new-domain-ha-2-dc"
    }
    ...
  },
  "variables": {
    ...
    "adPDCModulesURL": "[concat(parameters('assetLocation'),'/DSC/CreateADPDC.ps1.zip')]",
    "adPDCConfigurationFunction": "CreateADPDC.ps1\\CreateADPDC",
    ...
  },
  "resources": [
    ...
    {
      "name": "[parameters('adPDCVMName')]",
      "type": "Microsoft.Compute/virtualMachines",
      ...
      "resources": [
        {
          "name": "[concat(parameters('adPDCVMName'),'/CreateADForest')]",
          "type": "Microsoft.Compute/virtualMachines/extensions",
          ...
          "properties": {
          ...
            "settings": {
              "ModulesUrl": "[variables('adPDCModulesURL')]",
              "ConfigurationFunction": "[variables('adPDCConfigurationFunction')]",
              ...
                }
              }
            }
          }
        }
      ]
    }
  ]
}

Pascal Naber · Accepted Answer · 2017-02-05T17:15:05.253

Do the following in your 'Azure Resource Group' project in Visual Studio:

Copy the files to your project in Visual Studio using the same directory structure. So a DSC directory and a nestedtemplates directory with the files that belong there.
Set the files in the directories as content (azuredeploy.json is not needed, only the files you are referring to). This way the powershell script to deploy the templates will upload it to a storage account in azure.
Make it possible to use files uploaded to the storage account. In this case the template that you are referring to is not using the common namingconvention. So you need to change it a bit:

Change azuredeploy.json: Change the name of parameter assetLocation to _artifactsLocation.

Second: Add a parameter _artifactsLocationSasToken as securestring. These 2 parameters will be filled automatically by the powershell script in Visual Studio.

part of the azuredeploy.json:

"parameters": {
    "_artifactsLocation": {
      "type": "string",
      "metadata": {
        "description": "The base URI where artifacts required by this template are located. When the template is deployed using the accompanying scripts, a private location in the subscription will be used and this value will be automatically generated."
      }
    },
    "_artifactsLocationSasToken": {
      "type": "securestring",
      "metadata": {
        "description": "The SAS token to access the storage account"
      }
    },

Because the original azuredeploy.json is not using the _artifactsLocationSasToken parameter. You need to change all variables where the assetlocation is used. Change all variables so it uses the _artifactsLocation and add a part to use the _artifactsLocationSasToken.

one sample:

"vnetTemplateUri": "[concat(parameters('_artifactsLocation'),'/nestedtemplates/vnet.json', parameters('_artifactsLocationSasToken'))]",

After you changed all variables. You can deploy the template from Visual Studio using the resources in your project instead of from github.

Thank you, Mr. Naber! This is an amazing answer! Could you please elaborate on step 2? How do I "set the files in the directories as content"? — WinBoss, Feb 05 '17 at 18:07
Select the properties of the file. Set the Build Action on Content. — Pascal Naber, Feb 05 '17 at 18:23
Take a look at this github sample: https://github.com/Azure/azure-quickstart-templates/tree/master/active-directory-new-domain - it uses the pattern Pascal describes while using github for a default location. — bmoore-msft, Feb 06 '17 at 20:36

Azure RM Templates. How to upload assets automatically with VS instead of fetching them from GitHub

1 Answers1