Prepare your machines for AKS Edge Essentials

This article describes how to set up an Azure Kubernetes Service (AKS) Edge Essentials node machine.

Prerequisites

Note

If you are doing an offline installation, or your machine is running on a corporate environment with security policies in place that may limit internet connection, make sure to check AKS Edge Essentials offline installation.

Download AKS Edge Essentials

You can deploy an AKS Edge Essentials cluster on either a single machine or on multiple machines. In a multi-machine deployment, one of the machines is the primary machine with a Kubernetes control node, and the other machines are secondary machines that are either control nodes or worker nodes. You must install AKS Edge Essentials on both the primary and secondary machines as follows. Once AKS Edge Essentials is installed, when you create your Kubernetes cluster, you identify one machine as the primary and the rest as secondary machines.

  1. On your machine, download the AksEdge-k3s.msi or AksEdge-k8s.msi file, depending on which Kubernetes distribution you want to use. Also, if you're creating a Windows worker node, you'll need the Windows node files.

    File Link
    K8s installer (1.29.4) aka.ms/aks-edge/k8s-msi
    K3s installer (1.29.6) aka.ms/aks-edge/k3s-msi
    K8s installer (1.28.9) aka.ms/aks-edge/k8s-msi-1.28
    K3s installer (1.28.5) aka.ms/aks-edge/k3s-msi-1.28
    K8s installer (1.27.6) aka.ms/aks-edge/k8s-msi-1.27
    K3s installer (1.27.6) aka.ms/aks-edge/k3s-msi-1.27
    Windows node files aka.ms/aks-edge/windows-node-zip
  2. In addition to the MSI, Microsoft provides samples and tools that you can download from the AKS Edge GitHub repo. Navigate to the Code tab and click the Download Zip button to download the repository as a .zip file. Extract the GitHub .zip file to a local folder.

  3. Before you install, make sure you uninstall any private preview installations and reboot your system before proceeding.

In this release, both K8s and K3s are supported. We've provided two separate MSI installers for each Kubernetes distribution. Do not install both K8s and K3s at the same time. If you want to install a different Kubernetes distribution, uninstall the existing one first, then reboot.

Important

Once a version of Kubernetes is no longer supported, downloads for associated AKS Edge Essentials releases are subject to discontinuation.

Note

You must extract the Windows node files from the zip archive into the same folder as the installer MSIs if you want to use the Windows node capability. Before you install the MSI, you can review the feature support matrix to understand the different options available.

Install AKS Edge Essentials

  1. Open PowerShell as an administrator (an elevated PowerShell), and navigate to the folder directory with the installer files.

  2. Issue the following command, and replace kXs-x.x.xxx.x with the Kubernetes distribution/version you downloaded and ran:

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi
    

    Optionally, you can specify the install directory and the vhdx directory (directory where the vhdx files for the virtual machines are stored) using INSTALLDIR and VHDXDIR. By default, these are in C:\Program Files\AksEdge:

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi INSTALLDIR=C:\Programs\AksEdge VHDXDIR=C:\vhdx
    

    Alternatively, you can double-click the AksEdge-k8s-x.x.xxx.x.msi or AksEdge-k3s-x.x.xxx.x.msi file to install the latest version.

  3. To include Windows nodes, make sure you have the MSI installer with your Kubernetes distribution of choice and the unzipped AksEdgeWindows-v1 files in the same folder. In the following command, replace kXs-x.x.xxx.x with the Kubernetes distribution/version you downloaded and ran:

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi ADDLOCAL=CoreFeature,WindowsNodeFeature
    

    OR

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi ADDLOCAL=CoreFeature,WindowsNodeFeature INSTALLDIR=C:\Programs\AksEdge VHDXDIR=C:\vhdx
    

    Now you're ready to do mixed deployment.

  4. Open another elevated PowerShell window and continue with the next step.

Check the AKS Edge Essentials modules

Once installation is complete, make sure it was successful by running the following command in an elevated PowerShell:

Set-ExecutionPolicy RemoteSigned -Scope Process -Force
Import-Module AksEdge
Get-Command -Module AKSEdge | Format-Table Name, Version

This command displays output similar to the following list:

Screenshot of installed PowerShell modules.

See the AKS Edge Essentials PowerShell cmdlets reference for a full list of supported commands.

Check device settings

You can run the Install-AksEdgeHostFeatures command to validate the Hyper-V, SSH and Power settings on the machine. This might require a system reboot:

Install-AksEdgeHostFeatures

This command displays output similar to the following list:

Screenshot showing the checks that are done.

Next steps