feat(deploy): release.sh 发版脚本,固化「镜像 tag 只增不改」
- 对外 tag 用 ipass-1.0.N:每有一次改动 +1 推新 tag,绝不覆盖已推送的 tag (覆盖会让远端 pull 内容与本地缓存 / rollback-* 标签错位 → 回滚选错镜像) - release.sh:校验 git 工作区干净 → docker manifest inspect 拦同名 tag → DOCKER_BUILDKIT=0 经典构建 → 推送 → 打印 .11 控制面更新命令 - readme §12.6 新增「镜像发版与 tag 约定」+ tag 对照表;§12.5 示例改用最新 tag - CLAUDE.md 硬约定新增「发版」条 + 「发版(本机)」小节 已推送 ipass-1.0.1(digest 226321bec…,= base_url 端口跟随 Host 的修复版)
This commit is contained in:
1 parent
2f21f4b1c5
commit
0266a48103
3 files changed
+137
-1
No files matched your search
@@ -339,6 +339,12 @@ carol `llm_rpm=2`、dave `llm_daily=2`(限流断言用)。夹具上游含 **
|
||||
- **前端隐藏元素必须靠 `[hidden]{display:none!important}` 兜底**:author 样式的 `display`
|
||||
会盖掉 UA 的 `display:none`(本项目踩过)。
|
||||
|
||||
**发版**
|
||||
|
||||
- **镜像 tag 只增不改**:`ipass-1.0.0` → `1.0.1` → `1.0.2` …… 每有一次改动就 +1,走
|
||||
`bash deploy/release.sh <tag>`;**绝不覆盖已推送过的 tag**(覆盖会让远端内容与本地缓存 /
|
||||
`rollback-*` 标签错位 → 回滚选错镜像)。详见「发版(本机)」一节。
|
||||
|
||||
## 常用操作
|
||||
|
||||
```bash
|
||||
@@ -375,6 +381,22 @@ curl -s -b /tmp/c.txt https://mdm.mayishangshu.cn:18098/api/admin/domains
|
||||
curl -H "Host: demo.yourdomain.com" http://127.0.0.1/
|
||||
```
|
||||
|
||||
### 发版(本机):`deploy/release.sh` —— **tag 只增不改**
|
||||
|
||||
```bash
|
||||
bash deploy/release.sh 1.0.2 # 构建 → 打 tag → 推送 → 打印远程更新命令
|
||||
bash deploy/release.sh 1.0.2 # 再跑:远端同名 tag 已存在 → 拒绝
|
||||
DRY_RUN=1 bash deploy/release.sh 1.0.3 # 只构建不推送
|
||||
```
|
||||
|
||||
- 对外 tag 形如 `ipass-1.0.0` / `ipass-1.0.1` / …:**每有一次改动就 +1 推新 tag,
|
||||
绝不覆盖已推送过的 tag**。同名 tag 覆盖会让远端 `pull` 到的内容与本地缓存 / 已打的
|
||||
`rollback-*` 标签错位 → 回滚选错镜像,也没法从 tag 判断线上是哪一版。
|
||||
- 脚本用 `docker manifest inspect` 探测远端,**同名 tag 存在即拒发**(需先 `docker login`);
|
||||
发版前校验 `git status` 干净,保证 **tag ↔ commit** 一一对应。
|
||||
- 本机必须走经典构建器(脚本已内置 `DOCKER_BUILDKIT=0`):buildx 写 activity 会被沙箱拦 rename。
|
||||
- 发完之后在 .11 上更新走下一节的控制面,**`image` 显式填新 tag**。
|
||||
|
||||
### 生产更新(.11):`deploy/update-ipass.sh`
|
||||
|
||||
镜像推到 Aliyun CR 后,在 .11 上跑这一个脚本即可(**不要手写 `docker run` 参数**):
|
||||
|
||||
Executable
+88
@@ -0,0 +1,88 @@
|
||||
#!/usr/bin/env bash
|
||||
# ---------------------------------------------------------------------------
|
||||
# iPass 镜像发版:构建 → 打 tag → 推送阿里云 CR
|
||||
#
|
||||
# 约定(重要):**tag 只增不改**
|
||||
# 对外 tag 形如 `ipass-1.0.0` / `ipass-1.0.1` / `ipass-1.0.2` ……
|
||||
# 每有一次代码变更就 +1 推新 tag,**绝不覆盖已推送过的 tag**。
|
||||
# 理由:同名 tag 覆盖后,`docker pull` 拿到的内容与本地缓存/回滚标签对不上,
|
||||
# 回滚会选错镜像,而且没法从 tag 判断线上到底跑的是哪一版。
|
||||
#
|
||||
# 用法:
|
||||
# bash deploy/release.sh 1.0.2 # → .../ssw188/nginx:ipass-1.0.2
|
||||
# bash deploy/release.sh ipass-1.0.2 # 写全也可以
|
||||
# DRY_RUN=1 bash deploy/release.sh 1.0.2 # 只构建不推送
|
||||
# ---------------------------------------------------------------------------
|
||||
set -euo pipefail
|
||||
|
||||
REGISTRY="${REGISTRY:-crpi-yscq976uwza88qap.cn-shenzhen.personal.cr.aliyuncs.com}"
|
||||
REPO="${REPO:-ssw188/nginx}"
|
||||
PREFIX="${PREFIX:-ipass-}"
|
||||
|
||||
TAG="${1:-}"
|
||||
if [ -z "$TAG" ]; then
|
||||
echo "用法: bash deploy/release.sh <tag>"
|
||||
echo " 例: bash deploy/release.sh 1.0.2 → $REGISTRY/$REPO:${PREFIX}1.0.2"
|
||||
echo
|
||||
echo "远端已有的 ${PREFIX}* tag(示例命令,需先 docker login):"
|
||||
echo " docker images --format '{{.Repository}}:{{.Tag}}' | grep ${PREFIX} || true"
|
||||
exit 2
|
||||
fi
|
||||
case "$TAG" in
|
||||
"$PREFIX"*) ;;
|
||||
*) TAG="${PREFIX}${TAG}" ;;
|
||||
esac
|
||||
|
||||
IMAGE="$REGISTRY/$REPO:$TAG"
|
||||
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$ROOT"
|
||||
|
||||
# --- 0) 工作区必须干净:tag 必须能对应到一个 commit ------------------------
|
||||
if [ -n "$(git status --porcelain)" ]; then
|
||||
echo "✗ 工作区有未提交改动 —— 先提交再发版(否则 tag 与源码对不上)"
|
||||
git status --short
|
||||
exit 1
|
||||
fi
|
||||
COMMIT="$(git rev-parse --short HEAD)"
|
||||
|
||||
# --- 1) tag 只增不改:远端已有同名 tag 直接拒绝 ------------------------------
|
||||
if docker manifest inspect "$IMAGE" >/dev/null 2>&1; then
|
||||
echo "✗ 远端已存在 $IMAGE"
|
||||
echo " 按约定 tag 只增不改 —— 请换更大的号(如 ${PREFIX}1.0.$(( ${TAG##*.} + 1 )))"
|
||||
exit 1
|
||||
else
|
||||
echo "· 远端未见 $IMAGE(或无法查询,继续构建)"
|
||||
fi
|
||||
|
||||
# --- 2) 构建 ---------------------------------------------------------------
|
||||
# 本机(OrbStack)必须用经典构建器:buildx 写 activity 会被沙箱拦 rename。
|
||||
echo "→ 构建中(commit $COMMIT)"
|
||||
DOCKER_BUILDKIT=0 docker build -t "$IMAGE" "$ROOT"
|
||||
ID="$(docker image inspect --format '{{.Id}}' "$IMAGE")"
|
||||
echo " 镜像 id: $ID"
|
||||
|
||||
# --- 3) 推送 ---------------------------------------------------------------
|
||||
if [ "${DRY_RUN:-0}" = "1" ]; then
|
||||
echo "· DRY_RUN=1 —— 跳过推送。要推: docker push $IMAGE"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
echo "→ 推送 $IMAGE"
|
||||
docker push "$IMAGE"
|
||||
|
||||
# --- 4) 收尾:打印下一步(远程更新命令) ------------------------------------
|
||||
cat <<EOF
|
||||
|
||||
✓ 发版完成
|
||||
tag : $TAG
|
||||
image : $IMAGE
|
||||
commit : $COMMIT
|
||||
image id: $ID
|
||||
|
||||
在 .11 上更新(控制面 §12.5;把 <token> 换成 ~/.ipass-agent-token 的内容):
|
||||
|
||||
A=http://192.168.1.11:18099; T='Authorization: Bearer <token>'
|
||||
curl -s -H "\$T" -H 'Content-Type: application/json' \\
|
||||
-d '{"image":"$IMAGE"}' \$A/update # 返回 job id
|
||||
curl -s -H "\$T" \$A/jobs/<job-id>?offset=0 # 增量取日志,看 7 步是否全过
|
||||
EOF
|
||||
@@ -593,17 +593,43 @@ A=http://192.168.1.11:18099; T='Authorization: Bearer <token>'
|
||||
|
||||
curl -s -H "$T" $A/status # 先看现状
|
||||
curl -s -H "$T" -H 'Content-Type: application/json' \
|
||||
-d '{"image":"crpi-…/ssw188/nginx:ipass-1.0.0"}' $A/update # 更新,返回 job id
|
||||
-d '{"image":"crpi-…/ssw188/nginx:ipass-1.0.1"}' $A/update # 更新,返回 job id
|
||||
curl -s -H "$T" $A/jobs/<job-id> # 拉执行日志(7 步全记录)
|
||||
curl -s -H "$T" -H 'Content-Type: application/json' -d '{}' $A/rollback # 出事回滚
|
||||
```
|
||||
|
||||
> `image` 填**当前要上的 tag**(§12.6 的约定:只增不改,发新版就换新号,别覆盖旧号)。
|
||||
> 不传 `image` 时用服务启动时的默认值(`--image` 指定,缺省 `ipass-1.0.0`)。
|
||||
|
||||
**安全**:这个服务能删/起容器,**等价服务器上的 docker 权限**,务必做到
|
||||
① **必须设 token**(别用空/弱口令);② 只在内网监听(默认 `0.0.0.0`,可 `--bind 127.0.0.1`
|
||||
或加防火墙);③ **绝不暴露到公网**。`/data` 对 `api_key` 已脱敏,但 `domains.json` 会原样返回。
|
||||
|
||||
> `update-ipass.sh`(§12.4)仍然保留:没有 python3、或服务没起来时的应急手段。
|
||||
|
||||
### 12.6 镜像发版与 tag 约定(只增不改)
|
||||
|
||||
对外镜像 tag 形如 **`ipass-1.0.0` / `ipass-1.0.1` / `ipass-1.0.2` ……**:
|
||||
**每有一次代码变更就 +1 推新 tag,绝不覆盖已推送过的 tag。**
|
||||
|
||||
```bash
|
||||
bash deploy/release.sh 1.0.2 # 构建 → 打 tag → 推送 → 打印远程更新命令
|
||||
bash deploy/release.sh 1.0.2 # 再跑一次:远端同名 tag 已存在 → 直接拒绝
|
||||
DRY_RUN=1 bash deploy/release.sh 1.0.3 # 只构建不推送
|
||||
```
|
||||
|
||||
- **为什么只增不改**:同名 tag 被覆盖后,远端 `pull` 到的内容与本地缓存 / 已打的
|
||||
`rollback-<时间>` 标签对不上 → 回滚会选错镜像;也没法再从 tag 判断线上跑的是哪一版。
|
||||
(控制面的回滚判重已改为按**镜像 id** 而非 tag 名比较,但 tag 本身仍应保持不可变。)
|
||||
- 脚本用 `docker manifest inspect` 探测远端,**同名 tag 已存在即拒绝发版**(需先 `docker login`)。
|
||||
- 脚本先校验 `git status` 干净,保证 **tag ↔ commit** 一一对应(提交里记下 tag)。
|
||||
- 本机构建必须走经典构建器(脚本已内置 `DOCKER_BUILDKIT=0`):buildx 写 activity 会被沙箱拦 rename。
|
||||
|
||||
| tag | 内容 |
|
||||
| --- | --- |
|
||||
| `ipass-1.0.0` | 首个完整版(上游多模型 / 模型发现 / 用量统计)。⚠️ 该 tag 在 `base_url` 修复后被**同 tag 覆盖**过(digest 由 `046a9dd7…` 变为 `226321bec…`),是历史遗留;此后不再覆盖。 |
|
||||
| `ipass-1.0.1` | `base_url` 端口跟随调用方 `Host`(修复 .11 上 88 端口回显地址打不通)。digest `226321bec…`,与 `ipass-1.0.0` 覆盖后的内容相同。**tag 只增不改的约定从这一版生效。** |
|
||||
|
||||
---
|
||||
|
||||
## 13. 安全
|
||||
|
||||
Reference in new issue
Block a user