EKS で k8s クラスタの node にログインする

# TL;DR

https://github.com/mumoshu/kube-ssm-agent を利用する

# これは何

AWS では EC2 インスタンスに SSM エージェントをインストールする事でインスタンスへの操作/管理を行う事ができる。kube-ssm-agent は ssm-agent を DaemonSet として動かすことで、ノードに aws ssm start-session できるようにする。

AWS では EC2 インスタンスに後から SSH 鍵をデプロイすることはできないが、この手法では後から ssm-agent をデプロイしてログインできるようにハックできる点が秀逸。手順は面倒だが、、、

# 事前準備

kube-ssm-agent の使い方自体は README にある通りなのだが、ssm-agent の事前準備がけっこう面倒

### 手元の AWS CLI に Session Manager プラグインを追加する

ref. https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html

```
$ curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/sessionmanager-bundle.zip" -o "sessionmanager-bundle.zip"
$ unzip sessionmanager-bundle.zip
$ sudo ./sessionmanager-bundle/install -i /usr/local/sessionmanagerplugin -b /usr/local/bin/session-manager-plugin
```

### SSM セッションの RunAs の設定

ref. https://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/session-preferences-run-as.html

#### (1) デフォルト `ssm-agent` ユーザでセッションを作る場合

他の用途で ssm-agent をすでに使っていなければこちらがお手軽。

セッションマネージャの設定で RunAs サポートのチェックを外しておく、または外れていることを確認する。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/9641/5548c7d4-23fc-48bd-d834-0273bfc6b34c.png)


#### (2) ユーザ名を指定してセッションを作りたい場合

セッションマネージャの設定で RunAs サポートのチェックを入れておき

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/9641/4690e467-3970-c485-dad6-52e8158ea447.png)


AWS CLI で使う IAM に対して SSMSessionRunAs タグを設定すると、指定したタグ値のユーザ名でセッションが作られる

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/9641/531a02d4-84ca-8c3a-dc7b-2c5fec5c6133.png)


尚、うまく設定できていない aws ssm start-session で以下のようなエラーが出る

```
An error occurred (BadRequest) when calling the StartSession operation: 
   Invalid RunAs username. Set default username in Session Manager Preferences page.
```

### AmazonSSMManagedInstanceCore 権限の付与

EKS ノードのインスタンスプロファイルに AmazonSSMManagedInstanceCore 権限を付与する

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/9641/26532c50-25a6-1918-c879-f633a71b7d40.png)


# 使い方

### 利用を開始する (apply)

```
$ git clone https://github.com/mumoshu/kube-ssm-agent.git
$ cd kube-ssm-agent
$ kubectl apply -f daemonset.yaml
```

注: 全ノードにデプロイされます。リソースが余っていないと立ち上がりません。

```
$ kubectl get nodes -o wide | grep ssm-agent
NAME              READY   STATUS    RESTARTS   AGE   IP              NODE                                               NOMINATED NODE   READINESS GATES
ssm-agent-54jr6   1/1     Running   0          64m   10.0.28.155   ip-10-0-28-155.ap-northeast-1.compute.internal   <none>           <none>
ssm-agent-nkw55   0/1     Pending   0          64m   <none>          <none>                                             <none>           <none>
ssm-agent-rwcvc   1/1     Running   0          64m   10.0.26.255   ip-10-0-26-255.ap-northeast-1.compute.internal   <none>           <none>
```

### インスタンスIDを調べる

```
$ instance_name=ip-10-0-28-155.ap-northeast-1.compute.internal
$ aws ec2 describe-instances --filter "PrivateDnsName=${instance_name}" | jq -r '.Reservations[].Instances[].InstanceId'
i-0899aeb403d670999
```

### インスタンスに接続する

```
$ AWS_DEFAULT_REGION=ap-northeast-1 aws ssm start-session --target i-0899aeb403d670999
Starting session with SessionId: naotoshi.seo-0ba49fc7f826af431

sh-4.2$ uname -a
Linux ip-10-0-28-155.ap-northeast-1.compute.internal 4.14.198-152.320.amzn2.x86_64 #1 SMP Wed Sep 23 23:57:28 UTC 2020 x86_64 x86_64 x86_64 GNU/Linux
```

### 利用を終了する (delete)

用事が終わったら DaemonSet を破棄する

```
$ kubectl delete -f daemonset.yaml
```