Step 2 Doc: Add Synology setup guide
This commit is contained in:
Ponshu Developer
parent
1cb3ada9e0
commit
e05d05c4ee
|
|
@ -10,7 +10,10 @@
|
||||||
"Bash(find:*)",
|
"Bash(find:*)",
|
||||||
"Bash(git add:*)",
|
"Bash(git add:*)",
|
||||||
"Bash(git commit:*)",
|
"Bash(git commit:*)",
|
||||||
"Bash(git rebase:*)"
|
"Bash(git rebase:*)",
|
||||||
|
"Bash(cat:*)",
|
||||||
|
"Bash(git pull:*)",
|
||||||
|
"Bash(git stash:*)"
|
||||||
],
|
],
|
||||||
"deny": [],
|
"deny": [],
|
||||||
"ask": []
|
"ask": []
|
||||||
|
|
|
||||||
|
|
@ -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工場」の基盤は完成です！🚀
|
||||||
Loading…
Reference in New Issue