クラスターのハイブリッドノードをアップグレードする

ハイブリッドノードを接続する 手順に従って、新しいホストをハイブリッドノードとして接続します。nodeadm install コマンドを実行するときは、ターゲット Kubernetes バージョンを使用します。

ターゲット Kubernetes バージョンの新しいハイブリッドノードと古い Kubernetes バージョンのハイブリッドノード間の通信を有効にします。この設定により、ターゲット Kubernetes バージョンのハイブリッドノードにワークロードを移行している間に、ポッドが相互に通信できるようになります。

ターゲット Kubernetes バージョンのハイブリッドノードがクラスターに正常に参加しており、ステータスが Ready (準備完了) であることを確認します。

以下のコマンドを使用して、NoSchedule で削除する各ノードをテイントに設定します。これは、置き換えるノード上で新しいポッドがスケジュールまたは再スケジュールされないようにするためです。詳細については、Kubernetes ドキュメントの「テイントと容認」を参照してください。NODE_NAME を古い Kubernetes バージョンのハイブリッドノードの名前に置き換えます。

kubectl taint nodes NODE_NAME key=value:NoSchedule

以下のコードスニペットを使用して、特定の Kubernetes バージョン (この場合は 1.28) のすべてのノードを識別してテイントできます。

K8S_VERSION=1.28
nodes=$(kubectl get nodes -o jsonpath="{.items[?(@.status.nodeInfo.kubeletVersion==\"v$K8S_VERSION\")].metadata.name}")
for node in ${nodes[@]}
do
    echo "Tainting $node"
    kubectl taint nodes $node key=value:NoSchedule
done

現在のデプロイメントで、ハイブリッドノードで実行している CoreDNS レプリカが 2 つ未満の場合は、そのデプロイメントを少なくとも 2 つのレプリカにスケールアウトします。通常のオペレーションでは、回復力を高めるために、ハイブリッドノードで少なくとも 2 つの CoreDNS レプリカを実行することをお勧めします。

kubectl scale deployments/coredns --replicas=2 -n kube-system

次のコマンドを使用して、クラスターから削除する古い Kubernetes バージョンのハイブリッドノードをそれぞれドレインします。ノードドレインのドレイン処理に関する詳細については、Kubernetes ドキュメントの「Safely Drain a Node」を参照してください。NODE_NAME を古い Kubernetes バージョンのハイブリッドノードの名前に置き換えます。

kubectl drain NODE_NAME --ignore-daemonsets --delete-emptydir-data

以下のコードスニペットを使用して、特定の Kubernetes バージョン (この場合は 1.28) のすべてのノードを識別してドレインすることができます。

K8S_VERSION=1.28
nodes=$(kubectl get nodes -o jsonpath="{.items[?(@.status.nodeInfo.kubeletVersion==\"v$K8S_VERSION\")].metadata.name}")
for node in ${nodes[@]}
do
    echo "Draining $node"
    kubectl drain $node --ignore-daemonsets --delete-emptydir-data
done

nodeadm を使用して、ホストからハイブリッドノードアーティファクトを停止および削除できます。root/sudo 権限を持つユーザーで nodeadm を実行する必要があります。デフォルトでは、ノードにポッドが残っている場合、nodeadm uninstall は続行されません。詳細については「ハイブリッドノード nodeadm 参照」を参照してください。

nodeadm uninstall

ハイブリッドノードのアーティファクトを停止およびアンインストールしたら、クラスターからノードリソースを削除します。

kubectl delete node node-name
            

次のコードスニペットを使用して、特定の Kubernetes バージョン (この場合は 1.28) のすべてのノードを識別および削除できます。

K8S_VERSION=1.28
nodes=$(kubectl get nodes -o jsonpath="{.items[?(@.status.nodeInfo.kubeletVersion==\"v$K8S_VERSION\")].metadata.name}")
for node in ${nodes[@]}
do
    echo "Deleting $node"
    kubectl delete node $node
done

CNI の選択によっては、上記のステップを実行した後にハイブリッドノードにアーティファクトが残っている場合があります。詳細については「ハイブリッドノードの CNI を設定する」を参照してください。

NoSchedule でアップグレードするノードをテイントするには、次のコマンドを使用します。これは、アップグレードするノード上で新しいポッドがスケジュールまたは再スケジュールされないようにするためです。詳細については、Kubernetes ドキュメントの「テイントと容認」を参照してください。NODE_NAME をアップグレードするハイブリッドノードの名前に置き換える

kubectl taint nodes NODE_NAME key=value:NoSchedule

次のコマンドを使用して、アップグレードするノードをドレインします。ノードドレインのドレイン処理に関する詳細については、Kubernetes ドキュメントの「Safely Drain a Node」を参照してください。NODE_NAME をアップグレードするハイブリッドノードの名前に置き換えます。

kubectl drain NODE_NAME --ignore-daemonsets --delete-emptydir-data

アップグレードするハイブリッドノードで nodeadm upgrade を実行します。root/sudo 権限を持つユーザーで nodeadm を実行する必要があります。ノードの名前は、AWS SSM と AWS IAM Roles Anywhere の両方の認証情報プロバイダーのアップグレードによって保持されます。アップグレードプロセス中に認証情報プロバイダーを変更することはできません。nodeConfig.yaml の設定値については、「ハイブリッドノード nodeadm 参照」を参照してください。K8S_VERSION を、アップグレード先のターゲット Kubernetes バージョンに置き換えます。

nodeadm upgrade K8S_VERSION -c file://nodeConfig.yaml

アップグレード後にノード上で Pod をスケジュールできるように、以下を入力します。NODE_NAME をノードの名前に置き換えます。

kubectl taint nodes NODE_NAME key=value:NoSchedule-
kubectl uncordon NODE_NAME

ハイブリッドノードのステータスを監視し、ノードがシャットダウンするのを待ち、Ready (準備完了) ステータスになったら新しい Kubernetes バージョンで再起動します。

kubectl get nodes -o -w