ssm-tui

AWS Systems Manager Session Manager で EC2 に接続するための対話式 CLI です。

デモ

前提条件

• Node.js(>=20.19.0)
• AWS CLI
• Session Manager Plugin
• AWS プロファイル作成済みであること

インストール

npm install
npm link

設定ファイル

設定ファイルは ~/.config/ssm-tui/config.yml に置きます。

mkdir -p ~/.config/ssm-tui
cp examples/config.yml ~/.config/ssm-tui/config.yml

設定例:

instances:
  - name: develop-web-1
    instance_id: i-xxxxxxxxxxxxxxxxx
    group: develop
    description: 開発環境 Web サーバー
    aws_profile: default
    region: ap-northeast-1

実行

ssm-tui

または:

npm run start

使い方

• ↑↓ または j/k で接続先を移動
• PageUp/PageDown でまとめて移動
• Home/End で先頭・末尾へ移動
• Enter で選択
• Ctrl-C でキャンセル
• / で検索モードに入り、name と description で絞り込み
• Esc で検索文字をクリアして検索モードを終了
• 本番系の group は確認時に強めの警告を表示
• 接続先が多い場合は一覧が自動で追従表示される
• 現在位置は進捗バーでも表示される

production 警告

group が production または prod の場合、接続前に強い警告を表示します。

よくあるエラー

• 設定ファイルがない: ~/.config/ssm-tui/config.yml を作成してください
• AWS CLI がない: aws コマンドが PATH にあるか確認してください
• AWS 認証に失敗する: AWS の認証情報と profile 設定を確認してください
• SSM 接続に失敗する: 対象インスタンス、IAM 権限、Session Manager の状態を確認してください