【初心者向け】Amazon EKSでcorednsノードを起動させる

はじめに

　こんにちは。今までコンテナ関係の業務に携わったこともなければ、kubectlコマンドもほとんど実行したことがない「コンテナ初心者」でした。
　最近、コンテナサービスであるAmazon EKSを触る機会が増え、そこで、EKS構築からEKSアドオンのcorednsノードを起動させる作業を何回も繰り返してきました。最初は、うまくノードが起動せず、環境を作るまでに時間がかかりましたが、回数をこなしていくうちに、スムーズに構築できるようになりました。
　個人的な備忘録に近いかもしれませんが、EKSでEKSアドオンのcorednsを起動するまでの手順や注意ポイントを記載いたします。

構成図

　今回の構成図は下図のようになります。

　踏み台はEKSへkubectlコマンドを実行するためのサーバです。もし、EKSのクラスターエンドポイントアクセスで接続許可すれば、ローカルのWSLから接続もできますので、踏み台は必要に応じて構築してください。
※NWの各リソース作成方法についてはここでは割愛させていただきます。
※sgは、ポート443、ソース0.0.0.0/0を許可、ACLはデフォルトのままです。検証のためかなり緩いルールにしてます。
※ルートテーブルについて、Publicサブネットはigwで外部通信(送信先：0.0.0.0/0、ターゲット：igw)、PrivateサブネットはNatGateway経由で外部通信(送信先：0.0.0.0/0、ターゲット：nat)できるようになっていれば問題ありません。

EKS構築

基本的にコンソール画面に従って設定を入れていけば問題ありません。

設定画面①

　IAMロールは「AmazonEKSClusterPolicy」が付与されたrolesを作成して選択しましょう。
　クラスターアクセスの部分は、1度「EKS API」を許可した場合、後から「ConfigMap」のみに変更できないため注意しましょう。

設定画面②

　クラスタエンドポイントアクセスは、EKSへの接続許可に関わる部分です。ここを「プライベート」に設定していることに気づかず、ずっとVPC外から接続しようとしてエラーになった経験があります。。。

設定画面③

　ここはログ、メトリクス関係の設定です。今回は検証なので不要とします。

設定画面④

　EKSアドオンの部分です。今回は検証なので、デフォルトでインストールされるもののみ選択します。EKSアドオンは、EKS構築後から削除、追加することはできます。

設定画面⑤

　EKSアドオンのバージョン設定です。今回は検証なので、デフォルトとします。
　最後に各設定一覧が表示されますので、問題なければ作成します。作成が完了するまで10分ほどかかります。

Fargateプロファイル作成

　続いてFargateプロファイルを作成します。まだFargateプロファイルが作られていないため、corednsのノードは起動しようとしてますが、Pendingになっていると思います。

root@test:~# kubectl get pod -A
NAMESPACE     NAME                       READY   STATUS    RESTARTS   AGE
kube-system   coredns-676bf68468-8zkql   0/1     Pending   0          117s
kube-system   coredns-676bf68468-skzpv   0/1     Pending   0          117s
root@test:~#

設定画面①

　IAMロールは「AmazonEKSFargatePodExecutionRolePolicy」が付与されたrolesを作成して選択しましょう。

設定画面②

　corednsの名前空間は「kube-system」なのでkube-systemの名前空間を指定します。

pod確認

　ここまで行ったら設定は完了です。kubectlコマンドを実行してpodのステータスを見てみましょう。

root@test:~# kubectl get pod -A
NAMESPACE     NAME                       READY   STATUS    RESTARTS   AGE
kube-system   coredns-84bdd59474-6nlfb   1/1     Running   0          7m47s
kube-system   coredns-84bdd59474-z4wmk   1/1     Running   0          7m47s
root@test:~#

以上で作業は完了です。もし、引き続きPending状態だった場合、rolloutを実行してpodを再配備してみてください。

podがRunningになっていないときの原因

　ここまで作業を実施したがpodがRunningになっていないときの原因(私もやってしまったうっかりミス)について記載します。

• rolloutしてpodを再配備する。

# kubectl rollout restart coredns -n kube-system

• 外部通信ができるようにルートテーブルが設定されていない。
• Fargateプロファイルが作成されていない。
• 作成したFargateプロファイルの名前空間が間違っている。

おまけ

ここからはEKS構築でよく使ったコマンドを紹介します。

• .kube/configの更新

# aws eks update-kubeconfig --name [EKS名]

• リソースの一覧

# kubectl get [リソース名] -A

リソース名：pod、deployment、node、namespaceなど

• リソースの詳細確認

# kubectl describe [リソース名] -A

リソース名：pod、deployment、node、namespaceなど

• リソースの削除

# kubectl delete [リソース名] -A

リソース名：pod、deployment、node、namespaceなど

• deploymentの再起動(rollout)

# kubectl rollout restart deployment [deployment名] -n [namespace]
# kubectl rollout status deployment [deployment名] -n [namespace]

最後に

　いかがでしたでしょうか。今回は検証なので、sgやEKSのアクセスなど厳密なものにしておりません。当たり前ですが、実業務でEKSを構築する場合は、EKSの各設定、NW要件、通信要件など設計した上で構築しましょう。
　やはり実際に手を動かして作業をするのが、記憶に残りやすいですね。私と同じようにEKSを最近触り始めた方の参考になれば幸いです。