---

name: docker-ops description: Obsidian LiveSync の Docker Compose 環境を操作・トラブルシューティングします。compose.yaml の構成理解、環境変数（.env）の設定、CouchDB と livesync-proxy のヘルスチェック、バックアップサービスの実行、ログ確認とデバッグを行います。Docker 環境の起動・停止、コンテナの状態確認、トラブルシューティングを依頼されたときに使用してください。

Docker Operations for Obsidian LiveSync

Overview

このスキルは、Obsidian LiveSync の Docker Compose 環境の操作とトラブルシューティングを支援します。

サービス構成

Copyservices:
  couchdb:          # CouchDB 3.x データベース
  livesync-proxy:   # Rust HTTP プロキシ
  backup:           # 手動バックアップ（profilesで制御）
  backup-scheduler: # 定期バックアップスケジューラ

Instructions

1. compose.yaml の構成

CouchDB サービス:

Copycouchdb:
  build: ./couchdb
  volumes:
    - couchdb_data:/opt/couchdb/data
    - ./couchdb/local.ini:/opt/couchdb/etc/local.ini:rw
  environment:
    COUCHDB_USER: ${COUCHDB_USER}
    COUCHDB_PASSWORD: ${COUCHDB_PASSWORD}
  ports:
    - "${HOST_COUCHDB_PORT}:5984"
  healthcheck:
    test: ["CMD", "curl", "-f", "-u", "${COUCHDB_USER}:${COUCHDB_PASSWORD}", "http://localhost:5984/_up"]

livesync-proxy サービス:

Copylivesync-proxy:
  build: ./livesync-proxy
  depends_on:
    - couchdb
  environment:
    COUCHDB_URL: http://couchdb:5984/
    RUST_LOG: info,livesync_proxy=debug
  ports:
    - "${HOST_PROXY_PORT}:3000"

backup サービス（手動実行）:

Copybackup:
  profiles:
    - manual  # docker compose run backup で実行
  volumes:
    - couchdb_data:/data:ro

2. 環境変数（.env.example 参照）

初期設定:

Copycp .env.example .env
# .env を編集して COUCHDB_PASSWORD を変更

3. ヘルスチェックとトラブルシューティング

サービス状態確認:

Copy# コンテナ状態
docker compose ps

# CouchDB ヘルスチェック
curl -u admin:password http://localhost:5984/_up

# プロキシ ヘルスチェック
curl http://localhost:3000/health

ログ確認:

Copy# 全サービスのログ
docker compose logs -f

# 特定サービス
docker compose logs -f livesync-proxy
docker compose logs -f couchdb

# 最新50行
docker compose logs --tail=50 livesync-proxy

よくある問題と解決策:

4. バックアップサービスの使い方

手動バックアップ:

Copydocker compose run backup

スケジューラ起動（定期バックアップ）:

Copydocker compose up -d backup-scheduler

バックアップ設定:

CopyBACKUP_SCHEDULE=0 2 * * *        # 毎日午前2時
BACKUP_RUN_ON_STARTUP=false      # 起動時実行
BACKUP_GIT_REPO=https://github.com/...
BACKUP_GIT_TOKEN=github_pat_xxx

Examples

開発環境の起動

Copy# 初回セットアップ
cp .env.example .env
# .env を編集

# ビルドして起動
docker compose up --build

# バックグラウンド起動
docker compose up -d

# 停止
docker compose down

# データを含めて完全削除（注意）
docker compose down -v

デバッグモードでの起動

Copy# 詳細ログ有効化
RUST_LOG=debug docker compose up livesync-proxy

CouchDB 直接アクセス

Copy# データベース一覧
curl -u admin:password http://localhost:5984/_all_dbs

# obsidian データベースの情報
curl -u admin:password http://localhost:5984/obsidian

Reference

エンドポイント

• http://localhost:3000/db - LiveSync 接続 URI（Obsidian プラグイン設定用）
• http://localhost:3000/health - ヘルスチェック
• http://localhost:3000/metrics - Prometheus メトリクス
• http://localhost:3000/api/status - サーバーステータス
• http://localhost:5984/_up - CouchDB ヘルスチェック

ファイル

• compose.yaml - Docker Compose 設定
• .env.example - 環境変数テンプレート
• couchdb/local.ini - CouchDB 設定