chore: switch postgres default host port to 5434
This commit is contained in:
chengkai3
+2
-2
@@ -5,7 +5,7 @@ API_CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000
|
||||
API_CORS_ORIGIN_REGEX=
|
||||
DATABASE_URL=
|
||||
DB_HOST=127.0.0.1
|
||||
DB_PORT=5433
|
||||
DB_PORT=5434
|
||||
DB_NAME=postgres
|
||||
DB_SCHEMA=public
|
||||
DB_USERNAME=fquiz
|
||||
@@ -42,7 +42,7 @@ INITIAL_ADMIN_PASSWORD=change-me-strong-password
|
||||
POSTGRES_DB=fquiz
|
||||
POSTGRES_USER=fquiz
|
||||
POSTGRES_PASSWORD=fquiz
|
||||
POSTGRES_PORT=5433
|
||||
POSTGRES_PORT=5434
|
||||
POSTGRES_IMAGE=docker.m.daocloud.io/pgvector/pgvector:pg16
|
||||
PYTHON_BASE_IMAGE=docker.m.daocloud.io/library/python:3.11-slim
|
||||
NODE_BASE_IMAGE=docker.m.daocloud.io/library/node:22-alpine
|
||||
|
||||
@@ -137,7 +137,7 @@ jobs:
|
||||
POSTGRES_USER: ${POSTGRES_USER:-fquiz}
|
||||
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-fquiz}
|
||||
ports:
|
||||
- "${POSTGRES_PORT:-5433}:5432"
|
||||
- "${POSTGRES_PORT:-5434}:5432"
|
||||
volumes:
|
||||
- fquiz_db_data:/var/lib/postgresql/data
|
||||
healthcheck:
|
||||
@@ -379,7 +379,7 @@ jobs:
|
||||
POSTGRES_DB=fquiz
|
||||
POSTGRES_USER=fquiz
|
||||
POSTGRES_PASSWORD=fquiz
|
||||
POSTGRES_PORT=5433
|
||||
POSTGRES_PORT=5434
|
||||
POSTGRES_IMAGE=docker.m.daocloud.io/pgvector/pgvector:pg16
|
||||
REDIS_IMAGE=docker.m.daocloud.io/library/redis:7-alpine
|
||||
REDIS_PORT=6379
|
||||
|
||||
@@ -47,7 +47,7 @@
|
||||
- SQLAlchemy 关联加载选项（`selectinload/joinedload`）避免在模块导入期以全局常量初始化，优先在函数内惰性构建，防止导入顺序导致 mapper 提前配置失败。
|
||||
- `app.models` 包初始化需预加载全部模型模块，确保字符串关系（如 `"AuditLog"`）在启动阶段可解析。
|
||||
- 部署 compose 中 DB 镜像应通过 `POSTGRES_IMAGE` 可配置，默认使用镜像站的 pgvector 镜像（`docker.m.daocloud.io/pgvector/pgvector:pg16`）。
|
||||
- 宿主机 DB 暴露端口统一走 `POSTGRES_PORT`（默认 `5433`），用于规避与宿主机已有 PostgreSQL（常见 `5432`）冲突；容器内连接仍保持 `db:5432`。
|
||||
- 宿主机 DB 暴露端口统一走 `POSTGRES_PORT`（默认 `5434`），用于规避与宿主机已有 PostgreSQL（常见 `5432`）冲突；容器内连接仍保持 `db:5432`。
|
||||
- CORS 来源控制采用“双轨配置”：`API_CORS_ORIGINS`（精确列表）+ `API_CORS_ORIGIN_REGEX`（正则，可选）；`API_CORS_ORIGINS` 支持 `*` 和通配符域名并在后端转换为 `allow_origin_regex`。
|
||||
- GitHub Actions 使用 `appleboy/ssh-action` 部署时，慢网环境需显式设置 `command_timeout`（建议 `45m`）并为 `docker compose pull` 增加重试，避免出现 `Run Command Timeout` 直接中断发布。
|
||||
- GitHub Actions 的部署编排需与仓库 `docker-compose.yml` 服务拓扑保持一致，至少包含 `db/api/web/redis/minio/minio-init/celery-worker/celery-beat`；避免在 workflow 内维护“精简版 compose”导致运行时能力缺失（如 Celery/MinIO）。
|
||||
@@ -224,7 +224,7 @@
|
||||
|
||||
- 默认参数口径：
|
||||
- Docker 内：`DB_HOST=db`、`DB_PORT=5432`、`DB_NAME=postgres`、`DB_USERNAME=fquiz`、`DB_PASSWORD=fquiz`。
|
||||
- 本机直连（非 Docker）：`DB_HOST=127.0.0.1`、`DB_PORT=5433`、`DB_NAME=postgres`、`DB_USERNAME=fquiz`、`DB_PASSWORD=fquiz`。
|
||||
- 本机直连（非 Docker）：`DB_HOST=127.0.0.1`、`DB_PORT=5434`、`DB_NAME=postgres`、`DB_USERNAME=fquiz`、`DB_PASSWORD=fquiz`。
|
||||
- `docker compose` 的 `db` 服务已取消 `local-db` profile，默认 `up` 即启动本地库；`api` 增加 `depends_on: db (healthy)`。
|
||||
- `DB_SCHEMA` 通过 PostgreSQL `search_path` 注入，语义等价 JDBC 的 `currentSchema`。
|
||||
- API 启动初始化口径：`seed_defaults` 对本地目标执行；为兼容老表状态约束，初始管理员状态写入值统一为 `ENABLED`（不使用 `active`）。
|
||||
|
||||
@@ -116,7 +116,7 @@
|
||||
- 前端：`http://localhost:3000`
|
||||
- 后端：`http://localhost:8000/health`
|
||||
- PostgreSQL：默认连接外部库（`DB_HOST/DB_PORT/DB_NAME/DB_SCHEMA/DB_USERNAME/DB_PASSWORD`）
|
||||
- 本地 PostgreSQL（可选）：启用 `local-db` profile 后使用 `localhost:5433`（可通过 `POSTGRES_PORT` 覆盖）
|
||||
- 本地 PostgreSQL（可选）：启用 `local-db` profile 后使用 `localhost:5434`（可通过 `POSTGRES_PORT` 覆盖）
|
||||
|
||||
5. 停止并清理：
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ class Settings(BaseSettings):
|
||||
|
||||
database_url: str | None = None
|
||||
db_host: str = "127.0.0.1"
|
||||
db_port: int = 5433
|
||||
db_port: int = 5434
|
||||
db_name: str = "postgres"
|
||||
db_schema: str = "public"
|
||||
db_username: str = "fquiz"
|
||||
|
||||
+1
-1
@@ -7,7 +7,7 @@ services:
|
||||
POSTGRES_USER: ${POSTGRES_USER:-fquiz}
|
||||
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-fquiz}
|
||||
ports:
|
||||
- "${POSTGRES_PORT:-5433}:5432"
|
||||
- "${POSTGRES_PORT:-5434}:5432"
|
||||
volumes:
|
||||
- fquiz_db_data:/var/lib/postgresql/data
|
||||
healthcheck:
|
||||
|
||||
@@ -0,0 +1,30 @@
|
||||
## Work Log - Docker PostgreSQL 默认端口切换为 5434（2026-04-30）
|
||||
|
||||
- 背景：
|
||||
- 用户要求将 Docker 镜像构建/部署链路中的 PostgreSQL 默认宿主机端口改为 `5434`。
|
||||
|
||||
- 本次改动：
|
||||
- `docker-compose.yml`
|
||||
- `db.ports` 默认映射从 `${POSTGRES_PORT:-5433}:5432` 改为 `${POSTGRES_PORT:-5434}:5432`。
|
||||
- `.env`
|
||||
- `POSTGRES_PORT=5434`。
|
||||
- `.env.example`
|
||||
- `DB_PORT=5434`（本机直连口径）。
|
||||
- `POSTGRES_PORT=5434`（容器暴露口径）。
|
||||
- `.github/workflows/main.yml`
|
||||
- 部署阶段生成的 `docker-compose.prod.yml` 默认映射改为 `${POSTGRES_PORT:-5434}:5432`。
|
||||
- 自动生成 `.env` 模板中的 `POSTGRES_PORT=5434`。
|
||||
- `api/app/core/config.py`
|
||||
- 本机默认 `db_port` 从 `5433` 改为 `5434`，与新口径一致。
|
||||
- `README.md`
|
||||
- 本地 PostgreSQL 可选端口说明从 `localhost:5433` 更新为 `localhost:5434`。
|
||||
- `MEMORY.md`
|
||||
- 长期端口口径同步更新为 `5434`。
|
||||
|
||||
- 验证：
|
||||
- 通过 `rg` 全局检索 `POSTGRES_PORT/5433` 相关配置，确认运行口径已切换到 `5434`。
|
||||
- 本次未执行容器重建或运行态联调。
|
||||
|
||||
- 风险与影响：
|
||||
- 影响范围：Docker 暴露端口与本机直连默认端口。
|
||||
- 若已有外部脚本/客户端固定连接 `5433`，需同步改为 `5434` 或显式覆盖 `POSTGRES_PORT/DB_PORT`。
|
||||
Reference in New Issue
Block a user