diff --git a/CLAUDE.md b/CLAUDE.md index 64dd4e5..4798d19 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -418,6 +418,12 @@ set -a; . ./.env; set +a 已放行本项目常用命令(`cd`/`ls`/`git` 只读/`bash deploy`/`docker build|push`/内网 `curl`/`python3` …); 破坏性命令(`rm` / `sudo` / `docker rm` / `git push --force` / `git reset --hard`)显式 `deny`,仍会被硬拦。 - 白名单是**本机**配置:换机器要重拷 `.env` 与 `.workbuddy/settings.local.json`。 +- **`.env` 是只读的**:沙箱会拦写入(`sed -i .env` → `Operation not permitted`), + 改它只能由用户手动编辑。所以发版后 `IPASS_IMAGE_TAG` 的同步要**明确交回用户**, + 别用 `cp` 备份到 `/tmp`(那是凭据副本,必须立刻删)。 +- ⚠️ **发版后 `.env` 的 `IPASS_IMAGE_TAG` 必须同步成新 tag**:`update` 不带 tag 时用它做缺省值, + 落后即**静默降级**回旧镜像(真踩过:1.0.14 发完,`.env` 仍停在 1.0.9)。 + `agent.sh verify` 已加漂移告警(不一致时打印 `!`,不判失败)。 ### ⚠️ 含凭据的命令**不要手敲**,一律走 `deploy/agent.sh` diff --git a/deploy/agent.sh b/deploy/agent.sh index 0208686..aabd315 100755 --- a/deploy/agent.sh +++ b/deploy/agent.sh @@ -127,6 +127,18 @@ cmd_verify() { echo "· 镜像: $img" echo "· digest: ${dig##*@}" + # 0) 默认 tag 漂移告警:.env 的 IPASS_IMAGE_TAG 落后于线上时, + # 裸 `update`(不带 tag)会**静默降级**回旧镜像 —— 只提示,不判失败。 + # 发版一条龙结尾必跑 verify,所以这里是一次固定的自检点。 + if [ -z "$DEFAULT_TAG" ]; then + echo " ! .env 未设 IPASS_IMAGE_TAG —— 裸 update 无缺省 tag(须显式传)" + elif [ "$img" = "${REGISTRY}:${DEFAULT_TAG}" ] || [ "$img" = "$DEFAULT_TAG" ]; then + echo " ✓ .env 默认 tag 与线上一致($DEFAULT_TAG)" + else + echo " ! .env 的 IPASS_IMAGE_TAG=$DEFAULT_TAG 落后于线上(${img##*:})" + echo " 裸 \`bash deploy/agent.sh update\` 会退回 $DEFAULT_TAG —— 请把 .env 同步成 ${img##*:}" + fi + echo "· 登录 ${LIVE_HOST}:${LIVE_PORT}(-> ${LIVE_IP})" if ! live_login "$jar"; then echo " ✗ 登录失败(HTTP 非 200)"; rm -f "$jar"; return 1 diff --git a/readme.md b/readme.md index f83711d..24bef27 100755 --- a/readme.md +++ b/readme.md @@ -781,6 +781,10 @@ DRY_RUN=1 bash deploy/release.sh 1.0.3 # 只构建不推送 ⚠️ **脚本不校验是否已 push**——1.0.12 曾发版成功但代码没推到 Gitea,远端看不到。 **发版前先 `git push`**,或直接走 `bash deploy/agent.sh release `(推荐,一条龙)。 - 本机构建必须走经典构建器(脚本已内置 `DOCKER_BUILDKIT=0`):buildx 写 activity 会被沙箱拦 rename。 +- ⚠️ **发版后把 `.env` 的 `IPASS_IMAGE_TAG` 同步成新 tag。** `update` 不带 tag 时用它做缺省值, + 它落后于线上就会**静默降级**回旧镜像(真踩过:1.0.14 发完,`.env` 还停在 1.0.9)。 + `agent.sh verify` 已加一条**漂移告警**(`.env` 默认 tag 与线上不一致时打印 `!` 提示,不判失败), + 发版一条龙结尾必跑 verify,所以每次都会被提醒。该文件受沙箱**写入保护**(凭据文件),需人工改。 | tag | 内容 | | --- | --- |