使用 PowerShell 在 Arc 啟用的 AKS 中升級 AKS 主機
適用於：Azure Stack HCI 22H2 上的 AKS、Windows Server 上的 AKS
本文說明如何在 Azure Arc 所啟用的 AKS 中更新 Azure Kubernetes Service 主機。
AKS 主機更新概觀
AKS 主機的更新一律包含最新的可用版本。 雖然您可以獨立於工作負載叢集更新來更新主機，但您一律必須在更新工作負載叢集之前更新主機。
為避免 AKS 可用性中斷和遺失，會執行滾動更新。 當您將具有較新組建的新節點帶入叢集時，資源會從舊節點移至新節點。 當您成功移除資源時，舊的節點會解除委任，並從叢集移除。
注意
Microsoft建議在新版本的 30 天內升級您的 AKS 叢集。 如果您未在此視窗中更新，在內部憑證和令牌到期之前，您最多有 90 天的時間從上次升級開始。 憑證和令牌到期后，叢集仍可運作;不過，您必須呼叫 Microsoft 支援服務 才能升級。 當您在90天期間之後重新啟動叢集時，它會保持非功能狀態。 如需內部憑證和令牌的詳細資訊，請參閱 憑證管理概觀。
更新 AKS 主機
任何更新流程中的第一個步驟是執行 Update-AksHci 命令來更新 AKS 主機。 Update-AksHci 不會採用自變數，且一律會將管理叢集更新為最新版本。 您必須在執行 Update-AksHciCluster 之前起始此步驟，才能將 Kubernetes 叢集更新為新版本。
重要
只有在您已安裝 GA 版本或更新版本時，更新命令才能運作。 不適用於舊版。 此更新命令會更新 AKS 主機和內部部署Microsoft運作的雲端平臺。 此命令不會更新任何現有的 AKS 工作負載叢集。 更新 AKS 主機之後所建立的新 AKS 工作負載叢集可能會與其操作系統版本和 Kubernetes 版本中的現有 AKS 工作負載叢集不同。
建議您在更新 AKS 主機之後立即更新 AKS 工作負載叢集，以取得最新的作業系統版本和最近的修正。 如果工作負載叢集位於下一版 AKS Arc 中不支援的 Kubernetes 版本上，升級會失敗。
更新 AKS 主機的範例流程
更新 PowerShell 模組
在 AKS 部署的所有實體節點上執行下列命令，確定您一律已安裝在 AKS 節點上的最新 PowerShell 模組。
重要
您應該關閉所有開啟的 PowerShell 視窗，然後開啟新的工作階段來執行更新命令。 如果您未關閉所有 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 | 組建類型：公開組建的Always 1。 |
| 0723 | 組建建立日期：以 mmdd 格式建置建立日期。 |
起始 AKS Arc 更新
Update-AksHci
確認 AKS 主機已更新
Get-AksHciVersion
輸出會顯示 AKS 主機上已更新的 AKS 版本：
1.0.2.10723