为 AKS Edge Essentials 准备计算机

项目
09/04/2024

本文介绍如何设置 Azure Kubernetes 服务（AKS） Edge Essentials 节点计算机。

先决条件

请参阅系统要求。
OS 要求：在计算机上安装 Windows 10/11 IoT 企业版/企业版/专业版并激活 Windows。建议使用最新的客户端版本 22H2（OS 内部版本 19045）或 Server 2022（OS 内部版本 20348）。可以在此处下载 Windows 10 版本或此处的 Windows 11。

注意

如果正在执行脱机安装，或者计算机正在企业环境中运行，并且其安全策略可能会限制 Internet 连接，请确保检查 AKS Edge Essentials 脱机安装。

下载 AKS 边缘软件包

可以在单个计算机或多台计算机上部署 AKS Edge Essentials 群集。在多计算机部署中，其中一台计算机是具有 Kubernetes 控制节点的主计算机，另一台计算机是控制节点或辅助角色节点的辅助计算机。必须在主计算机和辅助计算机上安装 AKS Edge Essentials，如下所示。安装 AKS Edge Essentials 后，创建 Kubernetes 群集时，会将一台计算机标识为主要计算机，其余计算机标识为辅助计算机。

在计算机上下载 AksEdge-k3s.msi 或 AksEdge-k8s.msi 文件，具体取决于要使用的 Kubernetes 分发版。此外，如果要创建 Windows 工作器节点，则需要 Windows 节点文件。

文件	链接。
K8s 安装程序（1.29.4）	aka.ms/aks-edge/k8s-msi
K3s 安装程序（1.29.6）	aka.ms/aks-edge/k3s-msi
K8s 安装程序（1.28.9）	aka.ms/aks-edge/k8s-msi-1.28
K3s 安装程序（1.28.5）	aka.ms/aks-edge/k3s-msi-1.28
K8s 安装程序（1.27.6）	aka.ms/aks-edge/k8s-msi-1.27
K3s 安装程序（1.27.6）	aka.ms/aks-edge/k3s-msi-1.27
Windows 节点文件	aka.ms/aks-edge/windows-node-zip

除了 MSI，Microsoft还提供可从 AKS Edge GitHub 存储库下载的示例和工具。导航到“代码”选项卡，然后单击“下载 Zip”按钮以.zip文件的形式下载存储库。将 GitHub .zip 文件提取到本地文件夹。
在安装之前，请确保先卸载任何专用预览版安装并重新启动系统，然后再继续。

在此版本中，支持 K8 和 K3。我们为每个 Kubernetes 分发提供了两个单独的 MSI 安装程序。不要同时安装 K8s 和 K3。如果要安装其他 Kubernetes 分发版，请先卸载现有分发版，然后重新启动。

重要

不再支持 Kubernetes 版本后，关联的 AKS Edge Essentials 版本的下载将停止。

注意

如果要使用 Windows 节点功能，则必须将 Windows 节点文件从 zip 存档提取到与安装程序 MSIs 相同的文件夹中。在安装 MSI 之前，可以查看功能支持矩阵以了解可用的不同选项。

安装 AKS Edge Essentials

以管理员身份打开 PowerShell（提升的 PowerShell），并使用安装程序文件导航到文件夹目录。
发出以下命令，并替换为 kXs-x.x.xxx.x 下载并运行的 Kubernetes 分发/版本：
```
msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi
```
（可选）可以指定安装目录和 vhdx 目录（其中存储了虚拟机的 vhdx 文件的目录） INSTALLDIR 和 VHDXDIR。默认情况下，这些内容位于 C:\Program Files\AksEdge：
```
msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi INSTALLDIR=C:\Programs\AksEdge VHDXDIR=C:\vhdx
```
或者，可以双击 AksEdge-k8s-x.x.xxx.x.msi 或 AksEdge-k3s-x.x.xxx.x.msi 文件以安装最新版本。
若要包含 Windows 节点，请确保具有具有所选 Kubernetes 分发的 MSI 安装程序，以及同一文件夹中未 解压缩的 AksEdgeWindows-v1 文件。在以下命令中，替换为 kXs-x.x.xxx.x 下载并运行的 Kubernetes 分发/版本：
```
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
```
现在，你已准备好执行混合部署。
打开另一个提升的 PowerShell 窗口，并继续执行下一步。

检查 AKS Edge Essentials 模块

安装完成后，通过在提升的 PowerShell 中运行以下命令来确保成功：

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

此命令显示类似于以下列表的输出：

已安装的 PowerShell 模块的屏幕截图。

有关受支持命令的完整列表，请参阅 AKS Edge Essentials PowerShell cmdlet 参考。

检查设备设置

可以运行以下命令 Install-AksEdgeHostFeatures 来验证计算机上的 Hyper-V、SSH 和电源设置。这可能需要系统重启：

Install-AksEdgeHostFeatures