Skip to content

Commit 4c210a6

Browse files
author
Sreekanth Iyer (Ushta Te Consultancy Services)
committed
Modified Quickstart
1 parent 4e49bd8 commit 4c210a6

9 files changed

+285
-191
lines changed

‎articles/hdinsight-aks/.openpublishing.redirection.hdinsight-aks.json

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,16 +5,31 @@
55
"redirect_url": "/azure/hdinsight-aks/flink/flink-overview",
66
"redirect_document_id": false
77
},
8+
{
9+
"source_path_from_root": "/articles/hdinsight-aks/prerequisites-subscription.md",
10+
"redirect_url": "/azure/hdinsight-aks/quickstart-prerequisites-subscription",
11+
"redirect_document_id": false
12+
},
813
{
914
"source_path_from_root": "/articles/hdinsight-aks/release-notes/index.md",
1015
"redirect_url": "/azure/hdinsight-aks/release-notes/hdinsight-aks-release-notes",
1116
"redirect_document_id": false
1217
},
18+
{
19+
"source_path_from_root": "/articles/hdinsight-aks/prerequisites-resources.md",
20+
"redirect_url": "/azure/hdinsight-aks/spark/quickstart-prerequisites-resources",
21+
"redirect_document_id": false
22+
},
1323
{
1424
"source_path_from_root": "/articles/hdinsight-aks/spark/index.md",
1525
"redirect_url": "/azure/hdinsight-aks/spark/hdinsight-on-aks-spark-overview",
1626
"redirect_document_id": false
1727
},
28+
{
29+
"source_path_from_root": "/articles/hdinsight-aks/get-started.md",
30+
"redirect_url": "/azure/hdinsight-aks/quickstart-get-started",
31+
"redirect_document_id": false
32+
},
1833
{
1934
"source_path_from_root": "/articles/hdinsight-aks/trino/index.md",
2035
"redirect_url": "/azure/hdinsight-aks/trino/trino-overview ",

‎articles/hdinsight-aks/TOC.yml

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,16 +8,22 @@ items:
88
href: overview.md
99
- name: What's new?
1010
href: whats-new.md
11-
- name: Preview information
12-
href: preview.md
1311
- name: Quickstarts
1412
items:
1513
- name: Subscription prerequisites
16-
href: prerequisites-subscription.md
14+
href: quickstart-prerequisites-subscription.md
1715
- name: Resource prerequisites
18-
href: prerequisites-resources.md
16+
href: quickstart-prerequisites-resources.md
1917
- name: One click deployment
20-
href: get-started.md
18+
href: quickstart-get-started.md
19+
- name: Create a cluster pool and cluster
20+
items:
21+
- name: Create a cluster pool and cluster - Azure portal
22+
href: quickstart-create-cluster.md
23+
- name: Create a HDInsight on AKS cluster pool and cluster - Azure CLI
24+
href: quickstart-create-cli.md
25+
- name: Create a HDInsight on AKS cluster pool and cluster - Azure PowerShell
26+
href: quickstart-create-powershell.md
2127
- name: Concepts
2228
items:
2329
- name: Reliability

‎articles/hdinsight-aks/powershell-cluster-create.md

Lines changed: 0 additions & 171 deletions
This file was deleted.

‎articles/hdinsight-aks/quickstart-create-cli.md

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
---
2+
title: Quickstart - Create HDInsight on AKS cluster with Azure CLI
3+
description: Learn how to use Azure CLI to create a HDInsight on AKS cluster pool.
4+
ms.service: hdinsight-aks
5+
ms.topic: quickstart
6+
ms.date: 06/04/2024
7+
---
8+
9+
# Quickstart: Create a HDInsight on AKS Cluster Pool with the Azure CLI on Azure
10+
11+
This quickstart shows you how to use the PowerShell to deploy a HDInsight on AKS Cluster Pool in Azure.
12+
13+
## Prerequisites
14+
Ensure that you completed the [subscription prerequisites](./quickstart-prerequisites-subscription.md) and [resource prerequisites](./quickstart-prerequisites-resources.md) before creating a cluster pool.
15+
16+
The command New-AzHdInsightOnAksClusterPool is part of Azure PowerShell module "Az.HdInsightOnAks" and it isn't installed. Run **"Install-Module Az.HdInsightOnAks"** to install it.
17+
18+
## Launch Azure Cloud Shell
19+
20+
The Azure Cloud Shell is a free interactive shell that you can use to run the steps in this article. It has common Azure tools preinstalled and configured to use with your account.
21+
22+
To open the Cloud Shell, just select **Try it** from the upper right corner of a code block. Select **Copy** to copy the blocks of code, paste it into the Cloud Shell, and press enter to run it.
23+
24+
## Create a resource group
25+
26+
Create an Azure resource group with [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup). A resource group is a logical container into which Azure resources are deployed and managed:
27+
28+
```Azure PowerShell
29+
New-AzResourceGroup -Name 'HDIonAKSPowershell' -Location 'West US 3'
30+
```
31+
32+
## Create the HDInsight on AKS Cluster Pool
33+
34+
To create a HDInsight on AKS Cluster Pool in this resource group, use the `New-AzHdInsightOnAksClusterPool` command:
35+
```PowerShell
36+
New-AzHdInsightOnAksClusterPool
37+
-Name <String>
38+
-ResourceGroupName <String>
39+
[-SubscriptionId <String>]
40+
-Location <String>
41+
[-ClusterPoolVersion <String>]
42+
[-EnableLogAnalytics]
43+
[-LogAnalyticWorkspaceResourceId <String>]
44+
[-ManagedResourceGroupName <String>]
45+
[-NetworkProfileApiServerAuthorizedIPRange <String[]>]
46+
[-NetworkProfileEnablePrivateApiServer]
47+
[-NetworkProfileOutboundType <String>]
48+
[-SubnetId <String>]
49+
[-Tag <Hashtable>]
50+
[-VmSize <String>]
51+
[-DefaultProfile <PSObject>]
52+
[-AsJob]
53+
[-NoWait]
54+
[-WhatIf]
55+
[-Confirm]
56+
[<CommonParameters>]
57+
```
58+
Here's an example:
59+
```PowerShell
60+
$location = "West US 3"
61+
$clusterResourceGroupName = "HDIonAKSPowershell"
62+
$clusterpoolName = "HDIClusterPoolSample"
63+
$vmSize = "Standard_E4s_v3"
64+
$clusterpoolversion="1.1"
65+
66+
# Create the cluster pool
67+
New-AzHdInsightOnAksClusterPool `
68+
-Name $clusterpoolName `
69+
-ResourceGroupName $clusterResourceGroupName `
70+
-Location $location `
71+
-VmSize $vmSize `
72+
-ClusterPoolVersion $clusterpoolversion
73+
```
74+
75+
It takes a few minutes to create the HDInsight on AKS Cluster Pool. The following example output shows the created operation was successful.
76+
77+
Results:
78+
<!-- expected_similarity=0.3 -->
79+
```
80+
AkClusterProfileAkClusterAgentPoolIdentityProfileMsiClientId : a75ec1ff-3f7f-4f44-820c-6eaa5c8191af
81+
AkClusterProfileAkClusterAgentPoolIdentityProfileMsiObjectId : 13990b78-4140-4d10-b333-69bb78524375
82+
AkClusterProfileAkClusterAgentPoolIdentityProfileMsiResourceId : /subscriptions/0b130652-e15b-417e-885a-050c9a3024a2/resourcegroups/MC_hdi-44640a235566423490b9fb694d6c05a3_HDIClusterP
83+
oolSample_westus3/providers/Microsoft.ManagedIdentity/userAssignedIdentities/HDIClusterPoolSample-agentpool
84+
AkClusterProfileAksClusterResourceId : /subscriptions/0b130652-e15b-417e-885a-050c9a3024a2/resourceGroups/hdi-44640a235566423490b9fb694d6c05a3/providers/Micr
85+
osoft.ContainerService/managedClusters/HDIClusterPoolSample
86+
AkClusterProfileAksVersion : 1.27.9
87+
AksManagedResourceGroupName : MC_hdi-44640a235566423490b9fb694d6c05a3_HDIClusterPoolSample_westus3
88+
ComputeProfileCount : 3
89+
ComputeProfileVMSize : Standard_E4s_v3
90+
DeploymentId : 44640a235566423490b9fb694d6c05a3
91+
Id : /subscriptions/0b130652-e15b-417e-885a-050c9a3024a2/resourceGroups/HDIonAKSPowershell/providers/Microsoft.HDInsight/cl
92+
usterpools/HDIClusterPoolSample
93+
Location : West US 3
94+
LogAnalyticProfileEnabled : False
95+
LogAnalyticProfileWorkspaceId :
96+
ManagedResourceGroupName : hdi-44640a235566423490b9fb694d6c05a3
97+
Name : HDIClusterPoolSample
98+
NetworkProfileApiServerAuthorizedIPRange :
99+
NetworkProfileEnablePrivateApiServer :
100+
NetworkProfileOutboundType :
101+
NetworkProfileSubnetId :
102+
ProfileClusterPoolVersion : 1.1
103+
ProvisioningState : Succeeded
104+
ResourceGroupName : HDIonAKSPowershell
105+
Status : Running
106+
SystemDataCreatedAt : 6/2/2024 11:53:01 AM
107+
SystemDataCreatedBy : [email protected]
108+
SystemDataCreatedByType : User
109+
SystemDataLastModifiedAt : 6/2/2024 11:53:01 AM
110+
SystemDataLastModifiedBy : [email protected]
111+
SystemDataLastModifiedByType : User
112+
Tag : {
113+
}
114+
Type : microsoft.hdinsight/clusterpools
115+
```
116+
117+
## Next Steps
118+
119+
* [New-AzHdInsightOnAksClusterPool](/powershell/module/az.hdinsightonaks/new-azhdinsightonaksclusterpool)
120+
* [Create cluster pool and cluster](./quickstart-create-cluster.md)

‎articles/hdinsight-aks/quickstart-create-cluster.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ title: Create cluster pool and cluster
33
description: Creating a cluster pool and cluster in HDInsight on AKS.
44
ms.service: hdinsight-aks
55
ms.topic: quickstart
6-
ms.date: 12/11/2023
6+
ms.date: 06/03/2024
77
---
88

99
# Create cluster pool and cluster
1010

11-
[!INCLUDE [feature-in-preview](includes/feature-in-preview.md)]
11+
1212

1313
HDInsight on AKS has the concept of cluster pools and clusters.
1414

@@ -22,7 +22,7 @@ For creating Apache Spark, Apache Flink, or Trino clusters, you need to first cr
2222

2323
## Prerequisites
2424

25-
Ensure that you have completed the [subscription prerequisites](prerequisites-subscription.md) and [resource prerequisites](prerequisites-resources.md) before creating a cluster pool.
25+
Ensure that you have completed the [subscription prerequisites](quickstart-prerequisites-subscription.md) and [resource prerequisites](quickstart-prerequisites-resources.md) before creating a cluster pool.
2626

2727
## Create a cluster pool
2828

@@ -45,7 +45,7 @@ Ensure that you have completed the [subscription prerequisites](prerequisites-su
4545
|Subscription| From the drop-down list, select the Azure subscription under which you want to create HDInsight on AKS cluster pool.|
4646
|Resource group|From the drop-down list, select an existing resource group, or select **Create new.**|
4747
|Pool name| Enter the name of the cluster pool to be created. Cluster pool name length can't be more than 26 characters. It must start with an alphabet, end with an alphanumeric character, and must only contain alphanumeric characters and hyphens.|
48-
|Region|From the drop-down list, select the region for the cluster pool. Check [region availability](./overview.md#region-availability-public-preview). For cluster pools in a virtual network, the region for the virtual network and the cluster pool must be same. |
48+
|Region|From the drop-down list, select the region for the cluster pool. Check [region availability](./overview.md#region-availability). For cluster pools in a virtual network, the region for the virtual network and the cluster pool must be same. |
4949
|Cluster pool version|From the drop-down list, select the HDInsight on AKS cluster pool version. |
5050
|Virtual machine|From the drop-down list, select the virtual machine size for the cluster pool based on your requirement.|
5151
|Managed resource group|(Optional) Provide a name for managed resource group. It holds ancillary resources created by HDInsight on AKS.|
@@ -204,3 +204,5 @@ For a quickstart, refer to the following steps.
204204

205205
> [!TIP]
206206
> For troubleshooting any deployment errors, you can refer to this [page](./create-cluster-error-dictionary.md).
207+
208+

0 commit comments

Comments
 (0)