通过

在 Windows 上的 Azure Stack Hub 中安装 AKS 引擎

  • 项目

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 资源和软件。 然后，可以使用运行引擎的计算机在群集上执行管理任务。

选择客户端计算机时，请考虑：

  1. 当发生灾难时，该客户端计算机是否应当可恢复。
  2. 如何连接到该客户端计算机以及该计算机如何与群集交互？

在联网环境中安装 AKS 引擎

可以安装客户端 VM 以在连接到 Internet 的 Azure Stack Hub 上管理 Kubernetes 群集。

  1. 在 Azure Stack Hub 中创建 Windows VM。 有关说明，请参阅快速入门：使用 Azure Stack Hub 门户创建 Windows 服务器 VM。

  2. 连接到 VM。

  3. 使用 PowerShell 说明安装 Chocolatey。

    根据 Chocolatey 网站：Chocolatey 是 Windows 的包管理器，类似于 apt-get 或 yum，但适用于 Windows。 它设计为一个分散的框架，用于快速安装所需的应用程序和工具。 它建立在 NuGet 基础结构上，目前使用 PowerShell 作为将包从发行版传送到门、错误、计算机的重点。

  4. 安装 Azure CLI。 选择下载链接，然后选择“运行”。 根据需要选择设置步骤。

  5. 在 AKS 引擎和 Azure Stack 版本映射表中查找 AKS 引擎的版本。 必须在 Azure Stack Hub 市场中提供 AKS 基础引擎。 运行该命令时，必须指定版本 --version v0.xx.x。 如果不指定版本，该命令会安装最新版，这样可能就会需要市场中未提供的 VHD 映像。

    注意

    可以在 AKS 引擎发行说明中找到 Azure Stack Hub 到 AKS 引擎版本号的映射。

  6. 从提升的提示符运行以下命令，并添加版本号：

    注意

    对于 AKSe 0.75.3 和更高版本，用于安装 AKS 引擎的命令是 choco install aks-engine-azurestack。

        choco install aks-engine --version 0.xx.x -y

    注意

    如果此安装方法失败，你可以尝试在离线环境中执行以下步骤。

在离线环境中安装 AKS 引擎

可以安装客户端 VM 以在与 Internet 断开连接的 Azure Stack Hub 上管理 Kubernetes 群集。

  1. 从可访问 Internet 的计算机，转到 GitHub Azure/aks-engine 。 下载 Windows 计算机的存档 (*.tar.gz)，例如 aks-engine-v0.xx.x-windows-amd64.tar.gz。 在受支持的 Kubernetes 版本表中查找 AKS 引擎的版本。

  2. 在 Azure Stack Hub 实例中创建存储帐户，以便使用 AKS 引擎二进制文件上传存档文件 (*.tar.gz)。 有关使用 Azure 存储资源管理器的说明，请参阅 Azure 存储资源管理器与 Azure Stack Hub。

  3. 在 Azure Stack Hub 中创建 Windows VM。 有关说明，请参阅快速入门：使用 Azure Stack Hub 门户创建 Windows 服务器 VM

  4. 从上传存档文件 (*.tar.gz) 所在的 Azure Stack Hub 存储帐户 Blob URL，将文件下载到管理 VM。 从命令提示符将存档提取到你有权访问的目录。

  5. 连接到 VM。

  6. 使用 PowerShell 说明安装 Chocolatey。

  7. 在提升的提示符下运行以下命令。 包括正确的版本号：

    注意

    对于 AKSe 0.75.3 和更高版本，用于安装 AKS 引擎的命令是 choco install aks-engine-azurestack。

        choco install aks-engine --version 0.xx.x -y

验证安装

设置客户端 VM 后，请检查是否已安装了 AKS 引擎。

  1. 连接到客户端 VM。

  2. 运行以下命令：

    注意

    对于 AKSe 0.75.3 及更高版本，用于检查当前版本的 AKS 引擎的命令是 aks-engine-azurestack version。

    aks-engine version

如果无法验证是否已在客户端 VM 上安装了 AKS 引擎，请参阅 AKS 引擎安装故障排除。

ASDK 安装

在 ASDK 外的计算机的 ASDK 上运行 AKS 引擎的客户端 VM 时，需要添加证书。 如果你在 ASDK 环境中使用 Windows VM，则计算机已信任 ASDK 证书。 如果客户端计算机在 ASDK 之外，则需要从 ASDK 中提取证书，并将其添加到 Windows 计算机。

在使用 ASDK 时，如果 Azure 资源管理器终结点使用自签名证书，你需要将此证书显式添加到计算机的受信任证书存储。 可以在 ASDK 中部署的任何 VM 中找到 ASDK 根证书。

  1. 导出 CA 根证书。 有关说明，请参阅导出 Azure Stack Hub CA 根证书。
  2. 信任 Azure Stack Hub CA 根证书。 有关说明，请参阅信任 Azure Stack Hub CA 根证书。

后续步骤

使用 Azure Stack Hub 上的 AKS 引擎部署 Kubernetes 群集