アプリケーションを新しいノードグループに移行する

my-cluster をクラスター名に置き換えて、既存のノードグループの名前を取得します。

eksctl get nodegroups --cluster=my-cluster

出力例は次のとおりです。

CLUSTER      NODEGROUP          CREATED               MIN SIZE      MAX SIZE     DESIRED CAPACITY     INSTANCE TYPE     IMAGE ID
default      standard-nodes   2019-05-01T22:26:58Z  1             4            3                    t3.medium         ami-05a71d034119ffc12

次のコマンドを使用して、eksctl で新しいノードグループを起動します。コマンドのすべてのサンプル値を独自の値に置き換えます。バージョン番号は、お使いのコントロールプレーンの Kubernetes バージョンよりも新しいものにすることはできません。また、コントロールプレーンの Kubernetes バージョンより 3 つ以上前のマイナーバージョンにすることもできません。コントロールプレーンと同じバージョンを使用することをお勧めします。

次の条件が true の場合、IMDS への Pod アクセスをブロックすることをお勧めします。

eksctl create nodegroup \
  --cluster my-cluster \
  --version 1.30 \
  --name standard-nodes-new \
  --node-type t3.medium \
  --nodes 3 \
  --nodes-min 1 \
  --nodes-max 4 \
  --managed=false

前のコマンドが完了したら、次のコマンドを使用して、すべてのノードが Ready 状態になったことを確認します。

kubectl get nodes

次のコマンドを使用して、元のノードグループを削除します。このコマンドで、すべてのサンプル値を自分のクラスター名とノードグループ名に置き換えます。

eksctl delete nodegroup --cluster my-cluster --name standard-nodes-old

新しいノードグループを起動するには、「セルフマネージド Amazon Linux ノードを作成する」で説明されている手順に従います。

スタックの作成が完了したら、コンソールで選択し、[出力] を選択します。

作成されたノードグループの NodeInstanceRole を記録します。Amazon EKS ノードをクラスターに追加するには、これが必要です。

相互通信できるように、両方のノードグループのセキュリティグループを更新します。詳細については、「クラスターの Amazon EKS セキュリティグループ要件を表示する」を参照してください。

aws-auth configmap を編集して、新しいノードインスタンスロールを RBAC にマッピングします。

kubectl edit configmap -n kube-system aws-auth

新しいノードグループの新しい mapRoles エントリを追加します。

apiVersion: v1
data:
  mapRoles: |
    - rolearn: ARN of instance role (not instance profile)
      username: system:node:{{EC2PrivateDNSName}}
      groups:
        - system:bootstrappers
        - system:nodes>
    - rolearn: arn:aws:iam::111122223333:role/nodes-1-16-NodeInstanceRole-U11V27W93CX5
      username: system:node:{{EC2PrivateDNSName}}
      groups:
        - system:bootstrappers
        - system:nodes

インスタンスロールの ARN (インスタンスプロファイルではない) スニペットを、前の手順で記録した NodeInstanceRole の値に置き換えます。次に、更新された configmap を適用するには、ファイルを保存して閉じます。

ノードのステータスを監視し、新しいノードがクラスターに結合され、Ready ステータスになるまで待機します。

kubectl get nodes --watch

(オプション) Kubernetes Cluster Autoscaler を使用している場合は、スケーリングアクションの競合を回避するために、デプロイをゼロ (0) レプリカにスケールダウンします。

kubectl scale deployments/cluster-autoscaler --replicas=0 -n kube-system

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

kubectl taint nodes node_name key=value:NoSchedule

ノードを新しい Kubernetes バージョンにアップグレードする場合は、次のコードスニペットを使用して、特定の Kubernetes バージョン (この場合は 1.28) のすべてのノードを識別してテイントに設定できます。バージョン番号は、お使いのコントロールプレーンの Kubernetes バージョンよりも新しいものにすることはできません。また、コントロールプレーンの Kubernetes バージョンより 3 つ以上前のマイナーバージョンにすることもできません。コントロールプレーンと同じバージョンを使用することをお勧めします。

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

クラスターの DNS プロバイダーを決定します。

kubectl get deployments -l k8s-app=kube-dns -n kube-system

出力例は次のとおりです。このクラスターでは、DNS 解決に CoreDNS を使用していますが、クラスターからは kube-dns が返される場合があります。

NAME      DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
coredns   1         1         1            1           31m

現在のデプロイメントで実行しているレプリカが 2 つ未満の場合は、そのデプロイメントを 2 つのレプリカにスケールアウトします。前のコマンドの出力が kubedns を返していた場合は、coredns を kubedns に置き換えます。

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

次のコマンドを使用して、クラスターから削除する各ノードをドレーンします。

kubectl drain node_name --ignore-daemonsets --delete-local-data

ノードを新しい Kubernetes バージョンにアップグレードする場合は、次のコードスニペットを使用して、特定の 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-local-data
done

古いノードのドレーンが完了したら、以前承認したセキュリティグループのインバウンドルールを取り消します。次に、AWS CloudFormation スタックを削除してインスタンスを終了してください。

aws-auth configmap を編集して、RBAC から古いノードインスタンスロールを削除します。

kubectl edit configmap -n kube-system aws-auth

古いノードグループの mapRoles エントリを削除します。

apiVersion: v1
data:
  mapRoles: |
    - rolearn: arn:aws:iam::111122223333:role/nodes-1-16-NodeInstanceRole-W70725MZQFF8
      username: system:node:{{EC2PrivateDNSName}}
      groups:
        - system:bootstrappers
        - system:nodes
    - rolearn: arn:aws:iam::111122223333:role/nodes-1-15-NodeInstanceRole-U11V27W93CX5
      username: system:node:{{EC2PrivateDNSName}}
      groups:
        - system:bootstrappers
        - system:nodes>

更新された configmap を適用するには、ファイルを保存して閉じます。

(オプション) Kubernetes Cluster Autoscaler を使用している場合は、デプロイのスケーリングを 1 レプリカに戻します。

kubectl scale deployments/cluster-autoscaler --replicas=1 -n kube-system

(オプション) 最新バージョンの Amazon VPC CNI Plugin for Kubernetes を使用していることを確認します。サポートされている最新のインスタンスタイプを利用するには、CNI のバージョンを更新することが必要になる場合があります。詳細については、「アマゾン VPC CNI を使用してPodsに IP を割り当てる」を参照してください。

クラスターが DNS 解決 ([migrate-determine-dns-step] を参照) に kube-dns を使用している場合は、kube-dns デプロイを 1 レプリカにスケールインします。

kubectl scale deployments/kube-dns --replicas=1 -n kube-system