feat: add reproducible backend deployment

This commit is contained in:
wlx committed 2026-08-07 12:39:15 +08:00
1 parent 6190e58511
commit ac0d3856f0
11 files changed
+431 -16

No files matched your search

+28
View File
@@ -18,7 +18,35 @@ MINIO_IMAGE=minio/minio:latest
MINIO_MC_IMAGE=minio/mc:latest
MINIO_ROOT_USER=replace-with-a-unique-admin-name
MINIO_ROOT_PASSWORD=replace-with-a-random-value
MINIO_APP_ACCESS_KEY=ai_soulmate_app
MINIO_APP_SECRET_KEY=replace-with-a-random-value
MINIO_BUCKET=ai-soulmate
MINIO_API_BIND_ADDRESS=127.0.0.1
MINIO_API_HOST_PORT=9000
MINIO_CONSOLE_HOST_PORT=9001
MINIO_VOLUME_NAME=ai-soulmate-minio-data
MINIO_API_CORS_ALLOW_ORIGIN=http://localhost:8080,http://127.0.0.1:8080
BACKEND_COMPOSE_PROJECT_NAME=ai-soulmate-backend
BACKEND_IMAGE=ai-soulmate-backend:replace-with-source-commit
BACKEND_BIND_ADDRESS=127.0.0.1
BACKEND_HOST_PORT=3001
BACKEND_MEMORY_LIMIT=4g
BACKEND_CPU_LIMIT=2.0
APP_ENV=production
SECRET_KEY=replace-with-a-random-value
ENCRYPTION_KEY=replace-with-a-random-value
ORDER_NO_SECRET=replace-with-a-random-value
CDK_CODE_PEPPER=replace-with-a-random-value
MLKJ_INTEGRATION_KEY=replace-with-a-random-value
MLKJ_INTEGRATION_SECRET=replace-with-a-random-value
PRINT_CLIENT_SHARED_TOKEN=replace-with-a-random-value
OSS_PUBLIC_ENDPOINT=http://127.0.0.1:9000
CORS_ALLOWED_ORIGINS=http://localhost:8080,http://127.0.0.1:8080
AI_SOULMATE_PUBLIC_URL=http://127.0.0.1:8080
FRONTEND_URL=http://127.0.0.1:8080
TRIPO3D_API_KEY=
TRIPO3D_BASE_URL=https://api.tripo3d.com/v2/openapi
TRIPO3D_DEFAULT_MODEL_VERSION=v3.1-20260211
+9 -5
View File
@@ -1,6 +1,6 @@
# Compose 状态
当前只提交基础设施 POC:PostgreSQL、Redis 和 MinIO。它不启动业务前端、后端、管理端或网关,因为这些服务还没有完成本地对象存储、管理端 AI-only 模式和生产镜像改造。
当前提交基础设施 POC 与平台后端:PostgreSQL、Redis、MinIO 和 FastAPI 后端。平台前端、管理端和网关仍在后续阶段。
## 运行基础设施
@@ -11,13 +11,17 @@
docker compose --env-file compose/.env -f compose/docker-compose.infra.yml ps
./scripts/verify-infra.sh compose/.env
compose/.env 只放在服务器,已经被 .gitignore 忽略。生成后执行 chmod 600 compose/.env。数据库、Redis 和 MinIO 的宿主机端口只绑定到 127.0.0.1,业务容器接入同一个 Docker 网络后使用服务名访问;不要把这些端口改成 0.0.0.0。
compose/.env 只放在服务器,已经被 .gitignore 忽略。生成后执行 chmod 600 compose/.env。数据库和 Redis 只绑定到 127.0.0.1;MinIO API 可绑定批准的局域网地址,MinIO 控制台保持回环绑定。业务容器在 Docker 内部网络中通过服务名访问基础设施,不要把端口改成 0.0.0.0。
## 运行后端
按照 `docs/BACKEND-DEPLOYMENT.md` 生成后端密钥、创建 MinIO 应用账号、构建提交绑定的镜像并执行连接验收。
## 当前门槛
- ai-soulmate-server 当前 Dockerfile 只有开发目标,开发 Compose 还使用源码 bind mount,不能作为生产镜像。
- 平台和管理端仍需把 Alibaba OSS 收敛到可切换的存储接口,并通过本地 S3 兼容服务完成预签名、分片、CORS、权限、备份和恢复测试。
- 平台后端仍需完成 MinIO 预签名上传、下载和浏览器 CORS 联调。
- 平台前端仍需生成生产镜像并接入本地后端。
- mlkj-admin 仍需实现 AI SoulMate-only 启动模式,避免初始化无关业务数据库和默认账号。
- nginx-server 的公网路由不能原样复用;完成业务镜像后再使用环境无关的网关模板或客户现有网关。
上述门槛完成并记录镜像 digest、迁移版本和恢复演练后,才能新增可交付的应用 Compose。
上述门槛完成并记录镜像 digest、迁移版本和恢复演练后,才能形成完整的可交付应用编排。
+74
View File
@@ -0,0 +1,74 @@
name: ${BACKEND_COMPOSE_PROJECT_NAME:-ai-soulmate-backend}
services:
backend:
image: ${BACKEND_IMAGE:?BACKEND_IMAGE is required}
restart: unless-stopped
environment:
APP_ENV: ${APP_ENV:-production}
DATABASE_URL: postgresql://${POSTGRES_USER:?POSTGRES_USER is required}:${POSTGRES_PASSWORD:?POSTGRES_PASSWORD is required}@postgres:5432/${POSTGRES_DB:?POSTGRES_DB is required}
REDIS_URL: redis://:${REDIS_PASSWORD:?REDIS_PASSWORD is required}@redis:6379/0
SECRET_KEY: ${SECRET_KEY:?SECRET_KEY is required}
ENCRYPTION_KEY: ${ENCRYPTION_KEY:?ENCRYPTION_KEY is required}
ORDER_NO_SECRET: ${ORDER_NO_SECRET:?ORDER_NO_SECRET is required}
CDK_CODE_PEPPER: ${CDK_CODE_PEPPER:?CDK_CODE_PEPPER is required}
MLKJ_INTEGRATION_KEY: ${MLKJ_INTEGRATION_KEY:?MLKJ_INTEGRATION_KEY is required}
MLKJ_INTEGRATION_SECRET: ${MLKJ_INTEGRATION_SECRET:?MLKJ_INTEGRATION_SECRET is required}
PRINT_CLIENT_SHARED_TOKEN: ${PRINT_CLIENT_SHARED_TOKEN:?PRINT_CLIENT_SHARED_TOKEN is required}
OSS_PROVIDER: minio
OSS_ENDPOINT: http://minio:9000
OSS_BUCKET_NAME: ${MINIO_BUCKET:?MINIO_BUCKET is required}
OSS_ACCESS_KEY_ID: ${MINIO_APP_ACCESS_KEY:?MINIO_APP_ACCESS_KEY is required}
OSS_ACCESS_KEY_SECRET: ${MINIO_APP_SECRET_KEY:?MINIO_APP_SECRET_KEY is required}
OSS_PUBLIC_ENDPOINT: ${OSS_PUBLIC_ENDPOINT:?OSS_PUBLIC_ENDPOINT is required}
OSS_AUTO_CONFIGURE_CORS: "false"
CORS_ALLOWED_ORIGINS: ${CORS_ALLOWED_ORIGINS:?CORS_ALLOWED_ORIGINS is required}
AI_SOULMATE_PUBLIC_URL: ${AI_SOULMATE_PUBLIC_URL:?AI_SOULMATE_PUBLIC_URL is required}
FRONTEND_URL: ${FRONTEND_URL:?FRONTEND_URL is required}
TRIPO3D_API_KEY: ${TRIPO3D_API_KEY:-}
TRIPO3D_BASE_URL: ${TRIPO3D_BASE_URL:-https://api.tripo3d.com/v2/openapi}
TRIPO3D_DEFAULT_MODEL_VERSION: ${TRIPO3D_DEFAULT_MODEL_VERSION:-v3.1-20260211}
PAYMENT_V2_ENABLED: "false"
ALLOW_DEV_VERIFICATION_CODE_RESPONSE: "false"
UPLOAD_DIR: /app/uploads
TZ: ${TZ:-Asia/Shanghai}
ports:
- "${BACKEND_BIND_ADDRESS:-127.0.0.1}:${BACKEND_HOST_PORT:-3001}:3000"
volumes:
- backend_uploads:/app/uploads
- backend_logs:/app/logs
healthcheck:
test:
- CMD
- python
- -c
- |
import json, urllib.request
result = json.load(urllib.request.urlopen("http://127.0.0.1:3000/api/health", timeout=5))
assert result.get("status") == "healthy" and result.get("database") == "connected"
interval: 10s
timeout: 6s
retries: 9
start_period: 30s
mem_limit: ${BACKEND_MEMORY_LIMIT:-4g}
cpus: ${BACKEND_CPU_LIMIT:-2.0}
security_opt:
- no-new-privileges:true
logging:
driver: json-file
options:
max-size: 10m
max-file: "3"
networks:
- internal
volumes:
backend_uploads:
name: ai-soulmate-backend-uploads
backend_logs:
name: ai-soulmate-backend-logs
networks:
internal:
name: ${DOCKER_NETWORK_NAME:-ai-soulmate-internal}
external: true
+8 -1
View File
@@ -63,9 +63,10 @@ services:
environment:
MINIO_ROOT_USER: ${MINIO_ROOT_USER:?MINIO_ROOT_USER is required}
MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD:?MINIO_ROOT_PASSWORD is required}
MINIO_API_CORS_ALLOW_ORIGIN: ${MINIO_API_CORS_ALLOW_ORIGIN:-http://localhost:8080,http://127.0.0.1:8080}
TZ: ${TZ:-Asia/Shanghai}
ports:
- "127.0.0.1:${MINIO_API_HOST_PORT:-9000}:9000"
- "${MINIO_API_BIND_ADDRESS:-127.0.0.1}:${MINIO_API_HOST_PORT:-9000}:9000"
- "127.0.0.1:${MINIO_CONSOLE_HOST_PORT:-9001}:9001"
volumes:
- minio_data:/data
@@ -95,11 +96,17 @@ services:
MINIO_ROOT_USER: ${MINIO_ROOT_USER:?MINIO_ROOT_USER is required}
MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD:?MINIO_ROOT_PASSWORD is required}
MINIO_BUCKET: ${MINIO_BUCKET:?MINIO_BUCKET is required}
MINIO_APP_ACCESS_KEY: ${MINIO_APP_ACCESS_KEY:?MINIO_APP_ACCESS_KEY is required}
MINIO_APP_SECRET_KEY: ${MINIO_APP_SECRET_KEY:?MINIO_APP_SECRET_KEY is required}
entrypoint: ["/bin/sh", "-ec"]
command:
- |
mc alias set local http://minio:9000 "$$MINIO_ROOT_USER" "$$MINIO_ROOT_PASSWORD"
mc mb --ignore-existing "local/$$MINIO_BUCKET"
if ! mc admin user info local "$$MINIO_APP_ACCESS_KEY" >/dev/null 2>&1; then
mc admin user add local "$$MINIO_APP_ACCESS_KEY" "$$MINIO_APP_SECRET_KEY"
fi
mc admin policy attach local readwrite --user "$$MINIO_APP_ACCESS_KEY"
mem_limit: 256m
cpus: 0.5
logging: