You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AKS-Arc/includes/install-akshci-ps.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ author: sethmanheim
3
3
ms.author: sethm
4
4
ms.service: azure-stack
5
5
ms.topic: include
6
-
ms.date: 12/21/2023
6
+
ms.date: 02/21/2025
7
7
ms.reviewer: abha
8
8
ms.lastreviewed: 05/02/2022
9
9
@@ -23,7 +23,7 @@ Follow these steps on all nodes in your Azure Local cluster or Windows Server cl
23
23
24
24
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.
25
25
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:
Copy file name to clipboardExpand all lines: AKS-Arc/kubernetes-walkthrough-powershell.md
+16-16Lines changed: 16 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Use PowerShell to set up Kubernetes on Azure Local and Windows Server clu
3
3
description: Learn how to set up an AKS host and create Kubernetes clusters using Windows PowerShell.
4
4
author: sethmanheim
5
5
ms.topic: quickstart
6
-
ms.date: 12/21/2023
6
+
ms.date: 02/21/2025
7
7
ms.author: sethm
8
8
ms.lastreviewed: 05/02/2022
9
9
ms.reviewer: mikek
@@ -25,11 +25,11 @@ This quickstart guides you through setting up an Azure Kubernetes Service (AKS)
25
25
> [!NOTE]
26
26
> - 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).
27
27
> - 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.
29
29
30
30
## Before you begin
31
31
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).
33
33
- Use an Azure account to register your AKS host for billing. For more information, see [Azure requirements](.\system-requirements.md#azure-requirements).
34
34
35
35
## Install the AksHci PowerShell module
@@ -38,7 +38,7 @@ This quickstart guides you through setting up an Azure Kubernetes Service (AKS)
38
38
39
39
## Register the resource provider to your subscription
40
40
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:
42
42
43
43
To sign in to Azure, run the [Connect-AzAccount](/powershell/module/az.accounts/connect-azaccount) PowerShell command:
44
44
@@ -52,7 +52,7 @@ If you want to switch to a different subscription, run the [Set-AzContext](/powe
52
52
Set-AzContext -Subscription "xxxx-xxxx-xxxx-xxxx"
53
53
```
54
54
55
-
Run the following commands to register your Azure subscription to Azure Arcenabled 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:
Run the following commands on any one node in your Azure Local and Windows Server cluster.
82
82
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**:
84
84
85
85
```powershell
86
86
Get-VMSwitch
@@ -94,10 +94,10 @@ Name SwitchType NetAdapterInterfaceDescription
94
94
extSwitch External Mellanox ConnectX-3 Pro Ethernet Adapter
95
95
```
96
96
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).
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.
110
110
111
111
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.
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).
138
138
139
139
## Step 5: Start a new deployment
140
140
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.
142
142
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:
144
144
145
145
> [!TIP]
146
146
> To see additional status details during installation, set `$VerbosePreference = "Continue"` before proceeding.
> 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.
210
210
211
211
## Scale a Kubernetes cluster
212
212
@@ -231,7 +231,7 @@ To scale worker nodes in a node pool, use the [Set-AksHciNodePool](/azure-stack/
231
231
232
232
## Access your clusters using kubectl
233
233
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):
> 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.
250
250
251
251
## Get logs
252
252
@@ -256,7 +256,7 @@ To get logs from your all your pods, run the [Get-AksHciLogs](./reference/ps/get
256
256
Get-AksHciLogs
257
257
```
258
258
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**.
0 commit comments