Skip to content

Commit 7d0a7b1

Browse files
committed
updates deploy doc and screenshots
1 parent 231b914 commit 7d0a7b1

15 files changed

+57
-42
lines changed

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

Lines changed: 34 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
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.
44
author: davidsmatlak
55
ms.author: davidsmatlak
66
ms.topic: quickstart
77
ms.date: 02/21/2023
88
---
99

10-
# Quickstart: Deploy service catalog managed application from Azure portal
10+
# Quickstart: Deploy service catalog managed application
1111

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.
1313

1414
## Prerequisites
1515

@@ -22,38 +22,47 @@ In the Azure portal, use the following steps:
2222
1. Sign in to the [Azure portal](https://portal.azure.com).
2323
1. Select **Create a resource**.
2424

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.":::
2626

2727
1. Search for _Service Catalog Managed Application_ and select it from the available options.
2828

2929
1. **Service Catalog Managed Application** is displayed. Select **Create**.
3030

31-
:::image type="content" source="./media/deploy-service-catalog-quickstart/create-service-catalog-managed-application.png" alt-text="Select create":::
31+
:::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 **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**.
3434

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.":::
3636

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**.
3838

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.":::
4040

4141
- **Subscription**: Select the subscription where you want to deploy the managed application.
4242
- **Resource group**: Select the resource group. For this example, create a resource group named _applicationGroup_.
4343
- **Region**: Select the location where you want to deploy the resource.
4444
- **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_.
4655

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

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.":::
5059

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.
5261
- **Storage account type**: Select **Change type** to choose a storage account type. The default is Standard LRS.
5362

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.
5564

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.":::
5766

5867
## View results
5968

@@ -65,17 +74,21 @@ Go to the resource group named **applicationGroup**. The resource group contains
6574

6675
:::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.":::
6776

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+
6881
### Managed resource
6982

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.
7184

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.":::
7386

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.
7588

7689
To see the role assignment from the Azure portal:
7790

78-
1. Go to the **mrg-ManagedStorage** resource group.
91+
1. Go to your **rg-sampleManagedApplication** resource group.
7992
1. Select **Access Control (IAM)** > **Role assignments**.
8093

8194
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
8497

8598
## Clean up resources
8699

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_.
88101

89102
1. From Azure portal **Home**, in the search field, enter _resource groups_.
90103
1. Select **Resource groups**.
91104
1. Select **applicationGroup** and **Delete resource group**.
92105
1. To confirm the deletion, enter the resource group name and select **Delete**.
93106

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.
95108

96109
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).
97110

15 KB
Loading
1.76 KB
Loading
Loading
Loading
21.9 KB
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)