使用 PowerShell 升级由 Arc 启用的 AKS 中的 AKS 主机

适用于:Azure Stack HCI 22H2 上的 AKS、Windows Server 上的 AKS

本文介绍如何更新由 Azure Arc 启用的 AKS 中的 Azure Kubernetes 服务 主机。

AKS 主机更新概述

汇报 AKS 主机始终包含最新的可用版本。 尽管可以独立于工作负荷群集更新来更新主机,但在更新工作负荷群集之前,必须始终更新主机。

为了避免中断和 AKS 可用性丢失,将执行滚动更新。 将具有较新版本的新节点引入群集时,资源会从旧节点移动到新节点。 成功删除资源后,旧节点将解除授权并从群集中删除。

注意

Microsoft 建议在新版本发布后的 30 天内升级 AKS 群集。 如果未在此时段内更新,则自上次升级起最多有 90 天,内部证书和令牌过期。 证书和令牌过期后,群集仍可正常运行;但是,必须调用 Microsoft 支持部门 进行升级。 在 90 天之后重新启动群集时,它将保持不工作状态。 有关内部证书和令牌的详细信息,请参阅 证书管理概述

更新 AKS 主机

任何更新流中的第一步是运行 Update-AksHci 命令来更新 AKS 主机。 Update-AksHci 命令不采用任何参数,始终会将管理群集更新到最新版本。 必须在运行 Update-AksHciCluster 将 Kubernetes 群集更新到新版本之前执行此步骤。

重要

仅当安装了正式版或更高版本时,update 命令才起作用。 它不适用于早期版本。 此更新命令更新 AKS 主机和本地 Microsoft 运营的云平台。 此命令不会更新任何现有的 AKS 工作负载群集。 更新 AKS 主机后创建的新 AKS 工作负载群集可能与 OS 版本和 Kubernetes 版本中的现有 AKS 工作负载群集不同。

建议在更新 AKS 主机后立即更新 AKS 工作负载群集,获取最新的 OS 版本和最新的修补程序。 如果工作负载群集位于下一个版本的 AKS Arc 中不受支持的 Kubernetes 版本上,则升级将失败。

更新 AKS 主机的示例流

更新 PowerShell 模块

通过在 AKS 部署中的所有物理节点上运行以下命令,确保始终在 AKS 节点上安装最新的 PowerShell 模块。

重要

应关闭所有打开的 PowerShell 窗口,然后打开全新会话来运行 update 命令。 如果未关闭所有 PowerShell 窗口,则可能是存在正在使用且无法更新的模块。

Update-Module -Name AksHci -Force -AcceptLicense

获取当前 AKS Arc 版本

Get-AksHciVersion                    
1.0.0.10517

获取可用的 AKS Arc 更新

Get-AksHciUpdates

输出显示此 AKS 主机可更新到的可用版本:

1.0.2.10723

版本控制

下表以版本 1.0.2.10723 为例,显示了如何为 AKS Arc 版本构造版本号。

含义
1 主版本:对于具有重大中断性变更的每个版本为 +1。
0 次要版本:在具有主要功能更改的最新主版本之后,每个版本 +1。
2 功能 & 修补程序更新:每个常规 (通常每月) 最新主版本之后发布一次,为 +1。
1 生成类型:对于面向公众的生成,始终为 1。
0723 生成创建日期:mmdd 格式的生成创建日期。

启动 AKS Arc 更新

Update-AksHci

验证 AKS 主机是否已更新

Get-AksHciVersion

输出显示 AKS 主机上 AKS 的更新版本:

1.0.2.10723

后续步骤