sisu ⚡

AWS をファイルシステムとして使う。

Demo

このように:

grep -l "AdministratorAccess" iam/users/*/policies.json

この代わりに:

aws iam list-users --query 'Users[].UserName' --output text | \
  xargs -I{} sh -c 'aws iam list-attached-user-policies --user-name {} --query "AttachedPolicies[].PolicyArn" --output text' | \
  grep AdministratorAccess

これは何？
インストール
クイックスタート
便利な機能
オプション
対応サービス
CloudWatch Logs ストリーミングの仕組み
統合ログ
ECS エクスプローラー
CloudFront エクスプローラー
S3 バケットメタデータ
EC2 接続、コンソール＆リモートファイルシステム
相性の良いツール
インフラについて AI に聞く
実際のデバッグ例
ヒント

これは何？ 🤔

sisu は AWS リソースをローカルファイルシステムとしてマウントします。JSON や AWS CLI に煩わされる代わりに、使い慣れたツール - grep、cat、diff、vim - を使用できます。

設計上 AI フレンドリー: AI ツールはサーバーに SSH したり、対話型の AWS CLI セッションを実行したりできません。しかし sisu を使えば、AWS インフラ全体がシンプルなファイルパスになり、あらゆる AI が読めるようになります。リモートの EC2 ファイルシステムには ec2/<instance>/fs/ でアクセスでき、/var/log、/etc、そしてインスタンス上のあらゆるファイルを SSH なしで AI が閲覧できます。

現在は S3、SSM、IAM、VPC、Lambda、EC2、ECS、CloudFront、Secrets Manager、Route 53、CloudWatch Logs に対応しています。

インストール 📦

go install github.com/semonte/sisu@latest

FUSE が必要です:

sudo apt install fuse    # Ubuntu/Debian
sudo yum install fuse    # RHEL/CentOS

クイックスタート 🚀

sisu

これで開始です。AWS が手のひらに乗ります:

~/.sisu/mnt/
├── default/              # AWS profile
│   ├── global/           # IAM, S3, Route 53 (region-independent)
│   │   ├── iam/
│   │   ├── route53/
│   │   └── s3/
│   ├── us-east-1/        # Regional services
│   │   ├── cloudfront/
│   │   ├── ec2/
│   │   ├── ecs/
│   │   ├── lambda/
│   │   ├── logs/
│   │   ├── secrets/
│   │   ├── ssm/
│   │   └── vpc/
│   └── eu-west-1/
│       └── ...
├── prod/                 # Other profiles from ~/.aws/credentials
└── staging/

終了したら exit と入力します。

便利な機能 🔥

インフラを探索する

# Who has admin access?
grep -l "AdministratorAccess" */global/iam/users/*/policies.json

# Security groups with SSH open
grep -r '"FromPort": 22' */us-east-1/vpc/*/security-groups/

# Roles that Lambda can assume
grep -l "lambda.amazonaws.com" */global/iam/roles/*/info.json

# Secrets in SSM?
grep -r "password" */us-east-1/ssm/

# Lambda functions with secrets in env vars
grep -r "PASSWORD\|SECRET\|API_KEY" */us-east-1/lambda/*/env.json

# Functions using deprecated runtimes
grep -r "python3.8\|nodejs16" */*/lambda/*/config.json

# EC2 instances with public IPs
grep -r "PublicIpAddress" */*/ec2/*/info.json

# Find stopped instances (wasting money?)
grep -r '"Name": "stopped"' */*/ec2/*/info.json

# Connect to an EC2 instance via SSM (no SSH keys needed!)
./default/us-east-1/ec2/i-abc123/connect

# View EC2 boot logs and kernel messages
cat default/us-east-1/ec2/i-abc123/console.log

# View all secrets
ls */us-east-1/secrets/

# Read a secret value
cat default/us-east-1/secrets/myapp/database/value

# List all DNS zones
ls */global/route53/

# View DNS records for a zone
cat default/global/route53/example.com/records.json

# Find all CNAME records
grep -r '"Type": "CNAME"' */global/route53/*/records.json

# Grep recent logs for errors
grep -i "error" default/us-east-1/logs/aws/lambda/my-function/latest.log

# View all log groups
ls */us-east-1/logs/

# List log streams (shows 20 most recent)
ls default/us-east-1/logs/aws/lambda/my-function/

# View events from a specific stream
cat default/us-east-1/logs/aws/lambda/my-function/2024_01_15_abc123/events.log

# ECS: Browse clusters, services, and tasks
ls default/us-east-1/ecs/my-cluster/my-service/
cat default/us-east-1/ecs/my-cluster/my-service/logs/latest.log

# CloudFront: View distributions and functions
ls default/us-east-1/cloudfront/distributions/
cat default/us-east-1/cloudfront/functions/my-auth/code.js

# S3: Check bucket policies and access settings
cat default/global/s3/my-bucket/.meta/policy.json
cat default/global/s3/my-bucket/.meta/public-access-block.json

