Files
ulthon_admin/source/stack
augushong 537f178fa5
Some checks failed
build-and-deploy / 直传代码并部署到 Host15 (push) Failing after 11s
ci: 更新部署配置以支持直接分发代码
- 将工作流容器镜像更换为包含 PHP 和 Composer 的专用镜像
- 在工作流中添加 Composer 依赖安装步骤,配置私有镜像源
- 修改所有 docker-compose.yaml 文件,将卷映射从多个子目录改为映射整个项目根目录,简化部署步骤
2026-05-01 20:45:04 +08:00
..

Stack 模式目录规范

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

目录结构

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

default 目录规则(强约束)

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

模式覆盖规则

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

基础镜像说明

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