Skip to content

Commit 5f97e4e

Browse files
committed
Move CLI and resource group setup instructions up front
1 parent 7310dea commit 5f97e4e

File tree

1 file changed

+57
-29
lines changed

1 file changed

+57
-29
lines changed

articles/operator-insights/data-product-create.md

Lines changed: 57 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -24,27 +24,18 @@ In this article, you learn how to create an Azure Operator Insights Data Product
2424
- (Optional) If you plan to integrate Data Product with Microsoft Purview, you must have an active Purview account. Make note of the Purview collection ID when you [set up Microsoft Purview with a Data Product](purview-setup.md).
2525
- After obtaining your subscription access, register the Microsoft.NetworkAnalytics and Microsoft.HybridNetwork Resource Providers (RPs) to continue. For guidance on registering RPs in your subscription, see [Register resource providers in Azure](../azure-resource-manager/management/resource-providers-and-types.md#azure-portal).
2626

27-
### For CMK-based data encryption or Microsoft Purview
27+
## Prepare your Azure portal or Azure CLI environment
2828

29-
If you're using CMK-based data encryption or Microsoft Purview, you must set up Azure Key Vault and user-assigned managed identity (UAMI) as prerequisites.
30-
31-
#### Set up Azure Key Vault
29+
You can use the Azure portal or the Azure CLI to follow the steps in this article.
3230

33-
Azure key Vault Resource is used to store your Customer Managed Key (CMK) for data encryption. Data Product uses this key to encrypt your data over and above the standard storage encryption. You need to have Subscription/Resource group owner permissions to perform this step.
3431

3532
# [Portal](#tab/azure-portal)
3633

37-
1. [Create an Azure Key Vault resource](../key-vault/general/quick-create-portal.md) in the same subscription and resource group where you intend to deploy the Data Product resource.
38-
1. Provide your user account with the Key Vault Administrator role on the Azure Key Vault resource. This is done via the **Access Control (IAM)** tab on the Azure Key Vault resource.
39-
1. Navigate to the object and select **Keys**. Select **Generate/Import**.
40-
1. Enter a name for the key and select **Create**.
41-
1. Select the newly created key and select the current version of the key.
42-
1. Copy the Key Identifier URI to your clipboard to use when creating the Data Product.
34+
Confirm that you can sign in to the [Azure portal](https://portal.azure.com) and can access the subscription.
4335

4436
# [Azure CLI](#tab/azure-cli)
45-
<!-- CLI link is [Create an Azure Key Vault resource](../key-vault/general/quick-create-cli.md) in the same subscription and resource group where you intend to deploy the Data Product resource. -->
4637

47-
You can sign in to Azure and run Azure CLI commands in one of two ways:
38+
You can run Azure CLI commands in one of two ways:
4839

4940
- You can run CLI commands from within the Azure portal, in Azure Cloud Shell.
5041
- You can install the CLI and run CLI commands locally.
@@ -63,17 +54,14 @@ The button launches an interactive shell that you can use to run the steps outli
6354
### Install the Azure CLI locally
6455

6556
You can also install and use the Azure CLI locally. If you plan to use Azure CLI locally, make sure you have installed the latest version of the Azure CLI. See [Install the Azure CLI](/cli/azure/install-azure-cli).
66-
Azure Cloud Shell is a free Bash shell that you can run directly within the Azure portal. The Azure CLI is preinstalled and configured to use with your account. Select the Cloud Shell button on the menu in the upper-right section of the Azure portal:
67-
68-
To launch Azure Cloud Shell, sign in to the Azure portal.
6957

7058
To log into your local installation of the CLI, run the az sign-in command:
7159

7260
```azurecli-interactive
7361
az login
7462
```
7563

76-
## Change the active subscription
64+
### Change the active subscription
7765

7866
Azure subscriptions have both a name and an ID. You can switch to a different subscription using [az account set](/cli/azure/account#az-account-set) specifying the desired subscription ID or name.
7967

@@ -84,16 +72,55 @@ az account set --subscription "My Demos"
8472
# change the active subscription using the subscription ID
8573
az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
8674
```
75+
---
8776

8877
## Create a resource group
8978

90-
A resource group is a logical container into which Azure resources are deployed and managed. Use the az group create command to create a resource group named myResourceGroup in the eastus location.
79+
A resource group is a logical container into which Azure resources are deployed and managed.
80+
81+
# [Portal](#tab/azure-portal)
82+
83+
If you plan to use CMK-based data encryption or Microsoft Purview, set up a resource group now:
84+
85+
1. Sign in to the [Azure portal](https://portal.azure.com).
86+
1. Select **Resource groups**.
87+
1. Select **Create** and follow the prompts.
88+
89+
For more information, see [Create a resource group](/azure-resource-manager/management/manage-resource-groups-portal#create-resource-groups).
90+
91+
If you don't plan to use CMK-based date encryption or Microsoft Purview, you can set up a resource group now or when you [the create the Data Product resource](#create-an-azure-operator-insights-data-product-resource).
92+
93+
# [Azure CLI](#tab/azure-cli)
94+
95+
Use the az group create command to create a resource group named myResourceGroup in the eastus location.
9196

9297
```azurecli-interactive
9398
az group create --name "myResourceGroup" --location "EastUS"
9499
```
100+
---
101+
102+
## Set up resources for CMK-based data encryption or Microsoft Purview
103+
104+
If you're using CMK-based data encryption or Microsoft Purview, you must set up Azure Key Vault and user-assigned managed identity (UAMI) as prerequisites.
95105

96-
## Create a key vault
106+
### Set up Azure Key Vault
107+
108+
Azure key Vault Resource is used to store your Customer Managed Key (CMK) for data encryption. Data Product uses this key to encrypt your data over and above the standard storage encryption. You need to have Subscription/Resource group owner permissions to perform this step.
109+
110+
# [Portal](#tab/azure-portal)
111+
112+
1. [Create an Azure Key Vault resource](../key-vault/general/quick-create-portal.md) in the same subscription and resource group where you intend to deploy the Data Product resource.
113+
1. Provide your user account with the Key Vault Administrator role on the Azure Key Vault resource. This is done via the **Access Control (IAM)** tab on the Azure Key Vault resource.
114+
1. Navigate to the object and select **Keys**. Select **Generate/Import**.
115+
1. Enter a name for the key and select **Create**.
116+
1. Select the newly created key and select the current version of the key.
117+
1. Copy the Key Identifier URI to your clipboard to use when creating the Data Product.
118+
119+
# [Azure CLI](#tab/azure-cli)
120+
121+
<!-- CLI link is [Create an Azure Key Vault resource](../key-vault/general/quick-create-cli.md) in the same subscription and resource group where you intend to deploy the Data Product resource. -->
122+
123+
#### Create a key vault
97124

98125
Use the Azure CLI az keyvault create command to create a Key Vault in the resource group from the previous step. You will need to provide some information:
99126

@@ -117,7 +144,7 @@ Vault Name: The name you provided to the --name parameter above.
117144
Vault URI: In the example, this is https://<your-unique-keyvault-name>.vault.azure.net/. Applications that use your vault through its REST API must use this URI.
118145
At this point, your Azure account is the only one authorized to perform any operations on this new vault.
119146

120-
## Key vault role assignment
147+
#### Assign roles for the key vault
121148

122149
Provide your user account with the Key Vault Administrator role on the Azure Key Vault resource.
123150

@@ -126,19 +153,19 @@ az role assignment create --role "Key Vault Administrator" --assignee <<user ema
126153
```
127154
Replace the values for subscriptionid, resource-group-name, and key-vault-name with the appropriate values.
128155

129-
## Create a Key
156+
#### Create a Key
130157

131158
```azurecli-interactive
132159
az keyvault key create --vault-name "<your-unique-keyvault-name>" -n ExampleKey --protection software
133160
```
134161

135162
From the output screen copy the KeyID and store it in your clipboard for later use.
136163

137-
<!-- PowerShell link is [Create an Azure Key Vault resource](../key-vault/general/quick-create-powershell.md) in the same subscription and resource group where you intend to deploy the Data Product resource. -->
138-
139164
---
140165

141-
#### Set up user-assigned managed identity
166+
<!-- PowerShell link is [Create an Azure Key Vault resource](../key-vault/general/quick-create-powershell.md) in the same subscription and resource group where you intend to deploy the Data Product resource. -->
167+
168+
### Set up a user-assigned managed identity
142169

143170
# [Portal](#tab/azure-portal)
144171

@@ -149,6 +176,8 @@ From the output screen copy the KeyID and store it in your clipboard for later u
149176

150177
<!-- Managed identity link for the CLI: /entra/identity/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-azcli -->
151178

179+
#### Create a user-assigned managed identity
180+
152181
To create a user-assigned managed identity, your account needs the Managed Identity Contributor role assignment.
153182

154183
Use the az identity create command to create a user-assigned managed identity. The -g parameter specifies the resource group where to create the user-assigned managed identity. The -n parameter specifies its name. Replace the <RESOURCE GROUP> and <USER ASSIGNED IDENTITY NAME> parameter values with your own values.
@@ -163,18 +192,17 @@ az identity create -g <RESOURCE GROUP> -n <USER ASSIGNED IDENTITY NAME>
163192

164193
Copy the principalId from the output screen and store it in your clipboard for later use.
165194

166-
## Assign User-Assigned Managed Identity to Key Vault
195+
#### Assign the user-assigned managed identity to the key vault
167196

168197
```azurecli-interactive
169198
az role assignment create --role "Key Vault Administrator" --assignee <<pricipalID from above step>> --scope /subscriptions/{subscriptionid}/resourcegroups/{resource-group-name}/providers/Microsoft.KeyVault/vaults/{key-vault-name}
170199
```
171200

172-
<!-- Managed identity link for PowerShell: /entra/identity/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-powershell -->
173-
174201
---
175202

203+
<!-- Managed identity link for PowerShell: /entra/identity/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-powershell -->
176204

177-
## Create an Azure Operator Insights Data Product resource in the Azure portal
205+
## Create an Azure Operator Insights Data Product resource
178206

179207
You create the Azure Operator Insights Data Product resource.
180208

@@ -256,7 +284,7 @@ For ownersemail, vaulturi, keyname, version, purviewaccount, collection, uami an
256284

257285
---
258286

259-
## Deploy Sample Insights
287+
## Deploy sample insights
260288

261289
Once your Data Product instance is created, you can deploy a sample insights dashboard. This dashboard works with the sample data that came along with the Data Product instance.
262290

0 commit comments

Comments
 (0)