个人项目通用配置模板集合，新项目按需取用，替换 <占位符> 即可。
| 模板 |
说明 |
| docker-compose.yml |
本地开发编排（MySQL + Redis 必选，Nacos / Kafka / Prometheus+Grafana 可选），全 healthcheck；应用服务在 IDE 中运行。只管本地依赖：生产基础设施内嵌在 deploy workflow 中，生产应用服务由各项目 deploy/prod-services.yaml 声明，三者不要合并 |
| 模板 |
说明 |
| .env.example |
.env 模板（MySQL + Redis + Nacos + AI 密钥 + COS + Vite 前端变量），按项目增减 |
| 模板 |
说明 |
| deploy-template.yml |
单文件生产部署：单镜像/多镜像双模式；仅推 Aliyun ACR（GHCR 已弃用，部署机国内拉取秒级）；构建为矩阵作业（每镜像一个 job，进度可见）并带跨分支共享层缓存；模板管理 MySQL/PostgreSQL/Redis 基础设施（可选 none 纯应用模式），应用服务可用 deploy/prod-services.yaml 声明 |
- 将
deploy-template.yml 复制到新项目的 .github/workflows/deploy.yml。
- 在 GitHub Actions 中配置以下公共凭据：
- Variables：
ALIYUN_ACR_REGISTRY、ALIYUN_ACR_USERNAME
- Secret：
ALIYUN_ACR_PASSWORD
- 项目根目录默认提供
Dockerfile；基础设施 Compose 内嵌在 workflow 中，无需项目额外维护。
- 手动运行 workflow 时选择部署节点、基础设施（MySQL / PostgreSQL / none）、部署分支和镜像清单。应用容器默认注入
APP_ENV=prod 与 SPRING_PROFILES_ACTIVE=prod。
- 多分支项目：始终用 Use workflow from: main（部署文件只维护一份），用
deploy_ref 选择要构建部署的分支；同一分支的构建自动串行（latest 标签不会被旧构建覆盖），不同分支可并行。构建层缓存在各分支间共享（scope=buildcache）。
- 多镜像项目：在 pre-build 步骤里把构建产物复制到仓库根（Dockerfile 从根 COPY），模板会自动剔除
node_modules/ 与 target/ 再分发给各构建 job。
仓库策略：仅 Aliyun ACR。构建推 ACR 是唯一一段跨境（高峰期可能变慢），部署机拉取纯国内秒级。曾用过 GHCR 双推、aliyun 中转、公共/自建镜像加速器，实测均无法稳定超越直推 ACR 的平均速度，故全部移除。
可选 Variables：
ALIYUN_ACR_IMAGE_NAME：ACR 的 命名空间/仓库，默认 wangshun_build/<GitHub仓库名>。DEPLOY_IMAGES：多镜像清单（JSON 数组），如 [{"name":"user","dockerfile":"Dockerfile.user"},{"name":"app","dockerfile":"Dockerfile.app"}]；name 同时作为镜像 tag 前缀（user-<sha>）。不配置时为单镜像默认（./Dockerfile，tag 直接用 <sha>）。多模块项目在 build job 的 PROJECT PRE-BUILD 注释处插入 Maven/pnpm 预构建步骤。PROJECT_NAME：覆盖 compose 项目名（默认取 GitHub 仓库名）。迁移已有部署栈时必须设置，否则项目级卷名改变会导致数据重新初始化。DATABASE_NAME、DATABASE_USERNAME：生产数据库名称和业务账号，默认均为 app。APP_PORT：应用映射到宿主机的端口，默认 8080。DEPLOY_DOCKERFILE：单镜像模式 Dockerfile 路径，默认 ./Dockerfile（多镜像模式用 DEPLOY_IMAGES）。
应用服务约定（deploy/prod-services.yaml）：
- 模板负责版本身份（SHA 标签、双推、回退、旧镜像清理）与基础设施；项目特有服务（多服务编排、Nacos、网关等）写在仓库内
deploy/prod-services.yaml，镜像一律引用 ${IMAGE_<NAME>} 变量（如 ${IMAGE_USER}），不出现 registry 地址和 tag。
database 选 none 时模板不启动任何基础设施，全部服务由 deploy/prod-services.yaml 定义（适合静态应用、或自带数据库定义需保持卷名连续的项目）。- 项目自有密钥在 workflow 的 deploy job
env: 块中从 Secrets 透传，供 prod-services.yaml 插值。
生产部署还需要 Secrets：DATABASE_PASSWORD、DATABASE_ROOT_PASSWORD（选择 MySQL 时必需）和 REDIS_PASSWORD。GHCR 镜像名自动使用 ${{ github.repository }}，不需要额外配置账号、密码或镜像名。部署目标 aliyun / wsl 同时作为 self-hosted Runner 标签和 GitHub Environment 名称。
- 将
wrangler-template.jsonc 复制到项目根目录 wrangler.jsonc，替换 <占位符>；本地先跑通一次 npx wrangler login && npx wrangler deploy 完成 Worker 创建。
- 在 GitHub Actions 中配置以下凭据：
- Secret：
CLOUDFLARE_API_TOKEN（Cloudflare → My Profile → API Tokens → 用 "Edit Cloudflare Workers" 模板创建）
- 密钥不进 GitHub 也不进
wrangler.jsonc，用 npx wrangler secret put <NAME> 配置一次即可，跨部署持久，Actions 只负责推代码。
- 健康检查与 monorepo 通过可选 Variables 配置：
HEALTH_CHECK_URL：部署后探活的 URL（如 https://<name>.<子域>.workers.dev/health），未配置则跳过。WORKER_DIRECTORY：wrangler.jsonc 所在目录，默认 .。CLOUDFLARE_ACCOUNT_ID：令牌可访问多个 Cloudflare 账号时必填（Dashboard 首页右侧可查）。
