在 Azure Stack Hub 的 Windows 上安裝 AKS 引擎

發行項
12/01/2023

Github 上提供最新版 AKS 引擎的二進位下載。下載作業系統的套件，並擷取 AKS 引擎 0.73.0 版和以下版本的 aks-engine 檔案。針對 AKS 引擎 0.75.3 版和更新版本，請擷取 aks-engine-azurestack 檔案 (，並選擇性地將其新增至 $PATH 環境變數，以取得更方便的 CLI 使用方式) 。

準備用戶端 VM

AKS 引擎是一種命令列工具，可用來部署和管理 Kubernetes 叢集。您可以在 Azure Stack Hub 的機器上執行引擎。從這部電腦執行 AKS 引擎，以部署執行叢集所需的 IaaS 資源和軟體。然後，您可以使用執行引擎的機器，在叢集上執行管理工作。

在選擇用戶端機器時，請考慮：

用戶端電腦是否應該在災害中復原。
如何連線到用戶端電腦，以及機器如何與您的叢集互動？

在連線的環境中安裝 AKS 引擎

您可以安裝用戶端 VM 以在連線到網際網路的 Azure Stack Hub 上管理 Kubernetes 叢集。

在 Azure Stack Hub 中建立 Windows VM。如需指示，請參閱快速入門：使用 Azure Stack Hub 入口網站建立 Windows 伺服器 VM。
連線到您的 VM。
使用 PowerShell 指示來安裝 Chocolatey。

根據 Chocolatey 網站：Chocolatey 是適用於 Windows 的套件管理員，例如 apt-get 或 yum，但適用於 Windows。其設計目的是要作為分散式架構，以供快速安裝所需的應用程式和工具。其目前使用 PowerShell 建置於 NuGet 基礎結構上，以作為其焦點來將套件從散發版本傳遞至您的 door、err、computer。
安裝 Azure CLI。選取下載連結，然後選擇 [執行]。視需要選擇設定步驟。
在 AKS 引擎和 Azure Stack 版本對應表的資料表中，尋找 AKS 引擎的版本。 AKS 基底引擎必須可在 Azure Stack Hub Marketplace 中取得。執行命令時，您必須指定版本 --version v0.xx.x。如果您未指定版本，命令會安裝最新版本，這可能需要市集中無法使用的 VHD 映射。

注意

您可以在 AKS 引擎版本資訊中，找到 Azure Stack Hub 與 AKS 引擎版本號碼的對應。
從提升權限的提示字元中執行下列命令，並包含版本號碼：

注意

針對 AKSe 0.75.3 版和更新版本，安裝 AKS 引擎的命令為 choco install aks-engine-azurestack 。
```
    choco install aks-engine --version 0.xx.x -y
```
注意

如果這個安裝方法失敗，您可以嘗試以下中斷連線環境的步驟。

在中斷連線的環境中安裝 AKS 引擎

您可以安裝用戶端 VM 以在已與網際網路中斷連線的 Azure Stack Hub 上管理 Kubernetes 叢集。

從可存取網際網路的機器，移至 GitHub Azure/aks-engine。下載 Windows 機器的封存 (*.tar.gz)，例如 aks-engine-v0.xx.x-windows-amd64.tar.gz。在支援的 Kubernetes 版本資料表中尋找 AKS 引擎的版本。
在 Azure Stack Hub 執行個體中建立儲存體帳戶，以使用 AKS 引擎二進位檔上傳封存檔案 (*.tar.gz)。如需使用 Azure 儲存體總管的指示，請參閱 Azure 儲存體總管與 Azure Stack Hub。
在 Azure Stack Hub 中建立 Windows VM。如需指示，請參閱快速入門：使用 Azure Stack Hub 入口網站建立 Windows 伺服器 VM
從作為封存檔案 (*.tar.gz) 上傳目的地的 Azure Stack Hub 儲存體帳戶 Blob URL 中，將檔案下載至您的管理 VM。從命令提示字元將封存解壓縮至您可以存取的目錄。
連線到您的 VM。
使用 PowerShell 指示來安裝 Chocolatey。
從提高權限的提示字元中執行下列命令。包含正確的版本號碼：

注意

針對 AKSe 0.75.3 版和更新版本，安裝 AKS 引擎的命令為 choco install aks-engine-azurestack 。
```
    choco install aks-engine --version 0.xx.x -y
```

驗證安裝

設定好用戶端 VM 之後，請檢查您是否已安裝 AKS 引擎。

連線到您的用戶端 VM。
執行以下命令：

注意

針對 AKSe 0.75.3 版和更新版本，檢查您 AKS 引擎的目前版本為的命令。 aks-engine-azurestack version
```
aks-engine version
```

如果您無法確認已在用戶端 VM 上安裝 AKS 引擎，請參閱針對 AKS 引擎安裝進行疑難排解。

ASDK 安裝

在 ASDK 外部的電腦上執行 AKS 引擎的用戶端 VM 時，您必須新增憑證。如果您在 ASDK 環境內使用 Windows VM，則機器已信任 ASDK 憑證。如果用戶端機器在 ASDK 之外，則必須從 ASDK 擷取該憑證，並將其新增至 Windows 機器。

當您使用 ASDK 時，Azure Resource Manager 端點會使用自我簽署憑證，您需要明確地將此憑證新增至機器的受信任憑證存放區。您可以在部署於 ASDK 的任何 VM 中，尋找 ASDK 的根憑證。

匯出 CA 根憑證。如需指示，請參閱匯出 Azure Stack Hub CA 根憑證。
信任 Azure Stack Hub CA 根憑證。如需指示，請參閱信任 Azure Stack Hub CA 根憑證。

後續步驟

在 Azure Stack Hub 上使用 AKS 引擎部署 Kubernetes 叢集