Skip to content

Commit f685368

Browse files
davidsmatlakdavidsmatlak
committed
updates templates and content
1 parent 7d0a7b1 commit f685368

File tree

4 files changed

+52
-52
lines changed

4 files changed

+52
-52
lines changed

‎articles/azure-resource-manager/managed-applications/deploy-service-catalog-quickstart.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,12 @@ description: Shows consumers of Azure Managed Applications how to deploy a servi
44
author: davidsmatlak
55
ms.author: davidsmatlak
66
ms.topic: quickstart
7-
ms.date: 02/21/2023
7+
ms.date: 03/01/2023
88
---
99

1010
# Quickstart: Deploy service catalog managed application
1111

12-
In this quickstart, you use the definition you created in [publish the definition](publish-service-catalog-app.md) or [publish the definition with bring your own storage](publish-service-catalog-bring-your-own-storage.md) to deploy a service catalog managed application. The deployment creates two resource groups. One resource group contains the managed application and the other is a managed resource group for the deployed resource. The managed application definition deploys an App Service plan, App Service, and storage account.
12+
In this quickstart, you use the definition you created in the quickstarts to [publish an application definition](publish-service-catalog-app.md) or [publish a definition with bring your own storage](publish-service-catalog-bring-your-own-storage.md) to deploy a service catalog managed application. The deployment creates two resource groups. One resource group contains the managed application and the other is a managed resource group for the deployed resource. The managed application definition deploys an App Service plan, App Service, and storage account.
1313

1414
## Prerequisites
1515

@@ -30,7 +30,9 @@ In the Azure portal, use the following steps:
3030

3131
:::image type="content" source="./media/deploy-service-catalog-quickstart/create-service-catalog-managed-application.png" alt-text="Screenshot of search result for Service Catalog Managed Application with create button highlighted.":::
3232

33-
1. The portal shows the managed application definitions that you can access. From the available definitions, select the one you want to deploy. In this quickstart, use the **Sample managed application** definition that you created in the preceding quickstart. Select **Create**.
33+
1. Select **Sample managed application** and then select **Create**.
34+
35+
The portal displays the managed application definitions that you created with the quickstart articles to publish an application definition.
3436

3537
:::image type="content" source="./media/deploy-service-catalog-quickstart/select-service-catalog-managed-application.png" alt-text="Screenshot that shows managed application definitions that you can deploy.":::
3638

@@ -48,16 +50,14 @@ In the Azure portal, use the following steps:
4850

4951
:::image type="content" source="./media/deploy-service-catalog-quickstart/web-app-settings.png" alt-text="Screenshot that highlights the required information on the Web App settings tab.":::
5052

51-
During deployment, the prefixes are concatenated with a unique string to create a name that's globally unique across Azure.
52-
53-
- **App Service plan name prefix**: Create a prefix for the plan name. Maximum of 27 alphanumeric characters or hyphens. For example, _demoAppServicePlan_.
54-
- **App Service name prefix**: Create a prefix for the plan name. Maximum of 47 alphanumeric characters or hyphens. For example, _demoApp_.
53+
- **App Service plan name**: Create a plan name. Maximum of 40 alphanumeric characters and hyphens. For example, _demoAppServicePlan_. App Service plan names must be unique within a resource group in your subscription.
54+
- **App Service name prefix**: Create a prefix for the plan name. Maximum of 47 alphanumeric characters or hyphens. For example, _demoApp_. During deployment, the prefix is concatenated with a unique string to create a name that's globally unique across Azure.
5555

5656
1. Enter a prefix for the storage account name and select the storage account type. Select **Next: Review + create**.
5757

5858
:::image type="content" source="./media/deploy-service-catalog-quickstart/storage-settings.png" alt-text="Screenshot that shows the information needed to create a storage account.":::
5959

