add: 本地开发 compose 编排、构建脚本与数据库初始化

2026-04-01 03:45:11 +08:00
parent e7970ac25f
commit 507d8c6fd9
7 changed files with 501 additions and 1 deletions
@@ -0,0 +1,62 @@
+# 本地开发环境
+
+## 前置条件
+
+- Docker
+- Go 1.25+（构建镜像时在容器内编译，本机不强制）
+
+## 使用
+
+```bash
+cd deploy/dev
+
+# 1. 构建所有微服务镜像
+./build.sh
+
+# 2. 启动
+docker compose up -d
+
+# 3. 查看状态
+docker compose ps
+
+# 4. 停止
+docker compose down
+```
+
+构建脚本会扫描 `app/` 下所有 `api`、`rpc`、`mq` 入口，生成 `juwan/<service>-<type>:dev` 镜像。编译失败的服务会跳过，不影响其他服务。
+
+如需只启动部分服务：
+
+```bash
+docker compose up -d postgres redis snowflake player-rpc player-api
+```
+
+## 端口映射
+
+| 服务            | 宿主机端口 |
+| --------------- | ---------- |
+| PostgreSQL      | 15432      |
+| Redis           | 16379      |
+| Kafka           | 19092      |
+| users-api       | 18801      |
+| player-api      | 18802      |
+| game-api        | 18803      |
+| shop-api        | 18804      |
+| order-api       | 18805      |
+| wallet-api      | 18806      |
+| community-api   | 18807      |
+| objectstory-api | 18808      |
+| email-api       | 18809      |
+
+## 环境变量
+
+编辑 `.env` 修改数据库密码、Kafka 地址等。默认值可直接用于本地开发。
+
+## 数据库初始化
+
+首次启动时 PostgreSQL 会自动执行 `desc/sql/` 下的建表语句。如需重新初始化，删除 volume 后重启：
+
+```bash
+docker compose down -v
+docker compose up -d
+```