環境設定(管理者向け)
Docker Compose の環境変数でシステムの動作を切り替えられます。
協調編集モード
admin-frontend の環境変数で協調編集機能の有効/無効を切り替えられます。
docker-compose.dev.yml
yaml
admin-frontend:
environment:
# 協調編集機能(デフォルトはfalse)
- NEXT_PUBLIC_ENABLE_COLLABORATION=true # 有効
# - NEXT_PUBLIC_ENABLE_COLLABORATION=false # 無効
- NEXT_PUBLIC_COLLAB_WS_URL=ws://localhost:8083設定値
| 環境変数 | 値 | 説明 |
|---|---|---|
NEXT_PUBLIC_ENABLE_COLLABORATION | true | 協調編集モード有効(リアルタイム同期、自動保存) |
NEXT_PUBLIC_ENABLE_COLLABORATION | false | 通常モード(手動保存、単独編集) |
NEXT_PUBLIC_COLLAB_WS_URL | ws://... | 協調編集サーバーの WebSocket URL |
モードの違い
| 機能 | 協調編集モード (true) | 通常モード (false) |
|---|---|---|
| 保存方式 | 自動保存(2秒 debounce) | 手動保存ボタン |
| 複数人編集 | リアルタイム同期 | 後から保存した人で上書き |
| 接続状態表示 | あり(🟢同期済み / 🔴切断) | なし |
| 必要なサービス | collab-service, valkey | なし |
切り替え手順
docker-compose.dev.ymlのNEXT_PUBLIC_ENABLE_COLLABORATIONを変更- コンテナを再起動
bash
# 再起動
make down && make upTIP
協調編集を無効にすると collab-service と valkey は不要ですが、起動していても問題ありません。
その他の環境変数
admin-frontend
| 環境変数 | 説明 | デフォルト |
|---|---|---|
NODE_ENV | 実行環境 | development |
ADMIN_BFF_URL | BFF の内部 URL | http://admin-bff:8082 |
collab-service
| 環境変数 | 説明 | デフォルト |
|---|---|---|
PORT | WebSocket ポート | 8083 |
VALKEY_HOST | Valkey ホスト | valkey |
VALKEY_PORT | Valkey ポート | 6379 |
CMS_SERVICE_HOST | cms-service アドレス | cms-service:8080 |
ADMIN_BFF_URL | BFF URL(セッション検証用) | http://admin-bff:8082 |
cms-service / auth-service
| 環境変数 | 説明 |
|---|---|
GO_ENV | 実行環境 (development / production) |
DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME | PostgreSQL 接続情報 |
VALKEY_HOST, VALKEY_PORT | Valkey 接続情報 |