kasm-admin

KASM 管理者 — 運用管理

目的：稼働中の KASM サーバー（ワークスペース、ユーザー、セッション、リソース、ボットエージェント）を管理します。

前提条件：KASM はすでにインストールおよび設定されている必要があります。インストールについては、/kasm を使用してください。

ステップ 0：管理者のニーズを確認する

タスク	リファレンス
ワークスペースの CRUD（作成、複製、更新、削除）	references/workspace-management.md
セッションの監視と管理	references/session-management.md
ユーザーとグループの管理	references/user-group-management.md
一括操作（複数のワークスペースにまたがる設定の更新）	references/bulk-operations.md
リソースの監視とキャパシティプランニング	references/capacity-planning.md
マルチエージェントボットのデプロイパターン	references/multi-agent-patterns.md
バックアップ、復元、S3/B2 プロファイルの同期	references/backup-operations.md
よく使う Docker 設定（コピー＆ペーストですぐに使用可能）	references/config-templates.md

API 認証

KASM API の呼び出しでは、すべて JSON ペイロード認証を使用します（HTTP Basic 認証は使用しません）。

curl -k -X POST "https://$KASM_HOST/api/admin/$ENDPOINT"   -H "Content-Type: application/json"   -d '{
    "api_key": "$KASM_API_KEY",
    "api_key_secret": "$KASM_API_SECRET"
  }'

API 認証情報は管理者用ボールト（KASM_API_KEY、KASM_API_SECRET）に保存されています。

主な用語

UI 用語	API 用語	DB テーブル
ワークスペース	イメージ	images
セッション	Kasm	kasms
ストレージマッピング	ストレージプロバイダー	storage_providers
API キー	API 設定	api_configs

クイックリファレンス — よく使う操作

サーバーの稼働状態を確認する

# Via sentinelctl (recommended)
sentinelctl pull --config fleet.json --token $TOKEN --connection-mode direct

# Via KASM API
curl -k -X POST "https://$KASM_HOST/api/admin/system_info"   -H "Content-Type: application/json"   -d '{"api_key":"$KEY","api_key_secret":"$SECRET"}'

すべてのワークスペースを一覧表示する

curl -k -X POST "https://$KASM_HOST/api/public/get_images"   -H "Content-Type: application/json"   -d '{"api_key":"$KEY","api_key_secret":"$SECRET"}'

アクティブなセッションを一覧表示する

curl -k -X POST "https://$KASM_HOST/api/admin/get_kasms"   -H "Content-Type: application/json"   -d '{"api_key":"$KEY","api_key_secret":"$SECRET"}'

よく使う DB クエリ

# List workspaces with resources
sudo docker exec kasm_db psql -U kasmapp -d kasm -c   "SELECT image_id, friendly_name, cores, memory, enabled FROM images ORDER BY friendly_name;"

# Active sessions with resource usage
sudo docker exec kasm_db psql -U kasmapp -d kasm -c   "SELECT k.kasm_id, i.friendly_name, u.username, k.start_date FROM kasms k JOIN images i ON k.image_id = i.image_id JOIN users u ON k.user_id = u.user_id WHERE k.operational_status = 'running';"

# Users and groups
sudo docker exec kasm_db psql -U kasmapp -d kasm -c   "SELECT u.user_id, u.username, string_agg(g.name, ', ') as groups FROM users u LEFT JOIN group_membership gm ON u.user_id = gm.user_id LEFT JOIN groups g ON gm.group_id = g.group_id GROUP BY u.user_id, u.username ORDER BY u.username;"