wangchuanli/workbuddy-portal
1
0
派生 0
代码 工单 合并请求 工作流 软件包 项目 发布 百科 活动

fix(发布): push-all.sh 补上 git tag，并补打 v1.2.0 ~ v1.4.0 历史标签

浏览代码 
问题：脚本里只有 docker tag / docker push，**没有 git tag**，所以远程仓库
一直只有软件包、没有版本 tag —— 「某个版本对应哪个提交」只能靠翻 CHANGELOG 猜。
镜像 tag 只说明「注册表里有这个包」，回答不了「这个包是哪份代码构建的」。

tools/push-all.sh：
- 新增**版本预检**（传了版本号时）：从 workbuddy_portal/__init__.py 读
  __version__ 与传入值比对，不一致立刻退出 —— 放在最前面，免得代码和镜像
  都推完了才发现「代码写着 1.4.0、却当 1.5.0 发」
- 新增 git tag -a vX.Y.Z + 推送该 tag，**放在代码与镜像都推成功之后**：
  tag 一旦出现在远端就是「这个版本发过了」的公开声明，不该先于产物出现
- 已存在的 tag 只提示、不改写（指向哪个提交由历史决定）

补打历史标签：v1.2.0 / v1.3.0 / v1.4.0，各指向引入该版本号的那个提交
（1.1.0 在仓库里没有对应提交，故未补）。

文档：
- DEPLOYMENT 7.1 补上「为什么必须有 git tag」与版本预检说明
- DEPLOYMENT 7.4 补上「镜像与 tag 要分别核验」的命令（git ls-remote --tags）
  —— 此前 7.4 只验镜像，正是这个盲区让「没有 tag」一直没被发现

验证：python tools/check_docs.py → 0 处问题；python tools/smoke.py → ok=264 fail=0
这个提交包含在：
wangchuanli
2026-09-18 14:54:48 +08:00
父节点 f36149efc3
当前提交 4720149c20
共修改 3 个文件，包含 107 行新增和 8 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
tools/push-all.sh
+52 -3
查看文件
@@ -3,11 +3,11 @@
# Copyright (c) 2026 Wang Chuanli
# =============================================================================
# 用 Gitea Access Token 一次性完成：推代码 + 推镜像
# 用 Gitea Access Token 一次性完成：推代码 + 推镜像（+ 打 git 版本 tag）
#
# export GITEA_TOKEN=<在 Gitea「设置 → 应用 → 生成令牌」创建，勾 repo + write:package>
# tools/push-all.sh # 推 main + 镜像 latest
# tools/push-all.sh 1.1.0 # 额外打一个版本 tag 并推送
# tools/push-all.sh # 推 main + 镜像 latest，不打版本 tag
# tools/push-all.sh 1.5.0 # 另外打 git tag v1.5.0 与镜像 tag 1.5.0
#
# 设计要点：
# * Token **只从环境变量读**，绝不写进 .git/config、URL 或任何文件。
@@ -17,6 +17,11 @@
# （不会落到 reflog / 进程列表里）。
# * git.iwali.top 有 Let's Encrypt 通配证书，**HTTPS 可用**，
# 所以镜像不需要配 insecure-registries。
#
# v1.5.0 起补上了 **git tag**（第 0 步与第 4 步）：
# 在此之前脚本只打镜像 tag，于是远程仓库里永远只有软件包、没有 git tag ——
# 「某个版本对应哪个提交」只能靠翻 CHANGELOG 猜。现在版本号从
# `workbuddy_portal/__init__.py` 读，发布前先与前缀 v 的字面量对齐。
# =============================================================================
set -eu
@@ -25,12 +30,30 @@ USER="${GITEA_USER:-wangchuanli}"
REPO="${GITEA_REPO:-workbuddy-portal}"
BRANCH="${GITEA_BRANCH:-main}"
TAG="${1:-}"
GIT_TAG=""
IMAGE="$HOST/$USER/$REPO"
: "${GITEA_TOKEN:?请先 export GITEA_TOKEN=<Gitea Access Token（repo + write:package）>}"
cd "$(dirname "$0")/.."
# ---------- 0. 版本一致性预检（早失败，别等代码和镜像都推完了才发现） ----------
if [ -n "$TAG" ]; then
GIT_TAG="v$TAG"
CODE_VER="$(sed -n 's/^__version__[[:space:]]*=[[:space:]]*"\([^"]*\)".*/\1/p' \
workbuddy_portal/__init__.py | head -n 1)"
if [ "$CODE_VER" != "$TAG" ]; then
echo "ERROR: 代码里的版本是「$CODE_VER」，与要发布的「$TAG」不一致。" >&2
echo " 发布前请先把这四处改成同一个版本号（tools/check_docs.py 会校验）：" >&2
echo " workbuddy_portal/__init__.py __version__" >&2
echo " Dockerfile org.opencontainers.image.version" >&2
echo " README.md 特性表里的 | 版本 | vX.Y.Z |" >&2
echo " docs/CHANGELOG.md 首个 ## [X.Y.Z] 标题" >&2
exit 1
fi
echo "==> 版本预检通过：代码与要发布的版本都是 $TAG"
fi
# ---------- 1. 推代码 ----------
echo "==> 推送代码到 https://$HOST/$USER/$REPO.git ($BRANCH)"
AUTH="$(printf '%s:%s' "$USER" "$GITEA_TOKEN" | base64 | tr -d '\r\n')"
@@ -55,6 +78,32 @@ if [ -n "$TAG" ]; then
docker push "$IMAGE:$TAG"
fi
# ---------- 4. git 版本 tag ----------
# 放在最后：**只有代码与镜像都推成功**才落 tag。
# tag 一旦出现在远端就是「这个版本发过了」的公开声明，不该先于产物出现。
if [ -n "$GIT_TAG" ]; then
if git rev-parse -q --verify "refs/tags/$GIT_TAG" >/dev/null; then
# 已存在就只提示、不报错：典型场景是「tag 早就打好了，这次只是补推代码」。
# 指向哪个提交由 git 决定，脚本不去改写已发布的 tag —— 那等于偷偷换掉
# 「v1.5.0 到底是哪份代码」这个答案。
AT="$(git rev-parse --short "$GIT_TAG^{commit}")"
HEAD_SHORT="$(git rev-parse --short HEAD)"
echo "==> git tag $GIT_TAG 已存在（指向 $AT）"
[ "$AT" = "$HEAD_SHORT" ] || echo " 注意：它不是当前 HEAD（$HEAD_SHORT）—— 若这次改了代码，tag 不会跟着动。"
else
echo "==> 创建 git 注解 tag $GIT_TAG"
git tag -a "$GIT_TAG" -m "$REPO $GIT_TAG"
fi
echo "==> 推送 git tag $GIT_TAG"
git -c credential.helper= \
-c http.extraHeader="Authorization: Basic $AUTH" \
push origin "refs/tags/$GIT_TAG"
fi
echo
echo "完成。其他机器拉取："
echo " docker pull $IMAGE:${TAG:-latest}"
if [ -n "$GIT_TAG" ]; then
echo "代码检出该版本："
echo " git fetch --tags && git checkout $GIT_TAG"
fi