diff --git a/.claude/settings.local.json b/.claude/settings.local.json index d92e527..6589924 100644 --- a/.claude/settings.local.json +++ b/.claude/settings.local.json @@ -10,7 +10,10 @@ "Bash(find:*)", "Bash(git add:*)", "Bash(git commit:*)", - "Bash(git rebase:*)" + "Bash(git rebase:*)", + "Bash(cat:*)", + "Bash(git pull:*)", + "Bash(git stash:*)" ], "deny": [], "ask": [] diff --git a/README_SYNOLOGY.md b/README_SYNOLOGY.md new file mode 100644 index 0000000..995ad8e --- /dev/null +++ b/README_SYNOLOGY.md @@ -0,0 +1,95 @@ + +# 🐳 Synology NAS 構築ガイド (Phase 2A: AI Factory Setup) + +このドキュメントは、「Ponshu Room」開発環境をSynology NAS上に構築するための手順書です。 +**共同開発者(インフラ担当)向け** の内容となっています。 + +## 🎯 目標 (Phase 2A) +1. **Gitea** の構築(ローカルGitサーバー) +2. **PostgreSQL** の構築(Gitea用DB) +3. **MCP Server** の枠組み構築(AIエージェント接続用) + +--- + +## 🛠️ 事前準備 (Prerequisites) +以下のアプリがSynology NASにインストールされていることを確認してください。 +* **Container Manager** (旧 Docker) +* **Text Editor** (設定ファイル修正用) +* **File Station** + +## 📂 デプロイ手順 + +### Step 1: ファイルの配置 +File Stationを使用し、以下のディレクトリ構造を作成・配置してください。 +推奨パス: `/docker/ponshu_factory` + +``` +/docker/ponshu_factory/ +├── docker-compose.yml <-- リポジトリ内の tools/synology/docker-compose.yml をコピー +├── gitea/ <-- 自動作成されます(空でOK) +├── postgres/ <-- 自動作成されます(空でOK) +└── mcp/ <-- 自動作成されます(空でOK) +``` + +### Step 2: docker-compose.yml の確認 +`docker-compose.yml` を開き、以下の環境変数を必要に応じて変更してください。 +特にパスワードは強固なものに変更することを推奨します。 + +```yaml +services: + gitea: + environment: + - GITEA__database__PASSWD=your_secure_password # <--- 変更推奨 + + db: + environment: + - POSTGRES_PASSWORD=your_secure_password # <--- Giteaと同じにする +``` + +### Step 3: コンテナの起動 +Synology **Container Manager** を開きます。 +1. **プロジェクト** タブを選択 +2. **作成** ボタンをクリック +3. **プロジェクト名**: `ponshu_factory` +4. **パス**: `/docker/ponshu_factory` を選択 +5. **「docker-compose.ymlを使用してプロジェクトを作成」** を選択し、次へ +6. 設定を確認して **完了** をクリック + +### Step 4: 初期設定 (Gitea) +コンテナ起動後、ブラウザで以下にアクセスします。 +`http://[NASのIPアドレス]:3000` + +1. 初期設定画面が表示されます。 +2. **データベース設定**: + * タイプ: `PostgreSQL` + * ホスト: `db:5432` + * ユーザー: `gitea` + * パスワード: (Step 2で設定したもの) + * データベース名: `gitea` +3. **一般設定**: + * SSHサーバーのドメイン: `[NASのIPアドレス]` + * GiteaのベースURL: `http://[NASのIPアドレス]:3000/` +4. **管理者アカウントの設定**: + * 任意の管理者ユーザーを作成してください(例: `admin`)。 +5. **「Giteaをインストール」** をクリック。 + +--- + +## 🔒 外部アクセス設定 (Phase 2B準拠) +現在の構成はローカルネットワーク内のみアクセス可能です。 +外部(開発者のPC)から安全にアクセスするため、**Cloudflare Tunnel** の導入を推奨します。 + +### 推奨設定 (Cloudflare Tunnel) +1. Synology上で `cloudflared` コンテナを追加(または既存のTunnelを使用)。 +2. Tunnel設定で以下をマッピング: + * `git.ponshu.room` -> `http://gitea:3000` + +--- + +## 🤝 開発フローへの接続 +環境構築が完了したら、以下の情報を開発者(Ponshu Roomチーム)に共有してください。 + +1. **Gitea URL**: (例: `http://192.168.1.50:3000` またはTunnel URL) +2. **管理者アカウント情報**: (安全なチャネルで共有) + +これで「AI工場」の基盤は完成です!🚀