Skip to content

Commit e7cf88a

Browse files
authored
Merge pull request #17145 from sethmanheim/mefresh
Freshness top 40
2 parents 6725f82 + 92f971b commit e7cf88a

13 files changed

+240
-261
lines changed

AKS-Arc/aks-create-clusters-portal.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Create Kubernetes clusters using the Azure portal.
44
author: sethmanheim
55
ms.author: sethm
66
ms.topic: how-to
7-
ms.date: 01/30/2024
7+
ms.date: 02/20/2025
88
ms.reviewer: guanghu
99
ms.lastreviewed: 01/30/2024
1010
---
@@ -29,7 +29,7 @@ This article describes how to create Kubernetes clusters in Azure Local using th
2929
## Create a Kubernetes cluster
3030

3131
1. Sign in to the [Azure portal](https://portal.azure.com/).
32-
1. On the Azure portal search bar, type Kubernetes Azure Arc.
32+
1. On the Azure portal search bar, type **Kubernetes Azure Arc**.
3333
1. Select **Add > Create a Kubernetes cluster with Azure Arc**:
3434

3535
:::image type="content" source="media/aks-create-clusters-portal/cluster-portal.png" alt-text="Screenshot showing cluster creation page on the portal." lightbox="media/aks-create-clusters-portal/cluster-portal.png":::

AKS-Arc/concepts-support.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Tested resource limits, VM sizes, and regions for AKS enabled by Azure Ar
33
description: Resource limits, VM sizes, regions for Azure Kubernetes Service (AKS) enabled by Azure Arc.
44
author: sethmanheim
55
ms.topic: conceptual
6-
ms.date: 12/21/2023
6+
ms.date: 02/20/2025
77
ms.author: sethm
88
ms.lastreviewed: 02/03/2022
99
ms.reviewer: mamezgeb

AKS-Arc/includes/install-akshci-ps.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ author: sethmanheim
33
ms.author: sethm
44
ms.service: azure-stack
55
ms.topic: include
6-
ms.date: 12/21/2023
6+
ms.date: 02/21/2025
77
ms.reviewer: abha
88
ms.lastreviewed: 05/02/2022
99

@@ -23,7 +23,7 @@ Follow these steps on all nodes in your Azure Local cluster or Windows Server cl
2323

2424
You must close all existing PowerShell windows again to ensure that loaded modules are refreshed. Don't continue to the next step until you close all open PowerShell windows.
2525

26-
1. Install the AKS-HCI PowerShell module by running the following command on all nodes in your Azure Local or Windows Server cluster:
26+
1. Install the **AksHci** PowerShell module by running the following command on all nodes in your Azure Local or Windows Server cluster:
2727

2828
```powershell
2929
Install-Module -Name AksHci -Repository PSGallery -Force -AcceptLicense
@@ -39,4 +39,4 @@ You can use a [helper script to delete old AKS-HCI PowerShell modules](https://g
3939
Get-Command -Module AksHci
4040
```
4141

42-
To view the complete list of AksHci PowerShell commands, see [AksHci PowerShell](../reference/ps/index.md).
42+
For the complete list of **AksHci** PowerShell commands, see [AksHci PowerShell](../reference/ps/index.md).

AKS-Arc/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ metadata:
99
ms.topic: landing-page
1010
author: sethmanheim
1111
ms.author: sethm
12-
ms.date: 02/15/2024
12+
ms.date: 02/20/2025
1313

1414
landingContent:
1515
- title: About AKS enabled by Azure Arc

AKS-Arc/kubernetes-walkthrough-powershell.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Use PowerShell to set up Kubernetes on Azure Local and Windows Server clu
33
description: Learn how to set up an AKS host and create Kubernetes clusters using Windows PowerShell.
44
author: sethmanheim
55
ms.topic: quickstart
6-
ms.date: 12/21/2023
6+
ms.date: 02/21/2025
77
ms.author: sethm
88
ms.lastreviewed: 05/02/2022
99
ms.reviewer: mikek
@@ -25,11 +25,11 @@ This quickstart guides you through setting up an Azure Kubernetes Service (AKS)
2525
> [!NOTE]
2626
> - If you have pre-staged cluster service objects and DNS records, see [Deploy an AKS host with prestaged cluster service objects and DNS records using PowerShell](prestage-cluster-service-host-create.md).
2727
> - If you have a proxy server, see [Set up an AKS host and deploy a workload cluster using PowerShell and a proxy server](set-proxy-settings.md).
28-
> - Installing AKS on Azure Local after setting up Arc VMs is not supported. For more information, see [known issues with Arc VMs](/azure-stack/hci/manage/troubleshoot-arc-enabled-vms#limitations-and-known-issues). If you want to install AKS on Azure Local, you must uninstall Arc Resource Bridge and then install AKS on Azure Local. You can deploy a new Arc Resource Bridge again after you clean up and install AKS, but it won't remember the VM entities you created previously.
28+
> - Installing AKS on Azure Local after setting up Arc VMs is not supported. For more information, see [known issues with Arc VMs](/azure/azure-local/manage/troubleshoot-arc-enabled-vms#limitations-and-known-issues). If you want to install AKS on Azure Local, you must uninstall Arc Resource Bridge and then install AKS on Azure Local. You can deploy a new Arc Resource Bridge again after you clean up and install AKS, but it won't remember the VM entities you created previously.
2929
3030
## Before you begin
3131

32-
- Make sure you have satisfied all the prerequisites in [system requirements](.\system-requirements.md).
32+
- Make sure you satisfy all the prerequisites in [system requirements](.\system-requirements.md).
3333
- Use an Azure account to register your AKS host for billing. For more information, see [Azure requirements](.\system-requirements.md#azure-requirements).
3434

3535
## Install the AksHci PowerShell module
@@ -38,7 +38,7 @@ This quickstart guides you through setting up an Azure Kubernetes Service (AKS)
3838

3939
## Register the resource provider to your subscription
4040

41-
Before the registration process, enable the appropriate resource provider in Azure for AKS enabled by Arc registration. To do that, run the following PowerShell commands:
41+
Before the registration process, enable the appropriate resource provider in Azure for the AKS enabled by Arc registration. To do so, run the following PowerShell commands:
4242

4343
To sign in to Azure, run the [Connect-AzAccount](/powershell/module/az.accounts/connect-azaccount) PowerShell command:
4444

@@ -52,7 +52,7 @@ If you want to switch to a different subscription, run the [Set-AzContext](/powe
5252
Set-AzContext -Subscription "xxxx-xxxx-xxxx-xxxx"
5353
```
5454

55-
Run the following commands to register your Azure subscription to Azure Arc enabled Kubernetes resource providers. This registration process can take up to 10 minutes, but it only needs to be performed once on a specific subscription:
55+
Run the following commands to register your Azure subscription to Azure Arc-enabled Kubernetes resource providers. This registration process can take up to 10 minutes, but it only needs to be performed once on a specific subscription:
5656

5757
```powershell
5858
Register-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
@@ -80,7 +80,7 @@ Initialize-AksHciNode
8080

8181
Run the following commands on any one node in your Azure Local and Windows Server cluster.
8282

83-
To get the names of your available switches, run the following command. Make sure the `SwitchType` of your VM switch is "External":
83+
To get the names of your available switches, run the following command. Make sure the `SwitchType` of your VM switch is **External**:
8484

8585
```powershell
8686
Get-VMSwitch
@@ -94,10 +94,10 @@ Name SwitchType NetAdapterInterfaceDescription
9494
extSwitch External Mellanox ConnectX-3 Pro Ethernet Adapter
9595
```
9696

97-
To create a virtual network for the nodes in your deployment to use, create an environment variable with the **New-AksHciNetworkSetting** PowerShell command. This virtual network is used later to configure a deployment that uses static IP. If you want to configure your AKS deployment with DHCP, see [New-AksHciNetworkSetting](./reference/ps/new-akshcinetworksetting.md) for examples. You can also review some [networking node concepts](./concepts-node-networking.md).
97+
To create a virtual network for the nodes in your deployment to use, create an environment variable with the [New-AksHciNetworkSetting](./reference/ps/new-akshcinetworksetting.md) PowerShell command. This virtual network is used later to configure a deployment that uses static IP. If you want to configure your AKS deployment with DHCP, see [New-AksHciNetworkSetting](./reference/ps/new-akshcinetworksetting.md) for examples. You can also review some [networking node concepts](./concepts-node-networking.md).
9898

9999
```powershell
100-
#static IP
100+
# static IP
101101
$vnet = New-AksHciNetworkSetting -name myvnet -vSwitchName "extSwitch" -k8sNodeIpPoolStart "172.16.10.1" -k8sNodeIpPoolEnd "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipAddressPrefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsServers "172.16.0.1" -vlanId 9
102102
```
103103

@@ -106,7 +106,7 @@ $vnet = New-AksHciNetworkSetting -name myvnet -vSwitchName "extSwitch" -k8sNodeI
106106
107107
## Step 3: Configure your deployment
108108

109-
Run the following commands on any one node in your Azure Local and Windows Server cluster.
109+
Run the following commands on any node in your Azure Local and Windows Server cluster.
110110

111111
To create the configuration settings for the AKS host, use the [Set-AksHciConfig](./reference/ps/set-akshciconfig.md) command. You must specify the `imageDir`, `workingDir`, and `cloudConfigLocation` parameters. If you want to reset your configuration details, run the command again with new parameters.
112112

@@ -134,13 +134,13 @@ Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<r
134134

135135
### Option 2: Use an Azure service principal
136136

137-
If you don't have access to a subscription on which you're an "Owner", you can register your AKS host to Azure for billing using a service principal. For more information about how to use a service principal, see [register AKS on Azure Local and Windows Server using a service principal](reference/ps/set-akshciregistration.md#register-aks-hybrid-using-a-service-principal).
137+
If you don't have access to a subscription on which you're an **Owner**, you can register your AKS host to Azure for billing using a service principal. For more information about how to use a service principal, see [register AKS on Azure Local and Windows Server using a service principal](reference/ps/set-akshciregistration.md#register-aks-hybrid-using-a-service-principal).
138138

139139
## Step 5: Start a new deployment
140140

141-
Run the following command on any one node in your Azure Local or Windows Server cluster.
141+
Run the following command on any node in your Azure Local or Windows Server cluster.
142142

143-
After you configure your deployment, you must start it in order to install the AKS agents/services and the AKS host. To begin deployment, run the following command:
143+
After you configure your deployment, you must start it in order to install the AKS agents and services, and the AKS host. To begin deployment, run the following command:
144144

145145
> [!TIP]
146146
> To see additional status details during installation, set `$VerbosePreference = "Continue"` before proceeding.
@@ -206,7 +206,7 @@ Enable-AksHciArcConnection -name mycluster
206206
```
207207

208208
> [!NOTE]
209-
> If you encounter issues or error messages during the installation process, see [installation known issues and errors](/azure-stack/aks-hci/known-issues-installation) for more information.
209+
> If you encounter issues or error messages during the installation process, see [Installation known issues and errors](known-issues-installation.yml) for more information.
210210
211211
## Scale a Kubernetes cluster
212212

@@ -231,7 +231,7 @@ To scale worker nodes in a node pool, use the [Set-AksHciNodePool](/azure-stack/
231231

232232
## Access your clusters using kubectl
233233

234-
To access your Kubernetes clusters using kubectl, run the [Get-AksHciCredential](./reference/ps/get-akshcicredential.md) PowerShell command. This will use the specified cluster's kubeconfig file as the default kubeconfig file for kubectl. You can also use kubectl to [deploy applications using Helm](./helm-deploy.md):
234+
To access your Kubernetes clusters using **kubectl**, run the [Get-AksHciCredential](./reference/ps/get-akshcicredential.md) PowerShell command. This command uses the specified cluster's **kubeconfig** file as the default **kubeconfig** file for **kubectl**. You can also use **kubectl** to [deploy applications using Helm](./helm-deploy.md):
235235

236236
```powershell
237237
Get-AksHciCredential -name mycluster
@@ -246,7 +246,7 @@ Remove-AksHciCluster -name mycluster
246246
```
247247

248248
> [!NOTE]
249-
> Make sure that your cluster is deleted by looking at the existing VMs in the Hyper-V Manager. If they are not deleted, then you can manually delete the VMs. Then, run the command `Restart-Service wssdagent`. Run this command on each node in the failover cluster.
249+
> Make sure that your cluster is deleted by looking at the existing VMs in Hyper-V Manager. If they aren't deleted, you can manually delete the VMs. Then, run the command `Restart-Service wssdagent`. Run this command on each node in the failover cluster.
250250
251251
## Get logs
252252

@@ -256,7 +256,7 @@ To get logs from your all your pods, run the [Get-AksHciLogs](./reference/ps/get
256256
Get-AksHciLogs
257257
```
258258

259-
In this quickstart, you learned how to set up an AKS host and create Kubernetes clusters using PowerShell. You also learned how to use PowerShell to scale a Kubernetes cluster and to access clusters with `kubectl`.
259+
In this quickstart, you learned how to set up an AKS host and create Kubernetes clusters using PowerShell. You also learned how to use PowerShell to scale a Kubernetes cluster and to access clusters with **kubectl**.
260260

261261
## Next steps
262262

0 commit comments

Comments
 (0)