Azure Arc 対応 Kubernetes エージェントをアップグレードする

  • [アーティクル]

Azure Arc 対応 Kubernetes は、そのエージェントに対して自動および手動の両方のアップグレード機能を提供します。そのため、エージェントは最新バージョンにアップグレードされます。 自動アップグレードを無効にし、代わりに手動アップグレードを使用する場合、「バージョン サポート ポリシー」が Arc エージェントおよび基盤となる Kubernetes クラスターに適用されます。

クラスターを Azure Arc に接続するときに自動アップグレードのオンとオフを切り替える

Azure Arc 対応の Kubernetes は、すぐに使用できる自動アップグレード機能をエージェントに提供します。 自動アップグレードを有効にすると、エージェントは Azure を 1 時間ごとにポーリングして、新しいバージョンを確認します。 新しいバージョンが利用可能になると、Azure Arc エージェントに対し Helm chart アップグレードがトリガーされます。

Azure Arc にクラスターを接続すると、既定の設定は、自動アップグレードを有効にすることになります。

次のコマンドを使用すると、自動アップグレードを有効にして、クラスターを Azure Arc に接続できます。

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest

重要

必要なすべてのエンドポイントへの接続を許可していることを確認します。 特に、自動アップグレードには dl.k8s.io への接続が必要です。

自動アップグレードをオプト アウトするには、クラスターを Azure Arc に接続するときに、--disable-auto-upgrade パラメーターを指定します。

次のコマンドを使用すると、自動アップグレードを無効にして、クラスターを Azure Arc に接続できます。

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest --disable-auto-upgrade

ヒント

自動アップグレードを無効にする予定の場合は、Azure Arc 対応 Kubernetes の「バージョン サポート ポリシー」に注意してください。

クラスターを Azure Arc に接続した後に自動アップグレードのオンとオフを切り替える

クラスターを Azure Arc に接続した後、 az connectedk8s update コマンドを使用して、 --auto-upgrade を true または false に設定することで、自動アップグレードの選択を変更できます。

次のコマンドを実行すると、接続されているクラスターの自動アップグレードがオフになります。

az connectedk8s update --name AzureArcTest1 --resource-group AzureArcTest --auto-upgrade false

エージェントを手動でアップグレードする

自動アップグレードを無効にした場合は、 az connectedk8s upgrade コマンドを使用してエージェントのアップグレードを手動で開始できます。 その場合は、アップグレードするバージョンを指定する必要があります。

Azure Arc 対応 Kubernetes エージェントは、MAJOR.MINOR.PATCH の標準のセマンティック バージョン管理スキームに従ってバージョン管理されています。 バージョンのそれぞれの数字は、前のバージョンとの一般的な互換性を示します。

  • メジャー バージョンは、API が更新され互換性がなくなった場合や、下位互換性がなくなると変更されます。
  • マイナー バージョンは、機能変更に対し、他のマイナー リリースが下位互換となるときに変更されます。
  • 修正プログラムのバージョンは、下位互換性のあるバグ修正が行われたときに変更されます。

スケジュールは異なる場合がありますが、Azure Arc 対応の Kubernetes エージェントの新しいマイナー バージョンは、1 か月に 1 回程度リリースされます。

次のコマンドは、エージェントをバージョン 1.8.14 に手動でアップグレードします。

az connectedk8s upgrade -g AzureArcTest1 -n AzureArcTest --agent-version 1.8.14

エージェント バージョンを確認する

接続されたクラスターと報告されたエージェントのバージョンを一覧表示するには、次のコマンドを使用します。

az connectedk8s list --query '[].{name:name,rg:resourceGroup,id:id,version:agentVersion}'

クラスターで自動アップグレードが有効になっているかどうかを確認する

クラスターで自動アップグレードが有効になっているかどうかを確認するには、次の kubectl コマンドを実行します。 自動アップグレードの構成は、Azure Arc 対応 Kubernetes のパブリック API では使用できないことに注意してください。

kubectl -n azure-arc get cm azure-clusterconfig -o jsonpath="{.data['AZURE_ARC_AUTOUPDATE']}"

バージョンのサポート ポリシー

Azure Arc 対応 Kubernetes にサポート リクエストを作成した場合、次のバージョンのサポート ポリシーが適用されます。

  • Azure Arc 対応 Kubernetes エージェントのサポート期間は、"N-2" です。ここで、 'N' はエージェントの最新のマイナー リリースです。

    • たとえば、Azure Arc 対応 Kubernetes の 0.28.a が今日導入される場合、サポートされるバージョンは、0.28.a、0.28.b、0.27.c、0.27.d、0.26.e、0.26.f になります。

  • Azure Arc に接続されている Kubernetes クラスターのサポート期間は、"N-2" になります (この場合の 'N' はアップストリーム Kubernetes の最新の安定マイナー リリースです)。

    • たとえば、Kubernetes の 1.20.a が今日導入される場合、サポートされるバージョンは、1.20.a、1.20.b、1.19.c、1.19.d、1.18.e、1.18.f になります。

サポート リクエストを作成し、サポート ポリシー外のバージョン (エージェントおよび上流の Kubernetes クラスターの "N-2" サポート バージョンよりも古いバージョン) を使用している場合は、クラスターとエージェントをサポートされているバージョンにアップグレードするように求められます。

次のステップ