Skip to content

Commit 1bc5623

Browse files
JamesJBarnettJamesJBarnett
authored
Merge pull request #203664 from schaffererin/purview-bicep-quickstart
Creating new Bicep quickstart article - Microsoft Purview
2 parents cfb0a85 + 3765f03 commit 1bc5623

File tree

3 files changed

+122
-0
lines changed

3 files changed

+122
-0
lines changed

‎articles/azure-resource-manager/bicep/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -134,6 +134,8 @@
134134
items:
135135
- name: Cost Management + Billing
136136
href: ../../cost-management-billing/costs/quick-create-budget-bicep.md?toc=/azure/azure-resource-manager/bicep/toc.json
137+
- name: Microsoft Purview account
138+
href: ../../purview/quickstart-bicep-create-azure-purview.md?toc=/azure/azure-resource-manager/bicep/toc.json
137139
- name: Resource Graph
138140
href: ../../governance/resource-graph/shared-query-bicep.md?toc=/azure/azure-resource-manager/bicep/toc.json
139141
- name: Role-based access control - role assignment

‎articles/purview/quickstart-bicep-create-azure-purview.md

Lines changed: 118 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
---
2+
title: 'Quickstart: Create a Microsoft Purview (formerly Azure Purview) account using Bicep'
3+
description: This Quickstart describes how to create a Microsoft Purview (formerly Azure Purview) account using Bicep.
4+
author: schaffererin
5+
ms.author: v-eschaffer
6+
ms.date: 07/05/2022
7+
ms.topic: quickstart
8+
ms.service: purview
9+
ms.custom: mode-arm
10+
---
11+
12+
# Quickstart: Create a Microsoft Purview (formerly Azure Purview) account using Bicep
13+
14+
This quickstart describes the steps to deploy a Microsoft Purview (formerly Azure Purview) account using Bicep.
15+
16+
[!INCLUDE [About Bicep](../../includes/resource-manager-quickstart-bicep-introduction.md)]
17+
18+
After you've created the account, you can begin registering your data sources and using the Microsoft Purview governance portal to understand and govern your data landscape. By connecting to data across your on-premises, multi-cloud, and software-as-a-service (SaaS) sources, the Microsoft Purview Data Map creates an up-to-date map of your information. It identifies and classifies sensitive data, and provides end-to-end data linage. Data consumers are able to discover data across your organization and data administrators are able to audit, secure, and ensure right use of your data.
19+
20+
For more information about the governance capabilities of Microsoft Purview, formerly Azure Purview, [see our overview page](overview.md). For more information about deploying Microsoft Purview across your organization, [see our deployment best practices](deployment-best-practices.md).
21+
22+
To deploy a Microsoft Purview account to your subscription, follow the prerequisites guide below.
23+
24+
[!INCLUDE [purview-quickstart-prerequisites](includes/purview-quickstart-prerequisites.md)]
25+
26+
## Review the Bicep file
27+
28+
The Bicep file used in this quickstart is from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/data-share-share-storage-account/).
29+
30+
:::code language="bicep" source="~/quickstart-templates/quickstarts/microsoft.datashare/data-share-share-storage-account/main.bicep":::
31+
32+
The following resources are defined in the Bicep file:
33+
34+
* [**Microsoft.Purview/accounts**](/azure/templates/microsoft.purview/accounts)
35+
36+
The Bicep performs the following tasks:
37+
38+
* Creates a Microsoft Purview account in the specified resource group.
39+
40+
## Deploy the Bicep file
41+
42+
1. Save the Bicep file as `main.bicep` to your local computer.
43+
1. Deploy the Bicep file using Azure CLI or Azure PowerShell.
44+
45+
> [!NOTE]
46+
> Replace **\<project-name\>** with a project name that will be used to generate resource names. Replace **\<invitation-email\>** with an email address for receiving data share invitations.
47+
48+
# [CLI](#tab/CLI)
49+
50+
```azurecli-interactive
51+
az group create --name exampleRG --location eastus
52+
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters projectName=<project-name> invitationEmail=<invitation-email>
53+
```
54+
55+
# [PowerShell](#tab/PowerShell)
56+
57+
```powershell-interactive
58+
New-AzResourceGroup -Name exampleRG -Location eastus
59+
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -projectName "<project-name>" -invitationEmail "<invitation-email>"
60+
```
61+
62+
---
63+
64+
When the deployment finishes, you should see a message indicating the deployment succeeded.
65+
66+
## Open Microsoft Purview governance portal
67+
68+
After your Microsoft Purview account is created, you'll use the Microsoft Purview governance portal to access and manage it. There are two ways to open Microsoft Purview governance portal:
69+
70+
* Open your Microsoft Purview account in the [Azure portal](https://portal.azure.com). Select the "Open Microsoft Purview governance portal" tile on the overview page.
71+
:::image type="content" source="media/create-catalog-portal/open-purview-studio.png" alt-text="Screenshot showing the Microsoft Purview account overview page, with the Microsoft Purview governance portal tile highlighted.":::
72+
73+
* Alternatively, you can browse to [https://web.purview.azure.com](https://web.purview.azure.com), select your Microsoft Purview account, and sign in to your workspace.
74+
75+
## Get started with your Purview resource
76+
77+
After deployment, the first activities are usually:
78+
79+
* [Create a collection](quickstart-create-collection.md)
80+
* [Register a resource](azure-purview-connector-overview.md)
81+
* [Scan the resource](concept-scans-and-ingestion.md)
82+
83+
At this time, these actions aren't able to be taken through a Bicep file. Follow the guides above to get started!
84+
85+
## Clean up resources
86+
87+
To clean up the resources deployed in this quickstart, delete the resource group, which deletes all resources in the group.
88+
89+
You can delete the resources through the Azure portal, Azure CLI, or Azure PowerShell.
90+
91+
# [CLI](#tab/CLI)
92+
93+
```azurecli-interactive
94+
az group delete --name exampleRG
95+
```
96+
97+
# [PowerShell](#tab/PowerShell)
98+
99+
```powershell-interactive
100+
Remove-AzResourceGroup -Name exampleRG
101+
```
102+
103+
---
104+
105+
## Next steps
106+
107+
In this quickstart, you learned how to create a Microsoft Purview (formerly Azure Purview) account using Bicep and how to access the Microsoft Purview governance portal.
108+
109+
Next, you can create a user-assigned managed identity (UAMI) that will enable your new Microsoft Purview account to authenticate directly with resources using Azure Active Directory (Azure AD) authentication.
110+
111+
To create a UAMI, follow our [guide to create a user-assigned managed identity](manage-credentials.md#create-a-user-assigned-managed-identity).
112+
113+
Follow these next articles to learn how to navigate the Microsoft Purview governance portal, create a collection, and grant access to Microsoft Purview:
114+
115+
> [!div class="nextstepaction"]
116+
> [Using the Microsoft Purview governance portal](use-azure-purview-studio.md)
117+
> [Create a collection](quickstart-create-collection.md)
118+
> [Add users to your Microsoft Purview account](catalog-permissions.md)

‎articles/purview/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,8 @@ items:
1818
href: create-azure-purview-dotnet.md
1919
- name: Create an account - Python
2020
href: create-azure-purview-python.md
21+
- name: Create an account - Bicep
22+
href: quickstart-bicep-create-azure-purview.md
2123
- name: Create an account - ARM
2224
href: quickstart-ARM-create-azure-purview.md
2325
- name: Create a collection - Azure portal

0 commit comments

Comments
 (0)