60-
- **Storage account name prefix**: Use only lowercase letters and numbers and a maximum of 11 characters. For example, _demostg1234_. During deployment, the prefix is concatenated with a unique string to create a name that's globally unique across Azure. Although you're creating a prefix, the control checks for existing names in Azure and might post a validation message that the name already exists. If so, choose a different prefix.
60+
- **Storage account name prefix**: Use only lowercase letters and numbers and a maximum of 11 characters. For example, _demostg1234_. During deployment, the prefix is concatenated with a unique string to create a name globally unique across Azure. Although you're creating a prefix, the control checks for existing names in Azure and might post a validation message that the name already exists. If so, choose a different prefix.
6161
- **Storage account type**: Select **Change type** to choose a storage account type. The default is Standard LRS.
6262

6363
1. Review the summary of the values you selected and verify **Validation Passed** is displayed. Select **Create** to deploy the managed application.
@@ -106,10 +106,12 @@ When your finished with the managed application, you can delete the resource gro
106106

107107
When the resource group that contains the managed application is deleted, the managed resource group is also deleted. In this example, when _applicationGroup_ is deleted the _rg-sampleManagedApplication_ resource group is also deleted.
108108

109-
If you want to delete the managed application definition, you can delete the resource groups you created in the quickstart to [publish the definition](publish-service-catalog-app.md).
109+
If you want to delete the managed application definition, delete the resource groups you created in the quickstart articles.
110+
111+
- **Publish application definition**: _packageStorageGroup_ and _appDefinitionGroup_.
112+
- **Publish definition with bring your own storage**: _packageStorageGroup_, _byosDefinitionStorageGroup_, and _byosAppDefinitionGroup_.
110113

111114
## Next steps
112115

113-
- To learn how to create the definition files for a managed application, see [Quickstart: Create and publish an Azure Managed Application definition](publish-service-catalog-app.md).
114-
- For Azure CLI, see [Deploy managed application with Azure CLI](./scripts/managed-application-cli-sample-create-application.md).
115-
- For PowerShell, see [Deploy managed application with PowerShell](./scripts/managed-application-poweshell-sample-create-application.md).
116+
- To learn how to create the definition files for a managed application, go to [Quickstart: Create and publish an Azure Managed Application definition](publish-service-catalog-app.md).
117+
- To create the definition files for a managed application using your own storage, go to [Quickstart: Bring your own storage to publish an Azure Managed Application definition](publish-service-catalog-bring-your-own-storage.md).

‎articles/azure-resource-manager/managed-applications/publish-service-catalog-app.md

Lines changed: 18 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: davidsmatlak
55
ms.author: davidsmatlak
66
ms.topic: quickstart
77
ms.custom: subject-armqs, devx-track-azurecli, devx-track-azurepowershell, subject-rbac-steps, mode-api, mode-arm
8-
ms.date: 02/21/2023
8+
ms.date: 03/01/2023
99
---
1010

