R524809
1.4 KiB
1.4 KiB
本地基础设施
复制根目录 .env.example 为 .env 后，执行 pnpm infra:up 启动 PostgreSQL、Redis 和 MinIO。该命令会显式加载根目录 .env，避免因 Compose 文件位于 infra/ 而回退到默认端口或密码。镜像使用已验证的明确版本标签；升级前应先在本地或 staging 验证，再显式更新标签。
应用进程由 pnpm dev 在宿主机启动：Web 使用 Vite 热更新，API 与 Worker 使用各自的 watch 模式。生产环境的 API、Worker 和反向代理容器编排将在部署运行手册中补充；PostgreSQL 和对象存储继续遵守现有架构文档的托管服务边界。
首次执行 pnpm infra:up 时，PostgreSQL 会以本地管理员初始化，并创建三个独立角色：atlas_migrator（仅迁移）、atlas_app（无登录权限组）与 atlas_app_login（API/Worker 登录）。
执行迁移只能使用 MIGRATOR_DATABASE_URL：pnpm --filter @atlas/database migrate。API 和 Worker 只能使用 DATABASE_URL，应用事务会切换到 atlas_app 并按请求设置工作空间上下文。
如已有旧的本地 PostgreSQL volume，初始化脚本不会再次运行；请不要让 API 使用管理员或 migrator 连接串。需要重建本地开发数据时，先确认没有需要保留的数据，再移除该项目的 PostgreSQL volume 后重新执行 pnpm infra:up。