TIP
💡 Learn more : An introduction to Azure Automation (opens new window).
📺 Watch the video : How to use Azure Automation with PowerShell (opens new window).
# Defining Parameters to be used with ARM Templates
# Intro
You’ve already seen that you can automate deploying static configuration information like app settings with your ARM template. But what about providing parameters that allows end-users to input values BEFORE deployment. That is what we'll learn today!
# Getting Started
Go ahead and search for Templates inside the Azure Portal and click Add to create a new one.
Enter a name and a description on the ARM Template.
# Fill-in-the-blank settings
We want to have dynamic settings that are customizable every time you deploy your web app instead of having them be the same each time, you just need to add the parameter values for what you want to your ARM template.
Below is a sample of three values (FirstNameValue, LastNameValue and SSNValue) that we previously hard-coded before:
"FirstNameValue": {
"type": "string"
},
"LastNameValue": {
"type": "string"
},
"SSNValue": {
"type": "string"
},
2
3
4
5
6
7
8
9
10
We'll add the same parameters called FirstNameValue, LastNameValue and SSNValue to the parameters collection of the template. From now on, every time you deploy this template, you will be prompted to enter a value for each one.
"siteConfig": {
"appSettings": [
{
"name": "MyFirstName",
"value": "[parameters('FirstNameValue')]"
},
{
"name": "MyLastName",
"value": "[parameters('LastNameValue')]"
},
{
"name": "MySSN",
"value": "[parameters('SSNValue')]"
}
]
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# Putting it all together
Our full template file looks like the following:
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"appServiceName": {
"type": "string",
"minLength": 1,
"maxLength": 10
},
"appServicePlanName": {
"type": "string",
"minLength": 1
},
"FirstNameValue": {
"type": "string"
},
"LastNameValue": {
"type": "string"
},
"SSNValue": {
"type": "string"
},
"appServicePlanSkuName": {
"type": "string",
"defaultValue": "S1",
"allowedValues": [
"F1",
"D1",
"B1",
"B2",
"B3",
"S1",
"S2",
"S3",
"P1",
"P2",
"P3",
"P4"
],
"metadata": {
"description": "Describes plan's pricing tier and capacity. Check details at https://azure.microsoft.com/pricing/details/app-service/"
}
}
},
"variables": {
"appHostingPlanNameVar": "[concat(parameters('appServicePlanName'),'-apps')]"
},
"resources": [
{
"name": "[variables('appHostingPlanNameVar')]",
"type": "Microsoft.Web/serverfarms",
"location": "[resourceGroup().location]",
"apiVersion": "2015-08-01",
"sku": {
"name": "[parameters('appServicePlanSkuName')]"
},
"dependsOn": [],
"tags": {
"displayName": "appServicePlan"
},
"properties": {
"name": "[variables('appHostingPlanNameVar')]",
"numberOfWorkers": 1
}
},
{
"name": "[parameters('appServiceName')]",
"type": "Microsoft.Web/sites",
"location": "[resourceGroup().location]",
"apiVersion": "2015-08-01",
"dependsOn": [
"[resourceId('Microsoft.Web/serverfarms', variables('appHostingPlanNameVar'))]"
],
"tags": {
"[concat('hidden-related:', resourceId('Microsoft.Web/serverfarms', variables('appHostingPlanNameVar')))]": "Resource",
"displayName": "webApp"
},
"properties": {
"name": "[parameters('appServiceName')]",
"serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('appHostingPlanNameVar'))]",
"siteConfig": {
"appSettings": [
{
"name": "MyFirstName",
"value": "[parameters('FirstNameValue')]"
},
{
"name": "MyLastName",
"value": "[parameters('LastNameValue')]"
},
{
"name": "MySSN",
"value": "[parameters('SSNValue')]"
}
]
}
}
}
],
"outputs": {}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
If you save the template, then the next time you deploy resources using this ARM template, you will be required to put in a new value for the First Name, Last Name, and SSN that will be used in your application settings.
And after deployment, go and check your App Settings.
I hope this three part series helped!