環境間の差分を確認する

# Compare IAM roles between accounts
diff prod/global/iam/roles/api/info.json staging/global/iam/roles/api/info.json

# Security group drift between regions
diff default/us-east-1/vpc/vpc-xxx/security-groups/sg-xxx.json default/eu-west-1/vpc/vpc-yyy/security-groups/sg-yyy.json

# Lambda config differences
diff prod/us-east-1/lambda/my-func/config.json staging/us-east-1/lambda/my-func/config.json

パイプで何にでも渡す

# Pretty print with jq
cat default/global/iam/roles/my-role/info.json | jq '.AssumeRolePolicyDocument'

# Count your roles
ls default/global/iam/roles/ | wc -l

# Find untagged resources
cat default/us-east-1/vpc/vpc-xxx/info.json | jq 'select(.Tags == null)'

# List all Lambda runtimes in use
grep -h "Runtime" */*/lambda/*/config.json | sort | uniq -c

SSM をファイルのように編集する

cat default/us-east-1/ssm/myapp/database-url          # read
echo "postgres://prod:5432" > default/us-east-1/ssm/database-url  # write
vim default/us-east-1/ssm/myapp/config                # edit

S3 を Unix 流に使う

cp local.txt default/global/s3/my-bucket/backup/
cat default/global/s3/my-bucket/logs/app.log | grep ERROR
rm default/global/s3/my-bucket/old-file.txt

オプション ⚙️

sisu                                    # Start at root
sisu --profile prod                     # Start in prod/
sisu --profile prod --region us-east-1  # Start in prod/us-east-1/
sisu stop                               # Unmount
sisu --debug                            # Debug logging

対応サービス ✅

CloudWatch Logs ストリーミングの仕組み 📜

ログストリームの events.log ファイルは、全体をメモリに読み込むのではなく、AWS から遅延ストリーミングされます:

オンデマンド取得: ファイルを読み進めると、イベントは 100 件ずつのバッチで取得されます
メモリ効率が高い: バッファされるのは取得済みのコンテンツのみで、ストリーム全体ではありません
シーケンシャル読み取り: cat、grep、head、less で使用できます

# Fetches only enough batches to find the match
grep "ERROR" .../my-stream/events.log

# Fetches just the first batch
head -50 .../my-stream/events.log

# Scroll through with on-demand loading
less .../my-stream/events.log

# Will fetch all events
cat .../my-stream/events.log | wc -l

注意: tail はファイルの末尾をシークするため、ストリーミングファイルでは正しく動作しません。実際のファイルサイズは完全に読み込まれるまで不明だからです。回避策として cat ... | tail を使用してください。

統合ログ 📋

各サービスには、リソース直下にログがあります。ロググループを探し回る必要はありません:

# Lambda function logs
cat default/us-east-1/lambda/my-function/logs/latest.log

# EC2 instance logs (searches for log groups containing instance ID)
cat default/us-east-1/ec2/i-abc123/logs/latest.log

# ECS service logs
cat default/us-east-1/ecs/my-cluster/my-service/logs/latest.log

# CloudFront function logs
cat default/us-east-1/cloudfront/functions/my-auth/logs/latest.log

統合ログはすべてストリーミングを使用します。読み進めるとイベントをオンデマンドで取得します。

ECS エクスプローラー 🐳

ECS クラスター、サービス、タスクを参照します:

ecs/
├── my-cluster/
│   ├── web-service/
│   │   ├── info.json          # Service configuration
│   │   ├── logs/
│   │   │   └── latest.log     # Streaming service logs
│   │   └── tasks/
│   │       └── abc123/
│   │           └── info.json  # Task details
│   └── api-service/
│       └── ...

# List all ECS clusters
ls default/us-east-1/ecs/

# View service configuration
cat default/us-east-1/ecs/my-cluster/web-service/info.json

# Stream service logs
cat default/us-east-1/ecs/my-cluster/web-service/logs/latest.log

# List running tasks
ls default/us-east-1/ecs/my-cluster/web-service/tasks/

CloudFront エクスプローラー 🌐

CloudFront ディストリビューションと関数を参照します:

cloudfront/
├── distributions/
│   └── E1ABC123/
│       ├── info.json          # Distribution config
│       └── origins.json       # Origins with OAC/OAI info
└── functions/
    └── my-auth/
        ├── code.js            # Function source code
        ├── config.json        # Function configuration
        └── logs/
            └── latest.log     # Function execution logs

# List distributions
ls default/us-east-1/cloudfront/distributions/

# Check origin access configuration (debug S3 access issues!)
cat default/us-east-1/cloudfront/distributions/E1ABC123/origins.json

# View and edit CloudFront function code
cat default/us-east-1/cloudfront/functions/my-auth/code.js

# Debug function execution
cat default/us-east-1/cloudfront/functions/my-auth/logs/latest.log

S3 バケットメタデータ 🪣

