この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。
セッションマネージャでインスタンスに接続する際にはインスタンスIDを事前に知る必要がありますが、マネジメントコンソールやCLIから調べるのが少し面倒だったりします。特に台数が多い場合なんかはそうです。そこでCLIで簡単に接続できるようにしてみました。
必要なもの
下記のインストールが必要になります。
- AWS CLI
- AWS CLI 用の Session Manager Plugin
- fzf
検証した環境
- OS: macOS Mojave 10.14.6
- AWS CLI: aws-cli/1.16.220 Python/3.7.4 Darwin/18.7.0 botocore/1.12.210
- session-manager-plugin: 1.1.26.0
設定
~/.aws/cli/aliasファイルを作成し、下記のエイリアスを追加するだけです。私はstart-sessionを省略してssとしました。
[toplevel]
ss =
!f() {
instance_id=$(aws ec2 describe-instances --query 'Reservations[].Instances[].[InstanceId, State.Name, InstanceType, PrivateIpAddress, Platform || `Linux`, Tags[?Key == `Name`].Value | [0]]' --output text | column -t | fzf --reverse | cut -d ' ' -f 1)
aws ssm start-session --target ${instance_id}
}; fAWS CLIのエイリアスについては下記の記事をご参照ください。
実行
セッションを開始するには次のコマンドを実行します。
$ aws ssするとインスタンスの一覧がfzfで表示された状態になるので、Nameタグを入力して絞り込むか、CTRL + n、CTRL + p、またはカーソルキーで選択行を移動できるので、目的のインスタンスを選択した状態でEnterを押せば接続できます。
fzfではインクリメンタルなあいまい検索ができるので、適当に入力できるのが魅力です。
fzfでwebで絞り込んだ様子。最後の2行がヒットしている理由はwindowsのw、devのe、batchのbがwebでヒットしているためです。ただ優先順位が低くなっており最後に表示されています。
> web
6/10
i-xxxxxxxxxxxxxxxxx running t2.small 10.0.0.13 Linux aaaa-dev-web-01
i-xxxxxxxxxxxxxxxxx running t2.small 10.0.0.12 Linux aaaa-dev-web-02
i-xxxxxxxxxxxxxxxxx running t2.medium 10.0.0.21 Linux demo-dev-web-01
i-xxxxxxxxxxxxxxxxx running t2.medium 10.0.0.11 Linux demo-stg-web
i-xxxxxxxxxxxxxxxxx running t2.small 10.0.0.31 windows bbbb-dev-batch-01
> i-xxxxxxxxxxxxxxxxx running t2.small 10.0.0.42 windows bbbb-dev-batch-02セッションが開始されると次のような結果になります。
$ aws ss
Starting session with SessionId: 1567245391-02192adb9299aaf52
sh-4.2$最後に
少し便利になったのではないでしょうか。エイリアスとfzfを活用すれば他にも色んなことができそうです。
0
