PowerShell を使用して Arc で有効になっている AKS の AKS ホストをアップグレードする

適用対象: AKS on Azure Stack HCI 22H2、AKS on Windows Server

この記事では、Azure Arc で有効になっている AKS でAzure Kubernetes Service ホストを更新する方法について説明します。

AKS ホスト更新プログラムの概要

AKS ホストへの更新には、常に利用可能な最新バージョンが含まれます。 ワークロード クラスターの更新とは別にホストを更新できますが、ワークロード クラスターを更新する前に常にホストを更新する必要があります。

AKS の可用性の停止と損失を回避するために、ローリング更新が実行されます。 新しいビルドの "新しい"ノードをクラスターに追加すると、リソースは "古い" ノードから "新しい" ノードに移動します。 リソースが正常に移動されると、古いノードは使用が停止され、クラスターから削除されます。

注意

Microsoft では、新しいリリースから 30 日以内に AKS クラスターをアップグレードすることをお勧めします。 このウィンドウ内で更新しない場合は、内部証明書とトークンの有効期限が切れる前に、前回のアップグレードから最大 90 日が経過します。 証明書とトークンの有効期限が切れると、クラスターは引き続き機能します。ただし、アップグレードするにはMicrosoft サポートを呼び出す必要があります。 90 日の期間が経過した後にクラスターを再起動しても、非機能状態のままです。 内部証明書とトークンの詳細については、 証明書管理の概要に関するページを参照してください。

AKS ホストを更新する

更新フローの最初の手順は、 Update-AksHci コマンドを実行して AKS ホストを更新することです。 Update-AksHci は引数を必要とせず、常に管理クラスターを最新バージョンに更新します。 Update-AksHciCluster を実行して Kubernetes クラスターを新しいバージョンに更新する前に、この手順を開始する必要があります。

重要

update コマンドは、GA リリース以降がインストールされている場合にのみ機能します。 以前のリリースでは機能しません。 この更新コマンドは、AKS ホストとオンプレミスの Microsoft が運用するクラウド プラットフォームを更新します。 このコマンドによって既存の AKS ワークロード クラスターは更新されません。 AKS ホストを更新した後に作成された新しい AKS ワークロード クラスターは、OS バージョンと Kubernetes バージョンの既存の AKS ワークロード クラスターとは異なる場合があります。

AKS ホストを更新した直後に AKS ワークロード クラスターを更新して、最新の OS バージョンと最近の修正プログラムを取得することをお勧めします。 ワークロード クラスターが次のバージョンの AKS Arc でサポートされていない Kubernetes バージョンにある場合、アップグレードは失敗します。

AKS ホストを更新するためのフローの例

Azure PowerShell モジュールの更新

AKS デプロイ内のすべての物理ノードで次のコマンドを実行して、常に最新の PowerShell モジュールが AKS ノードにインストールされていることを確認します。

重要

開いているすべての 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

次の手順