Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

ci(gitgud): 版本标签构建、验收并发布 Docker 镜像

longmeidaoc1222a7647bf
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index d3a4b97c0..4f082fc14 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -195,6 +195,19 @@ smoke-windows:
- '& ./release/ci_windows.ps1 smoke'
- if ($LASTEXITCODE -ne 0) { throw 'Windows 独立制品验收失败' }
+publish-docker:
+ stage: publish
+ tags: [peach-windows]
+ rules: !reference [.release-linux, rules]
+ needs: [validate-release]
+ resource_group: peach-docker-publication
+ environment:
+ name: release
+ action: prepare
+ script:
+ - '& ./scripts/ci_windows.ps1 docker'
+ - if ($LASTEXITCODE -ne 0) { throw 'Docker 镜像发布失败' }
+
publish-release:
extends: .release-linux
stage: publish
diff --git a/docs/DOCKER.md b/docs/DOCKER.md
index fd3fb5182..94f0006f4 100644
--- a/docs/DOCKER.md
+++ b/docs/DOCKER.md
@@ -1,6 +1,6 @@
# Docker 部署
-Peach 的 Docker 镜像用于单人 VPS 与 NAS,通过浏览器管理,镜像仓库为 [longmeidao/peach](https://hub.docker.com/r/longmeidao/peach)。`edge` 随 `master` 分支构建更新,版本号标签对应发布提交。当前镜像目标为 `linux/amd64`;ARM NAS 尚未验收。2026-10-15 在 WSL 的独立 Docker Engine 中,用正式锁定依赖通过空数据卷初始化、非 root、鉴权、配置保存、合成视频扫描、HTTP Range、配置重载与重启持久化验收。
+Peach 的 Docker 镜像用于单人 VPS 与 NAS,通过浏览器管理,镜像仓库为 [longmeidao/peach](https://hub.docker.com/r/longmeidao/peach)。每次发布推送版本号标签,并把 `edge` 更新为同一镜像;版本号标签对应发布提交。当前镜像目标为 `linux/amd64`;ARM NAS 尚未验收。2026-10-15 在 WSL 的独立 Docker Engine 中,用正式锁定依赖通过空数据卷初始化、非 root、鉴权、配置保存、合成视频扫描、HTTP Range、配置重载与重启持久化验收。
Docker 不使用桌面托盘。在网页配置中添加媒体目录时,只需填写容器内实际目录,例如 `/media`;Peach 自动保存所需的路径配置。Windows 安装包、macOS 源码运行和 Docker 的入口分别见 [README](../README.md#下载与使用)。
diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.md
index 9f1489559..74aacd322 100644
--- a/docs/OPERATIONS.md
+++ b/docs/OPERATIONS.md
@@ -73,6 +73,8 @@ Linux 发布任务使用官方 uv Python 3.14 容器,并在获取制品工具
Windows 安装覆盖与任务恢复验收允许 GitHub Actions,以及受保护版本标签上的 GitLab `smoke-windows` 作业;主机已有 Peach 安装登记时拒绝执行。所有程序、账本与任务夹具均放在临时目录,安装与卸载完成后核对登记清理。`fetch_cloudflared.ps1` 的相对输出路径按 PowerShell 当前工作位置解析,下载仍须通过固定 SHA-256 校验。
+GitGud 的 Linux 平台 Runner 不提供 Docker 守护进程,Docker 镜像由受保护标签上的 `publish-docker` 作业在 Windows 原生 Runner 构建,宿主须运行 Docker Desktop。作业核对标签与版本,用 `smoke_docker.py` 验收临时容器,再推送版本号与 `edge` 两个标签。`DOCKERHUB_USERNAME` 与 `DOCKERHUB_TOKEN` 放入受保护且隐藏的 CI 变量,环境作用域为 `release`;令牌只授予仓库读写。登录写入作业专用的临时 `DOCKER_CONFIG`,结束时登出并删除,不改动宿主用户的 Docker 登录。
+
媒体工具源码可通过 `PEACH_SOURCE_CACHE_BASE` 指定 HTTPS 缓存入口,按 `<SHA-256>/<归档名>` 定位文件。标签流水线使用发布桶的 `_sources/` 前缀;维护者填充缓存前须核对锁文件的原始 SHA-256,缓存同样计入桶容量预算。下载缓存失败时尝试锁定的上游地址;任一来源的哈希不符立即拒绝,不能放宽清单。未配置缓存的对应源码包直接使用上游。
可选的 `r2` 后端使用独立 Standard 桶与 HTTPS 自定义域名。`PEACH_R2_ACCESS_KEY_ID`、`PEACH_R2_SECRET_ACCESS_KEY`、`PEACH_R2_ENDPOINT` 放入受保护且隐藏的 CI 变量,环境作用域为 `release`;`PEACH_R2_BUCKET` 和 `PEACH_R2_PUBLIC_BASE` 指定发布目标。S3 传输复用 rclone,版本文件禁止覆盖;每份文件必须从公开入口完整下载并核对大小及 SHA-256 后,才更新公开版本索引和 Release 链接。
diff --git a/scripts/ci_windows.ps1 b/scripts/ci_windows.ps1
index 3876fa181..a7dbbb5dd 100644
--- a/scripts/ci_windows.ps1
+++ b/scripts/ci_windows.ps1
@@ -1,4 +1,4 @@
-param([ValidateSet('verify', 'build', 'smoke')][string]$Mode = 'verify')
+param([ValidateSet('verify', 'build', 'smoke', 'docker')][string]$Mode = 'verify')
$ErrorActionPreference = 'Stop'
function Assert-Exit([string]$Message) {
@@ -51,6 +51,45 @@ if ($Mode -eq 'build') {
exit 0
}
+if ($Mode -eq 'docker') {
+ # Linux 平台 Runner 不提供 Docker 守护进程;镜像在本机 Docker Desktop 构建、验收后发布。
+ $Match = Select-String -LiteralPath src/peach/__init__.py -Pattern '^__version__ = "([^"]+)"'
+ if (-not $Match) { throw '无法读取发布版本' }
+ $Version = $Match.Matches[0].Groups[1].Value
+ if ($env:CI_COMMIT_TAG -ne "v$Version") { throw 'Tag 与版本不一致' }
+ if (-not $env:DOCKERHUB_USERNAME -or -not $env:DOCKERHUB_TOKEN) { throw '缺少 Docker Hub 发布变量' }
+ $Endpoint = (docker context inspect --format '{{.Endpoints.docker.Host}}')
+ Assert-Exit '需要运行 Docker Desktop'
+ $Candidate = "peach-ci:$Version-$env:CI_PIPELINE_ID"
+ $Revision = (git rev-parse HEAD).Trim()
+ Assert-Exit '无法读取提交'
+ docker build --pull --label "org.opencontainers.image.version=$Version" --label "org.opencontainers.image.revision=$Revision" -t $Candidate .
+ Assert-Exit '镜像构建失败'
+ & (Get-Command python.exe).Source -X utf8 scripts/smoke_docker.py $Candidate
+ Assert-Exit '镜像验收失败'
+ # 登录写进作业专用配置目录,不改动宿主用户的 Docker 登录。
+ $SavedConfig, $SavedHost = $env:DOCKER_CONFIG, $env:DOCKER_HOST
+ $env:DOCKER_HOST = $Endpoint
+ $env:DOCKER_CONFIG = Join-Path ([IO.Path]::GetTempPath()) ('peach-docker-config-' + [guid]::NewGuid().ToString('N'))
+ New-Item -ItemType Directory -Path $env:DOCKER_CONFIG | Out-Null
+ try {
+ $env:DOCKERHUB_TOKEN | docker login --username $env:DOCKERHUB_USERNAME --password-stdin
+ Assert-Exit 'Docker Hub 登录失败'
+ foreach ($Tag in @($Version, 'edge')) {
+ docker tag $Candidate "longmeidao/peach:$Tag"
+ Assert-Exit '镜像标签失败'
+ docker push "longmeidao/peach:$Tag"
+ Assert-Exit "推送 longmeidao/peach:$Tag 失败"
+ }
+ } finally {
+ docker logout | Out-Null
+ Remove-Item -LiteralPath $env:DOCKER_CONFIG -Recurse -Force -ErrorAction SilentlyContinue
+ $env:DOCKER_CONFIG, $env:DOCKER_HOST = $SavedConfig, $SavedHost
+ docker image rm $Candidate | Out-Null
+ }
+ exit 0
+}
+
$Version = (Get-Content -LiteralPath release/version.txt -Raw -Encoding utf8).Trim()
$Packages = (Resolve-Path release).Path
$Evidence = Join-Path ([IO.Path]::GetTempPath()) ('peach-release-smoke-' + [guid]::NewGuid().ToString('N'))