Organize living documentation and directory guides

2026-10-18 20:58:42 +08:00
parent 6fa95b64b0
commit 8bbe78e01e
30 changed files with 674 additions and 396 deletions
@@ -0,0 +1,14 @@
+# 检查与发布脚本
+
+所有构建、测试、冒烟和部署脚本只在用户指定的远端环境运行。本目录 README 负责定位与副作用边界；全局流程见 [验证](../docs/operations/validation.md) 和 [部署](../docs/operations/deployment.md)。
+
+| 文件 | 入口与副作用 |
+| --- | --- |
+| [check.sh](check.sh) | fmt 检查、workspace 测试、严格 Clippy；会使用 Cargo 依赖和构建产物 |
+| [smoke.py](smoke.py) | 标准库 Python 脚本；构建后用 Cargo metadata 定位 debug 二进制，支持 CARGO_TARGET_DIR；临时 SQLite 数据、HTTP 探测和 SIGTERM 退出，不改生产配置 |
+| [ci-ces-control.sh](ci-ces-control.sh) | 需要 ASTER_RELEASE_SHA；构建 ci 镜像、创建临时网络／PostgreSQL／检查容器，运行全部检查；退出清理临时容器和网络，保留专属远端 Cargo 缓存卷 |
+| [deploy-ces-control.sh](deploy-ces-control.sh) | ces-control root 执行；校验已构建镜像、锁定发布、保留密码和数据、验证新服务后切换 current，失败尝试恢复旧版；保留镜像 |
+
+CI／部署使用的镜像与路径仅属于本项目，禁止改动其他项目和共享 Runner。smoke.py 临时选择端口后再启动宿主，存在小的端口竞争窗口，指定环境遇到冲突可重试。
+
+调整变量同步 [配置](../docs/operations/configuration.md)，调整端点／命令同步 [运行指南](../docs/operations/README.md)，调整脚本名同步 [工作流](../.gitea/workflows/README.md)。返回 [项目入口](../README.md)。