ulthon/ulthon_admin
1
0
Fork 0
mirror of https://gitee.com/ulthon/ulthon_admin.git synced 2026-07-01 15:32:48 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
748307e826f653774e80d9c9861e65dfca523609
ulthon_admin/source/stack/README.md
augushong b44fcfd86c feat(stack): 新增 stack 模式管理功能 
- 新增 `php think admin:stack:mode` 命令，支持 list/use/current/rollback 操作
- 新增 StackModeService 服务，负责模式切换、备份与回滚逻辑
- 在 source/stack/ 目录下添加 default、full、base-build 三种模式的配置文件
- 更新 UlthonAdminService 以注册新的命令行工具
2026-04-24 23:20:13 +08:00

1.4 KiB
Raw Blame History

Stack 模式目录规范

本目录用于维护“模式化生效文件”，由 php think admin:stack:mode 命令读取并覆盖到仓库根目录。

目录结构

  • source/stack/stack.json：全局清单，定义 default_mode、managed_files、modes 元数据。
  • source/stack/default/：默认行为基线目录。
  • source/stack/{mode}/：具体模式目录，按“仓库相对路径”放置文件。

default 目录规则（强约束）

  • source/stack/default/ 必须与代码库默认行为一致。
  • 当默认行为文件变更时（如 Dockerfile、docker-compose.yaml、.gitea/workflows/build-and-deploy.yml），必须同步更新 default 目录对应文件。
  • 该规则通过目录维护规范与代码评审保障，不作为每次切换命令的运行时阻断条件。

模式覆盖规则

  • 仅允许覆盖 stack.json 的 managed_files 中声明的文件。
  • 切换时按“目标模式优先，default 模式兜底”解析最终文件内容：
    • 目标模式提供某文件：使用目标模式文件；
    • 目标模式未提供某文件：回落使用 default 目录对应文件。
  • 首期固定模式：default、full、base-build。

基础镜像说明

  • base-build/docker/Dockerfile.base 为基础镜像构建文件，默认标记为作者维护范围（author_only=true）。
  • 推荐标签策略：latest + 时间戳（如 20260424120000）。