各 S3 バケットには、バケット設定を持つ隠し .meta/ ディレクトリがあります:

# View bucket policy
cat default/global/s3/my-bucket/.meta/policy.json

# Check public access block settings
cat default/global/s3/my-bucket/.meta/public-access-block.json

CloudFront から S3 へのアクセス問題のデバッグに役立ちます！

EC2 接続、コンソール＆リモートファイルシステム 🖥️

各 EC2 インスタンスでは以下を利用できます:

ls default/us-east-1/ec2/i-abc123/
# info.json  security-groups.json  tags.json  console.log  connect  fs/  logs/

SSM 経由で接続 (SSH キーもパブリック IP も不要):

./default/us-east-1/ec2/i-abc123/connect

Session Manager プラグインが必要です。

起動ログとカーネルメッセージを表示:

cat default/us-east-1/ec2/i-abc123/console.log

インスタンスのファイルシステムをリモートで参照 (SSM Run Command 経由):

# List files on the instance
ls default/us-east-1/ec2/i-abc123/fs/etc/

# Read remote files
cat default/us-east-1/ec2/i-abc123/fs/etc/hostname

# Grep across remote logs
grep ERROR default/us-east-1/ec2/i-abc123/fs/var/log/syslog

# Compare configs between instances
diff prod/us-east-1/ec2/i-111/fs/etc/nginx/nginx.conf \
     prod/us-east-1/ec2/i-222/fs/etc/nginx/nginx.conf

SSH キーもオープンポートも不要です。内部では SSM Run Command を使用しています。

相性の良いツール 🔧

ツール	機能
fzf	プレビュー付きファジーファインダー
jq	JSON のクエリ／変換
difftastic	構造差分 (JSON を解釈)

# Browse and preview any resource interactively
find */global/iam/roles -name "info.json" | fzf --preview 'jq . {}'

# Find Lambda functions with high memory
jq -r 'select(.MemorySize > 512) | .FunctionName' */us-east-1/lambda/*/config.json

# Compare prod vs staging config
difft prod/us-east-1/lambda/api/config.json staging/us-east-1/lambda/api/config.json

インフラについて AI に聞く 🤖

ただのファイルに過ぎないので、AI ツールで AWS を直接読んで分析できます:

cd ~/.sisu/mnt && claude

"Find security groups that allow SSH from 0.0.0.0/0"
"Review IAM roles for overly permissive policies"
"Compare prod and staging Lambda configs"

実際のデバッグ例 🔍

問題: ECS サービスが「No Container Instances were found in your cluster」エラーで失敗している

SSH なしで sisu を使って診断します:

# Check cluster status - no instances registered
cat ecs/jobdeck-cluster/info.json | jq '.RegisteredContainerInstancesCount'
# → 0

# Check service config - using EC2 launch type
cat ecs/jobdeck-cluster/jobdeck-api/info.json | jq '.LaunchType, .FailedTasks'
# → "EC2", 136

# EC2 instance exists - check its ECS config
cat ec2/i-xxx/fs/etc/ecs/ecs.config
# → ECS_CLUSTER=jobdeck-cluster ✓

# Check ECS agent logs - no agent log!
ls ec2/i-xxx/fs/var/log/ecs/
# → ecs-volume-plugin.log (missing ecs-agent.log!)

# Check what AMI is running
cat ec2/i-xxx/fs/etc/image-id
# → image_name="amzn2-ami-minimal-hvm"  ← NOT ECS-optimized!

根本原因が判明: EC2 インスタンスが ECS 最適化 AMI ではなく Amazon Linux 2 Minimal AMI を使用しています。Minimal AMI には ECS パッケージがインストールされていますが、エージェントサービスがデフォルトでは有効になっていません。

修正: ECS 最適化 AMI を使用するか、systemctl enable --now ecs を user-data に追加します。

このデバッグはすべて、Claude AI が sisu 経由でファイルシステムを参照して行いました。手動 SSH は一切不要です！

ヒント 💡

結果は 5 分間キャッシュされます
S3 の一覧はディレクトリごとに最大 100 項目です
CloudWatch Logs はイベントを 100 件ずつのバッチで取得します

ライセンス 📄

MIT

S3 (オブジェクト、バケットポリシー、アクセス設定)	✓	✓	✓
SSM Parameter Store	✓	✓	✓
IAM (ユーザー、ロール、ポリシー、グループ)	✓	-	-
VPC (サブネット、セキュリティグループ、ルート)	✓	-	-
Lambda (設定、ポリシー、環境変数、ログ)	✓	-	-
EC2 (インスタンス、セキュリティグループ、タグ、ログ、リモート fs)	✓	-	-
ECS (クラスター、サービス、タスク、ログ)	✓	-	-
CloudFront (ディストリビューション、関数、ログ)	✓	-	-
Secrets Manager	✓	-	-
Route 53 (ゾーン、レコード)	✓	-	-
CloudWatch Logs	✓	-	-

人気

sisu