1111
# Quickstart: Create and publish an Azure Managed Application definition
@@ -51,11 +51,11 @@ Add the following JSON and save the file. It defines the resources to deploy an
5151
"type": "string",
5252
"defaultValue": "[resourceGroup().location]"
5353
},
54-
"appServicePlanNamePrefix": {
54+
"appServicePlanName": {
5555
"type": "string",
56-
"maxLength": 27,
56+
"maxLength": 40,
5757
"metadata": {
58-
"description": "App Service plan name prefix."
58+
"description": "App Service plan name."
5959
}
6060
},
6161
"appServiceNamePrefix": {
@@ -85,7 +85,6 @@ Add the following JSON and save the file. It defines the resources to deploy an
8585
}
8686
},
8787
"variables": {
88-
"appServicePlanName": "[format('{0}{1}', parameters('appServicePlanNamePrefix'), uniqueString(resourceGroup().id))]",
8988
"appServicePlanSku": "F1",
9089
"appServicePlanCapacity": 1,
9190
"appServiceName": "[format('{0}{1}', parameters('appServiceNamePrefix'), uniqueString(resourceGroup().id))]",
@@ -95,7 +94,7 @@ Add the following JSON and save the file. It defines the resources to deploy an
9594
{
9695
"type": "Microsoft.Web/serverfarms",
9796
"apiVersion": "2022-03-01",
98-
"name": "[variables('appServicePlanName')]",
97+
"name": "[parameters('appServicePlanName')]",
9998
"location": "[parameters('location')]",
10099
"sku": {
101100
"name": "[variables('appServicePlanSku')]",
@@ -108,7 +107,7 @@ Add the following JSON and save the file. It defines the resources to deploy an
108107
"name": "[variables('appServiceName')]",
109108
"location": "[parameters('location')]",
110109
"properties": {
111-
"serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanName'))]",
110+
"serverFarmId": "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]",
112111
"httpsOnly": true,
113112
"siteConfig": {
114113
"appSettings": [
@@ -120,7 +119,7 @@ Add the following JSON and save the file. It defines the resources to deploy an
120119
}
121120
},
122121
"dependsOn": [
123-
"[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanName'))]",
122+
"[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]",
124123
"[resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))]"
125124
]
126125
},
@@ -141,7 +140,7 @@ Add the following JSON and save the file. It defines the resources to deploy an
141140
"outputs": {
142141
"appServicePlan": {
143142
"type": "string",
144-
"value": "[variables('appServicePlanName')]"
143+
"value": "[parameters('appServicePlanName')]"
145144
},
146145
"appServiceApp": {
147146
"type": "string",
@@ -184,14 +183,14 @@ Add the following JSON to the file and save it.
184183
{
185184
"name": "appServicePlanName",
186185
"type": "Microsoft.Common.TextBox",
187-
"label": "App Service plan name prefix",
188-
"placeholder": "App Service plan name prefix",
186+
"label": "App Service plan name",
187+
"placeholder": "App Service plan name",
189188
"defaultValue": "",
190-
"toolTip": "Use alphanumeric characters or hyphens with a maximum of 27 characters.",
189+
"toolTip": "Use alphanumeric characters or hyphens with a maximum of 40 characters.",
191190
"constraints": {
192191
"required": true,
193-
"regex": "^[a-z0-9A-Z-]{1,27}$",
194-
"validationMessage": "Only alphanumeric characters or hyphens are allowed, with a maximum of 27 characters."
192+
"regex": "^[a-z0-9A-Z-]{1,40}$",
193+
"validationMessage": "Only alphanumeric characters or hyphens are allowed, with a maximum of 40 characters."
195194
},
196195
"visible": true
197196
},
@@ -201,11 +200,11 @@ Add the following JSON to the file and save it.
201200
"label": "App Service name prefix",
202201
"placeholder": "App Service name prefix",
203202
"defaultValue": "",
204-
"toolTip": "Use alphanumeric characters or hyphens with a maximum of 47 characters.",
203+
"toolTip": "Use alphanumeric characters or hyphens with minimum of 2 characters and maximum of 47 characters.",
205204
"constraints": {
206205
"required": true,
207-
"regex": "^[a-z0-9A-Z-]{1,47}$",
208-
"validationMessage": "Only alphanumeric characters or hyphens are allowed, with a maximum of 47 characters."
206+
"regex": "^[a-z0-9A-Z-]{2,47}$",
207+
"validationMessage": "Only alphanumeric characters or hyphens are allowed, with a minimum of 2 characters and maximum of 47 characters."
209208
},
210209
"visible": true
211210
}
@@ -247,7 +246,7 @@ Add the following JSON to the file and save it.
247246
],
248247
"outputs": {
249248
"location": "[location()]",
250-
"appServicePlanNamePrefix": "[steps('webAppSettings').appServicePlanName]",
249+
"appServicePlanName": "[steps('webAppSettings').appServicePlanName]",
251250
"appServiceNamePrefix": "[steps('webAppSettings').appServiceName]",
252251
"storageAccountNamePrefix": "[steps('storageConfig').storageAccounts.prefix]",
253252
"storageAccountType": "[steps('storageConfig').storageAccounts.type]"
@@ -449,4 +448,4 @@ You have access to the managed application definition, but you want to make sure
449448
You've published the managed application definition. Now, learn how to deploy an instance of that definition.
450449

451450
> [!div class="nextstepaction"]
452-
> [Quickstart: Deploy service catalog app](deploy-service-catalog-quickstart.md)
451+
> [Quickstart: Deploy service catalog managed application](deploy-service-catalog-quickstart.md)

‎articles/azure-resource-manager/managed-applications/publish-service-catalog-bring-your-own-storage.md

Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@ author: davidsmatlak
55
ms.author: davidsmatlak
66
ms.topic: quickstart
77
ms.custom: subject-armqs, devx-track-azurecli, devx-track-azurepowershell, subject-rbac-steps, mode-api, mode-arm
8-
ms.date: 02/21/2023
8+
ms.date: 03/01/2023
99
---
1010

1111
# Quickstart: Bring your own storage to publish an Azure Managed Application definition
1212

13-
This quickstart provides an introduction to bring your own storage for an [Azure Managed Application](overview.md). You create and publish a managed application definition in your service catalog for members of your organization. When you use your own storage account, your managed application definition can exceed the service catalog's 120-MB limit.
13+
This quickstart provides an introduction to bring your own storage (BYOS) for an [Azure Managed Application](overview.md). You create and publish a managed application definition in your service catalog for members of your organization. When you use your own storage account, your managed application definition can exceed the service catalog's 120-MB limit.
1414

1515
To publish a managed application definition to your service catalog, do the following tasks:
1616

@@ -52,11 +52,11 @@ Add the following JSON and save the file. It defines the managed application's r
5252
"type": "string",
5353
"defaultValue": "[resourceGroup().location]"
5454
},
55-
"appServicePlanNamePrefix": {
55+
"appServicePlanName": {
5656
"type": "string",
57-
"maxLength": 27,
57+
"maxLength": 40,
5858
"metadata": {
59-
"description": "App Service plan name prefix."
59+
"description": "App Service plan name."
6060
}
6161
},
6262
"appServiceNamePrefix": {
@@ -86,7 +86,6 @@ Add the following JSON and save the file. It defines the managed application's r
8686
}
8787
},
8888
"variables": {
89-
"appServicePlanName": "[format('{0}{1}', parameters('appServicePlanNamePrefix'), uniqueString(resourceGroup().id))]",
9089
"appServicePlanSku": "F1",
9190
"appServicePlanCapacity": 1,
9291
"appServiceName": "[format('{0}{1}', parameters('appServiceNamePrefix'), uniqueString(resourceGroup().id))]",
@@ -96,7 +95,7 @@ Add the following JSON and save the file. It defines the managed application's r
9695
{
9796
"type": "Microsoft.Web/serverfarms",
9897
"apiVersion": "2022-03-01",
99-
"name": "[variables('appServicePlanName')]",
98+
"name": "[parameters('appServicePlanName')]",
10099
"location": "[parameters('location')]",
101100
"sku": {
102101
"name": "[variables('appServicePlanSku')]",
@@ -109,7 +108,7 @@ Add the following JSON and save the file. It defines the managed application's r
109108
"name": "[variables('appServiceName')]",
110109
"location": "[parameters('location')]",
111110
"properties": {
112-
"serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanName'))]",
111+
"serverFarmId": "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]",
113112
"httpsOnly": true,
114113
"siteConfig": {
115114
"appSettings": [
@@ -121,7 +120,7 @@ Add the following JSON and save the file. It defines the managed application's r
121120
}
122121
},
123122
"dependsOn": [
124-
"[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanName'))]",
123+
"[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]",
125124
"[resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))]"
126125
]
127126
},
@@ -142,7 +141,7 @@ Add the following JSON and save the file. It defines the managed application's r
142141
"outputs": {
143142
"appServicePlan": {
144143
"type": "string",
145-
"value": "[variables('appServicePlanName')]"
144+
"value": "[parameters('appServicePlanName')]"
146145
},
147146
"appServiceApp": {
148147
"type": "string",
@@ -185,14 +184,14 @@ Add the following JSON to the file and save it.
185184
{
186185
"name": "appServicePlanName",
187186
"type": "Microsoft.Common.TextBox",
188-
"label": "App Service plan name prefix",
189-
"placeholder": "App Service plan name prefix",
187+
"label": "App Service plan name",
188+
"placeholder": "App Service plan name",
190189
"defaultValue": "",
191-
"toolTip": "Use alphanumeric characters or hyphens with a maximum of 27 characters.",
190+
"toolTip": "Use alphanumeric characters or hyphens with a maximum of 40 characters.",
192191
"constraints": {
193192
"required": true,
194-
"regex": "^[a-z0-9A-Z-]{1,27}$",
195-
"validationMessage": "Only alphanumeric characters or hyphens are allowed, with a maximum of 27 characters."
193+
"regex": "^[a-z0-9A-Z-]{1,40}$",
194+
"validationMessage": "Only alphanumeric characters or hyphens are allowed, with a maximum of 40 characters."
196195
},
197196
"visible": true
198197
},
@@ -202,11 +201,11 @@ Add the following JSON to the file and save it.
202201
"label": "App Service name prefix",
203202
"placeholder": "App Service name prefix",
204203
"defaultValue": "",
205-
"toolTip": "Use alphanumeric characters or hyphens with a maximum of 47 characters.",
204+
"toolTip": "Use alphanumeric characters or hyphens with minimum of 2 characters and maximum of 47 characters.",
206205
"constraints": {
207206
"required": true,
208-
"regex": "^[a-z0-9A-Z-]{1,47}$",
209-
"validationMessage": "Only alphanumeric characters or hyphens are allowed, with a maximum of 47 characters."
207+
"regex": "^[a-z0-9A-Z-]{2,47}$",
208+
"validationMessage": "Only alphanumeric characters or hyphens are allowed, with a minimum of 2 characters and maximum of 47 characters."
210209
},
211210
"visible": true
212211
}
@@ -248,7 +247,7 @@ Add the following JSON to the file and save it.
248247
],
249248
"outputs": {
250249
"location": "[location()]",
251-
"appServicePlanNamePrefix": "[steps('webAppSettings').appServicePlanName]",
250+
"appServicePlanName": "[steps('webAppSettings').appServicePlanName]",
252251
"appServiceNamePrefix": "[steps('webAppSettings').appServiceName]",
253252
"storageAccountNamePrefix": "[steps('storageConfig').storageAccounts.prefix]",
254253
"storageAccountType": "[steps('storageConfig').storageAccounts.type]"
@@ -633,4 +632,4 @@ You have access to the managed application definition, but you want to make sure
633632
You've published the managed application definition. Now, learn how to deploy an instance of that definition.
634633

635634
> [!div class="nextstepaction"]
636-
> [Quickstart: Deploy service catalog app](deploy-service-catalog-quickstart.md)
635+
> [Quickstart: Deploy service catalog managed application](deploy-service-catalog-quickstart.md)

‎articles/azure-resource-manager/managed-applications/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
items:
1010
- name: Publish application definition
1111
href: publish-service-catalog-app.md
12-
- name: Publish application definition with bring your own storage
12+
- name: Publish definition with bring your own storage
1313
href: publish-service-catalog-bring-your-own-storage.md
1414
- name: Deploy service catalog app
1515
href: deploy-service-catalog-quickstart.md

0 commit comments

Comments
 (0)