96 lines
3.7 KiB
Markdown
96 lines
3.7 KiB
Markdown
|
|
|||
|
|
# 🐳 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工場」の基盤は完成です！🚀
|