Peach: Local-first video metadata scraper and media manager.
ci(gitgud): 版本标签构建、验收并发布 Docker 镜像
longmeidaoc1222a7647bf
diff --git a/.gitlab-ci.yml b/.gitlab-ci.ymlindex 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-linuxstage: publishdiff --git a/docs/DOCKER.md b/docs/DOCKER.mdindex 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.mdindex 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.ps1index 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'))