準備適用於 AKS Edge Essentials 的電腦

發行項
09/26/2024

本文說明如何設定 Azure Kubernetes Service （AKS） Edge Essentials 節點計算機。

必要條件

請參閱系統需求。
OS 需求：在您的計算機上安裝 Windows 10/11 IoT 企業版/企業版/專業版並啟用 Windows。我們建議使用最新的用戶端版本 22H2（OS 組建 19045）或 Server 2022（OS 組建 20348）。您可以在這裡下載 Windows 10 版本或 Windows 11。

注意

如果您要進行離線安裝，或您的電腦正在公司環境中執行，且安全策略可能限制因特網連線，請務必檢查 AKS Edge Essentials 離線安裝。

下載 AKS 邊緣程式集

您可以在單一機器或多部計算機上部署 AKS Edge Essentials 叢集。在多部計算機部署中，其中一部機器是具有 Kubernetes 控制節點的主要計算機，而其他電腦則是控制節點或背景工作角色節點的次要機器。您必須在主要和次要計算機上安裝 AKS Edge Essentials，如下所示。安裝 AKS Edge Essentials 之後，當您建立 Kubernetes 叢集時，您會將一部電腦識別為主要電腦，而其餘計算機則是次要機器。

在您的計算機上，視您想要使用的 Kubernetes 散發套件而定，下載 AksEdge-k3s.msi 或 AksEdge-k8s.msi 檔案。此外，如果您要建立 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 安裝程式。請勿同時安裝 K8 和 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 節點，請確定您有 MSI 安裝程式，其中包含您選擇的 Kubernetes 散發套件，以及相同資料夾中解壓縮 的 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

這個指令會顯示類似下列清單的輸出：

顯示已完成檢查的螢幕快照。

共用方式為