発生した事象
Amazon EKSでNodeGroupを作成した際に、作成中のままという問題が起きました。
- NodeGroupのステータスが**「作成中」のまま進まない**
- EC2(Worker Node)はrunningで正常起動している
-
kubectl get nodesを実行してもノードが0件
つまり、EC2インスタンスは起動しているが、EKSクラスターにNodeとして登録されていない状態でした。
エラーも見れないためどうしようと思って上司に相談しました。
原因
原因は、サブネットにGatewayが設定されていなかったことでした。
今回の構成では:
- VPC内に複数のサブネットを用意
- 各サブネットにWorker Nodeを配置
- しかし、Internet GatewayやNAT Gatewayが未設定
そのため、Worker Nodeは外部通信ができない状態になっていました。

何が起きていたか
Worker Nodeは起動後に、EKSクラスターへ自身を登録するために
EKSのAPIエンドポイントと通信する必要があります。
しかし今回の環境では:
- ルートテーブルに
0.0.0.0/0の出口がない - Gatewayが存在しない
- 外部ネットワークに接続できない
結果として、ワーカーノードが起動していてもEKSに登録されない。
したがって、EKSのノードグループは作成中で止まったままになっていました。
まとめ
ネットワーク難しい!ハマってを繰り返して頭で全体像描けるようになりたい。