Skip to content

一分钟搭建影视站,支持Docker等部署方式

fix(ci): merge 打标签改用单行 JSON+jq 展开,修复多行 tags 内插只生效第一个 tag;sync-hub 升级为两侧标签对齐工具

bestZweic621195403ee
diff --git a/.github/workflows/docker-publish.yml b/.github/workflows/docker-publish.yml
index 241e079..982a09f 100644
--- a/.github/workflows/docker-publish.yml
+++ b/.github/workflows/docker-publish.yml
@@ -170,14 +170,15 @@ jobs:
# 纯 registry 元数据操作:把 build job 已推上来的两个架构 digest
# 组装成多架构 manifest 并打标签。不要在这里用 build-push-action——
# 那会触发一次重新构建(无 context 时更会直接失败)。
- # 标签改从各自 meta 步骤的 outputs.tags 展开:metadata-action 会导出
- # 同名的 DOCKER_METADATA_OUTPUT_JSON 环境变量,跑两次会互相覆盖,
- # 不能再用该环境变量区分两个 registry。
+ # 标签从各自 meta 步骤的 outputs.json(单行 JSON)经 jq 展开:
+ # 1) 不要用 DOCKER_METADATA_OUTPUT_JSON 环境变量——两个 meta 步骤会互相覆盖;
+ # 2) 不要内插多行的 outputs.tags——实测在命令替换里只有第一个 tag 生效
+ # (v2.12.5/v2.12.6 两次发布都只打上了版本号 tag,主.次 与 latest 未更新)。
- name: 创建并推送多架构 manifest(GHCR)
working-directory: ${{ runner.temp }}/digests
run: |
docker buildx imagetools create \
- $(printf -- '-t %s ' ${{ steps.meta.outputs.tags }}) \
+ $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< '${{ steps.meta.outputs.json }}') \
$(printf '${{ steps.image.outputs.name }}@sha256:%s ' *)
# 跨 registry 复制:从 GHCR 的架构 digest 拉取后推到 Docker Hub,
@@ -187,5 +188,5 @@ jobs:
working-directory: ${{ runner.temp }}/digests
run: |
docker buildx imagetools create \
- $(printf -- '-t %s ' ${{ steps.meta-hub.outputs.tags }}) \
+ $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< '${{ steps.meta-hub.outputs.json }}') \
$(printf '${{ steps.image.outputs.name }}@sha256:%s ' *)
diff --git a/.github/workflows/docker-sync-hub.yml b/.github/workflows/docker-sync-hub.yml
index cfef121..2558651 100644
--- a/.github/workflows/docker-sync-hub.yml
+++ b/.github/workflows/docker-sync-hub.yml
@@ -1,23 +1,23 @@
name: docker-sync-hub
-# 把 GHCR 上已构建的多架构镜像复制到 Docker Hub(不重新构建,镜像 digest 一致)。
+# 镜像标签对齐/补救工具:以 GHCR 上某个版本 tag 的 digest 为源,
+# 把「主.次」与 latest 标签在 GHCR 与 Docker Hub 两侧补齐并校验一致。
+# 不重新构建,纯 registry 元数据操作,几秒完成。
# 用途:
-# - 双发布上线前的存量版本补推(如 v2.12.3 的镜像当时只推了 GHCR);
-# - 主流程中 Docker Hub 侧失败时的手动补救。
-# 在 Actions 页面手动触发,输入版本号(如 2.12.3,兼容 v 前缀),
-# 会一并同步同版本的「主.次」与 latest 标签。
-# 源镜像 ghcr.io/librespark/libretv 是公开镜像,跨仓库读取无需特殊凭据。
+# - 主流程 merge 打标签不完整时的补救(如 v2.12.5/v2.12.6 只打上了版本号 tag);
+# - 两个 registry 标签不一致时的手动对齐。
+# 在 Actions 页面手动触发,输入版本号(如 2.12.6,兼容 v 前缀)。
on:
workflow_dispatch:
inputs:
tag:
- description: '要同步的版本号(如 2.12.3),将连同 主.次 与 latest 一起推送到 Docker Hub'
+ description: '要对齐的版本号(如 2.12.6),将以该版本的 digest 为源补齐 主.次 与 latest'
required: true
default: ''
permissions:
- packages: read
+ packages: write
env:
GHCR_IMAGE: ghcr.io/librespark/libretv
@@ -29,7 +29,7 @@ jobs:
steps:
- uses: docker/setup-buildx-action@v3
- # 源为公开镜像,此登录只为私有化部署场景兜底;失败不阻塞
+ # 源镜像为公开包,此登录主要为 GHCR 写标签授权
- uses: docker/login-action@v3
with:
registry: ghcr.io
@@ -42,32 +42,54 @@ jobs:
username: ${{ secrets.DOCKER_USERNAME }}
password: ${{ secrets.DOCKER_PASSWORD }}
- - name: 复制多架构镜像与标签到 Docker Hub
+ - name: 以版本 digest 为源补齐两个 registry 的标签
run: |
version="${{ inputs.tag }}"
version="${version#v}"
if ! [[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
- echo "::error::版本号格式应为 主.次.修订(如 2.12.3),收到:${version}"
+ echo "::error::版本号格式应为 主.次.修订(如 2.12.6),收到:${version}"
exit 1
fi
minor="${version%.*}"
- echo "同步 ${GHCR_IMAGE}:${version} → ${DOCKERHUB_IMAGE}(标签:${version} ${minor} latest)"
+ digest=$(docker buildx imagetools inspect "${GHCR_IMAGE}:${version}" --format '{{.Manifest.Digest}}')
+ if [ -z "$digest" ]; then
+ echo "::error::GHCR 上不存在 ${GHCR_IMAGE}:${version}"
+ exit 1
+ fi
+ echo "源:${GHCR_IMAGE}:${version} @ ${digest}"
+ echo "补齐标签:GHCR[${minor} latest] / Docker Hub[${version} ${minor} latest]"
+ docker buildx imagetools create \
+ -t "${GHCR_IMAGE}:${minor}" \
+ -t "${GHCR_IMAGE}:latest" \
+ "${GHCR_IMAGE}@${digest}"
docker buildx imagetools create \
-t "${DOCKERHUB_IMAGE}:${version}" \
-t "${DOCKERHUB_IMAGE}:${minor}" \
-t "${DOCKERHUB_IMAGE}:latest" \
- "${GHCR_IMAGE}:${version}"
+ "${GHCR_IMAGE}@${digest}"
- - name: 校验 Docker Hub 侧 digest 与 GHCR 一致
+ - name: 校验两侧全部标签 digest 一致
run: |
version="${{ inputs.tag }}"
version="${version#v}"
- src=$(docker buildx imagetools inspect "${GHCR_IMAGE}:${version}" --format '{{json .Manifest.Digest}}')
- dst=$(docker buildx imagetools inspect "${DOCKERHUB_IMAGE}:${version}" --format '{{json .Manifest.Digest}}')
- echo "GHCR digest: ${src}"
- echo "Docker Hub digest: ${dst}"
- if [ "$src" != "$dst" ]; then
- echo "::error::两侧 digest 不一致,同步未生效"
- exit 1
- fi
- echo "digest 一致,同步完成"
+ minor="${version%.*}"
+ src=$(docker buildx imagetools inspect "${GHCR_IMAGE}:${version}" --format '{{.Manifest.Digest}}')
+ fail=0
+ check() {
+ local registry=$1 repo=$2 tag=$3
+ local got
+ got=$(docker buildx imagetools inspect "${registry}/${repo}:${tag}" --format '{{.Manifest.Digest}}')
+ if [ "$got" = "$src" ]; then
+ echo "OK ${registry}/${repo}:${tag} @ ${got}"
+ else
+ echo "FAIL ${registry}/${repo}:${tag} @ ${got}(期望 ${src})"
+ fail=1
+ fi
+ }
+ check ghcr.io librespark/libretv "$version"
+ check ghcr.io librespark/libretv "$minor"
+ check ghcr.io librespark/libretv latest
+ check registry-1.docker.io bestzwei/libretv "$version"
+ check registry-1.docker.io bestzwei/libretv "$minor"
+ check registry-1.docker.io bestzwei/libretv latest
+ exit $fail