You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/azure-resource-manager/managed-applications/deploy-service-catalog-quickstart.md
+34-21Lines changed: 34 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,15 @@
1
1
---
2
-
title: Use Azure portal to deploy service catalog managed application
3
-
description: Shows consumers of Azure Managed Applications how to deploy a service catalog managed application from the Azure portal.
2
+
title: Deploy a service catalog managed application
3
+
description: Shows consumers of Azure Managed Applications how to deploy a service catalog managed application.
4
4
author: davidsmatlak
5
5
ms.author: davidsmatlak
6
6
ms.topic: quickstart
7
7
ms.date: 02/21/2023
8
8
---
9
9
10
-
# Quickstart: Deploy service catalog managed application from Azure portal
10
+
# Quickstart: Deploy service catalog managed application
11
11
12
-
In the quickstart article to [publish the definition](publish-service-catalog-app.md), you published an Azure managed application definition. In this quickstart, you use that definition 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. In this article, the managed application definition deploys a managed storage account.
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.
13
13
14
14
## Prerequisites
15
15
@@ -22,38 +22,47 @@ In the Azure portal, use the following steps:
22
22
1. Sign in to the [Azure portal](https://portal.azure.com).
23
23
1. Select **Create a resource**.
24
24
25
-
:::image type="content" source="./media/deploy-service-catalog-quickstart/create-resource.png" alt-text="Create a resource":::
25
+
:::image type="content" source="./media/deploy-service-catalog-quickstart/create-resource.png" alt-text="Screenshot of Azure home page with Create a resource highlighted.":::
26
26
27
27
1. Search for _Service Catalog Managed Application_ and select it from the available options.
28
28
29
29
1.**Service Catalog Managed Application** is displayed. Select **Create**.
:::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.":::
32
32
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 **Managed Storage Account** definition that you created in the preceding quickstart. Select **Create**.
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**.
34
34
35
-
:::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 select and deploy.":::
35
+
:::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.":::
36
36
37
-
1. Provide values for the **Basics** tab and select **Next: Storage settings**.
37
+
1. Provide values for the **Basics** tab and select **Next: Web App settings**.
38
38
39
-
:::image type="content" source="./media/deploy-service-catalog-quickstart/basics-info.png" alt-text="Screenshot that highlights the information needed on the basics tab.":::
39
+
:::image type="content" source="./media/deploy-service-catalog-quickstart/basics-info.png" alt-text="Screenshot that highlights the required information on the basics tab.":::
40
40
41
41
-**Subscription**: Select the subscription where you want to deploy the managed application.
42
42
-**Resource group**: Select the resource group. For this example, create a resource group named _applicationGroup_.
43
43
-**Region**: Select the location where you want to deploy the resource.
44
44
-**Application Name**: Enter a name for your application. For this example, use _demoManagedApplication_.
45
-
-**Managed Resource Group**: Uses a default name in the format `mrg-{definitionName}-{dateTime}` like the example _mrg-ManagedStorage-20220817085240_. You can change the name.
45
+
-**Application resources Resource group name**: The name of the managed resource group that contains the resources that are deployed for the managed application. The default name is in the format `rg-{definitionName}-{dateTime}` but you can change the name.
46
+
47
+
1. Provide values for the **Web App settings** tab and select **Next: Storage settings**.
48
+
49
+
:::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.":::
50
+
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_.
46
55
47
56
1. Enter a prefix for the storage account name and select the storage account type. Select **Next: Review + create**.
48
57
49
-
:::image type="content" source="./media/deploy-service-catalog-quickstart/storage-info.png" alt-text="Screenshot that shows the information needed to create a storage account.":::
58
+
:::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.":::
50
59
51
-
-**Storage account name prefix**: Use only lowercase letters and numbers and a maximum of 11 characters. During deployment, the prefix is concatenated with a unique string to create the storage account name.
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.
52
61
-**Storage account type**: Select **Change type** to choose a storage account type. The default is Standard LRS.
53
62
54
-
1. Review the summary of the values you selected and verify **Validation Passed** is displayed. Select **Create** to begin the deployment.
63
+
1. Review the summary of the values you selected and verify **Validation Passed** is displayed. Select **Create** to deploy the managed application.
55
64
56
-
:::image type="content" source="./media/deploy-service-catalog-quickstart/summary-validation.png" alt-text="Screenshot that summarizes the values you selected and shows the validation status.":::
65
+
:::image type="content" source="./media/deploy-service-catalog-quickstart/summary-validation.png" alt-text="Screenshot that summarizes the values you selected and shows the status of validation passed.":::
57
66
58
67
## View results
59
68
@@ -65,17 +74,21 @@ Go to the resource group named **applicationGroup**. The resource group contains
65
74
66
75
:::image type="content" source="./media/deploy-service-catalog-quickstart/view-application-group.png" alt-text="Screenshot that shows the resource group that contains the managed application.":::
67
76
77
+
Select the managed application's name to get more information like a link to the managed resource group.
78
+
79
+
:::image type="content" source="./media/deploy-service-catalog-quickstart/view-managed-application.png" alt-text="Screenshot that shows the managed application's details and highlights the link to the managed resource group.":::
80
+
68
81
### Managed resource
69
82
70
-
Go to the managed resource group with the name prefix **mrg-ManagedStorage** to see the resource that was deployed. The resource group contains the managed storage account that uses the prefix you specified. In this example, the storage account prefix is _demoappstg_.
83
+
Go to the managed resource group with the name prefix **rg-sampleManagedApplication** to display the resources that were deployed. The resource group contains an App Service plan, App Service, and storage account.
71
84
72
-
:::image type="content" source="./media/deploy-service-catalog-quickstart/view-managed-resource-group.png" alt-text="Screenshot that shows the managed resource group that contains the resource deployed by the managed application.":::
85
+
:::image type="content" source="./media/deploy-service-catalog-quickstart/view-managed-resource-group.png" alt-text="Screenshot that shows the managed resource group that contains the resources deployed by the managed application definition.":::
73
86
74
-
The storage account that's created by the managed application has a role assignment. In the [publish the definition](publish-service-catalog-app.md#get-group-id-and-role-definition-id) article, you created an Azure Active Directory group. That group was used in the managed application definition. When you deployed the managed application, a role assignment for that group was added to the managed storage account.
87
+
The managed resource group and each resource that's created by the managed application has a role assignment. In the [publish the definition](publish-service-catalog-app.md#get-group-id-and-role-definition-id) article, you created an Azure Active Directory group. That group was used in the managed application definition. When you deployed the managed application, a role assignment for that group was added to the managed resources.
75
88
76
89
To see the role assignment from the Azure portal:
77
90
78
-
1. Go to the**mrg-ManagedStorage** resource group.
91
+
1. Go to your**rg-sampleManagedApplication** resource group.
79
92
1. Select **Access Control (IAM)** > **Role assignments**.
80
93
81
94
You can also view the resource's **Deny assignments**.
@@ -84,14 +97,14 @@ The role assignment gives the application's publisher access to manage the stora
84
97
85
98
## Clean up resources
86
99
87
-
When your finished with the managed application, you can delete the resource groups and that will remove all the resources you created. For example, in this quickstart you created the resource groups _applicationGroup_ and a managed resource group with the prefix _mrg-ManagedStorage_.
100
+
When your finished with the managed application, you can delete the resource groups and that removes all the resources you created. For example, in this quickstart you created the resource groups _applicationGroup_ and a managed resource group with the prefix _rg-sampleManagedApplication_.
88
101
89
102
1. From Azure portal **Home**, in the search field, enter _resource groups_.
90
103
1. Select **Resource groups**.
91
104
1. Select **applicationGroup** and **Delete resource group**.
92
105
1. To confirm the deletion, enter the resource group name and select **Delete**.
93
106
94
-
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 _mrg-ManagedStorage_ resource group is also deleted.
107
+
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.
95
108
96
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).
0 commit comments