From 924d18da383b322c545fe4ec6765949f955b625e Mon Sep 17 00:00:00 2001 From: wanghe-fit2cloud Date: Tue, 17 Nov 2026 16:08:05 +0800 Subject: [PATCH] fix(database-ha): publish full version tags with series aliases --- .../workflows/database-cluster-release.yml | 9 ++-- README.md | 16 +++--- README_zh.md | 16 +++--- checks/README.md | 13 ++--- checks/check-postgresql-cluster.sh | 2 +- database-ha/README.md | 50 ++++++++++--------- database-ha/mysql/README.md | 14 +++--- database-ha/postgresql/README.md | 24 +++++---- database-ha/redis/README.md | 28 ++++++----- 9 files changed, 95 insertions(+), 77 deletions(-) diff --git a/.github/workflows/database-cluster-release.yml b/.github/workflows/database-cluster-release.yml index 552401b..853b31c 100644 --- a/.github/workflows/database-cluster-release.yml +++ b/.github/workflows/database-cluster-release.yml @@ -14,7 +14,7 @@ on: options: [all, mysql, postgresql, redis] default: all version: - description: 'Supported series (e.g. 8.4, 18, 6.2); all builds every supported series' + description: 'Supported series (e.g. 8.4, 18, 8.10); builds the full version from versions.json' default: all publish: description: 'Publish to Docker Hub after both architectures pass' @@ -74,8 +74,8 @@ jobs: if name == 'redis': variant = 'trixie' if series == '8.10' else 'bookworm' build_args += f'\nREDIS_VARIANT={variant}' - image = f'1panel/{name}-cluster:{series}' - images.append({'image': image}) + image = f'1panel/{name}-cluster:{version}' + images.append({'image': image, 'series_image': f'1panel/{name}-cluster:{series}'}) for architecture, runner in [('amd64', 'ubuntu-24.04'), ('arm64', 'ubuntu-24.04-arm')]: builds.append({ 'database': name, @@ -154,4 +154,5 @@ jobs: - name: Publish multi-platform manifest env: IMAGE: ${{ matrix.image }} - run: docker buildx imagetools create --tag "$IMAGE" "${IMAGE}-amd64" "${IMAGE}-arm64" + SERIES_IMAGE: ${{ matrix.series_image }} + run: docker buildx imagetools create --tag "$IMAGE" --tag "$SERIES_IMAGE" "${IMAGE}-amd64" "${IMAGE}-arm64" diff --git a/README.md b/README.md index 8e85eb7..b75bde3 100644 --- a/README.md +++ b/README.md @@ -42,15 +42,17 @@ This repository builds and publishes container images used by 1Panel, covering A Database image sources and supported version mappings are grouped under [database-ha/](database-ha/README.md). Their runtime checks are maintained in the shared [checks/](checks/README.md) directory. -| Image | Supported series / image tags | -| --- | --- | -| `1panel/mysql-cluster` | `8.4` | -| `1panel/postgresql-cluster` | `15`, `16`, `17`, `18` | -| `1panel/redis-cluster` | `6.2`, `7.4`, `8.10` | +| Image | Full version tags | Series aliases | +| --- | --- | --- | +| `1panel/mysql-cluster` | `8.4.13` | `8.4` | +| `1panel/postgresql-cluster` | `15.20`, `16.16`, `17.12`, `18.7` | `15`, `16`, `17`, `18` | +| `1panel/redis-cluster` | `6.2.24`, `7.4.12`, `8.10.3` | `6.2`, `7.4`, `8.10` | + +Full version tags use the upstream database patch versions pinned in [versions.json](database-ha/versions.json), without an `r` revision suffix. Rebuilding the same database version reuses its full version tag and may change the digest; use a digest to pin a specific build. Series aliases follow the existing version rules: MySQL and Redis use major.minor; PostgreSQL uses the major version. Each alias points to its latest published patch. Primary and replica nodes use the same image with different replication environment variables. -Tags follow the existing 1Panel HA package version rules: MySQL and Redis use major.minor; PostgreSQL uses the major version. The exact upstream patch versions are pinned in [versions.json](database-ha/versions.json). Primary and replica nodes use the same image with different replication environment variables. +`Build Database Replication Images` builds and checks each selected series on native amd64 and arm64 runners using `-amd64` and `-arm64` candidate tags. Select a database and series, or use `all` to build every supported entry. Manual runs default to build and test only; enabling `publish` pushes the verified architecture images and, after all selected builds pass, publishes multi-platform manifests under both the full version tag and its series alias, for example `1panel/postgresql-cluster:17.12` and `1panel/postgresql-cluster:17`. -`Build Database Replication Images` builds and checks each selected series on native amd64 and arm64 runners. Select a database and series, or use `all` to build every supported entry. Manual runs default to build and test only; enabling `publish` pushes the verified architecture images and publishes the series manifest after all selected builds pass. +The companion new App Store packages use full database patch versions with `-master` or `-slave` suffixes and require 1Panel v2.6 through `supportVersion: 2.6`. Historical packages retain their historical images; migration of existing clusters needs a separate procedure. This minimum panel version does not mean panel-side safeguards against ordinary upgrades from old to new images or mixed-generation nodes have been implemented. The supported list includes the existing 1Panel HA series still maintained upstream and adds PostgreSQL 18 and Redis 8.10. MySQL 5.7/8.0 and PostgreSQL 13/14 have reached EOL; Redis 8.0 is marked unsupported in the upstream security policy. See [support decisions and upstream sources](database-ha/README.md#版本维护范围). diff --git a/README_zh.md b/README_zh.md index eba483f..b01b00b 100644 --- a/README_zh.md +++ b/README_zh.md @@ -42,15 +42,17 @@ 三类数据库的源码和版本映射放在 [database-ha/](database-ha/README.md),运行校验脚本统一维护在根目录的 [checks/](checks/README.md)。 -| 镜像 | 支持系列与镜像标签 | -| --- | --- | -| `1panel/mysql-cluster` | `8.4` | -| `1panel/postgresql-cluster` | `15`、`16`、`17`、`18` | -| `1panel/redis-cluster` | `6.2`、`7.4`、`8.10` | +| 镜像 | 完整版本标签 | 系列兼容别名 | +| --- | --- | --- | +| `1panel/mysql-cluster` | `8.4.13` | `8.4` | +| `1panel/postgresql-cluster` | `15.20`、`16.16`、`17.12`、`18.7` | `15`、`16`、`17`、`18` | +| `1panel/redis-cluster` | `6.2.24`、`7.4.12`、`8.10.3` | `6.2`、`7.4`、`8.10` | + +完整版本标签使用 [versions.json](database-ha/versions.json) 固定的数据库补丁版本,不添加 `r` 修订后缀。相同数据库版本重建时沿用完整版本标签,digest 可能变化;需要固定具体构建时使用 digest。系列兼容别名沿用已有版本规则:MySQL、Redis 使用主次版本号,PostgreSQL 使用主版本号,指向该系列最近发布的补丁版本。主从节点使用同一个镜像,通过复制环境变量区分角色。 -版本规则沿用当前 1Panel 高可用安装包:MySQL、Redis 使用主次版本号,PostgreSQL 使用主版本号。实际构建使用的补丁版本固定在 [versions.json](database-ha/versions.json)。主从节点使用同一个镜像,通过复制环境变量区分角色。 +`Build Database Replication Images` 在原生 amd64、arm64 Runner 上,以 `<完整版本>-amd64`、`<完整版本>-arm64` 候选标签构建并验证所选系列。可以选择数据库和系列,也可以使用 `all` 构建全部支持项。手动运行默认只构建测试;启用 `publish` 后推送已验证的架构镜像,并在全部选中任务通过后,为完整版本标签和系列兼容别名发布多架构 manifest,例如 `1panel/postgresql-cluster:17.12` 和 `1panel/postgresql-cluster:17`。 -`Build Database Replication Images` 在原生 amd64、arm64 Runner 上构建并验证所选系列。可以选择数据库和系列,也可以使用 `all` 构建全部支持项。手动运行默认只构建测试;启用 `publish` 后推送已验证的架构镜像,并在全部选中任务通过后发布系列标签的多架构 manifest。 +配套新应用商店包以完整数据库补丁版本加 `-master`、`-slave` 角色后缀命名,通过 `supportVersion: 2.6` 声明最低支持 1Panel v2.6。旧包保持历史镜像,存量集群迁移单独处理;该版本门槛不代表面板已完成旧新镜像的普通升级隔离或混合节点校验。 支持范围覆盖当前 1Panel 高可用仍有上游维护的系列,并新增 PostgreSQL 18、Redis 8.10。MySQL 5.7/8.0、PostgreSQL 13/14 已结束维护;Redis 8.0 已被上游安全政策列为不支持,详见[版本维护范围及官方来源](database-ha/README.md#版本维护范围)。 diff --git a/checks/README.md b/checks/README.md index 2c0efa6..ef06776 100644 --- a/checks/README.md +++ b/checks/README.md @@ -70,12 +70,12 @@ python3 checks/check-php-eol-backport.py /path/to/source-inputs ```bash bash checks/check-php-pecl.sh PHP_IMAGE python3 checks/check-php-legacy-runtime.py PHP_IMAGE -bash checks/check-mysql-cluster.sh 1panel/mysql-cluster:8.4 -bash checks/check-postgresql-cluster.sh 1panel/postgresql-cluster:18 -bash checks/check-redis-cluster.sh 1panel/redis-cluster:8.10 +bash checks/check-mysql-cluster.sh 1panel/mysql-cluster:8.4.13 +bash checks/check-postgresql-cluster.sh 1panel/postgresql-cluster:18.7 +bash checks/check-redis-cluster.sh 1panel/redis-cluster:8.10.3 ``` -将 `PHP_IMAGE` 替换为待验证的 PHP 镜像名称。数据库镜像构建方法与支持版本见 [database-ha](../database-ha/README.md)。 +将 `PHP_IMAGE` 替换为待验证的 PHP 镜像名称。数据库示例使用完整版本标签,指向本地构建的待发布候选镜像;CI 传入的是同一候选的架构标签,例如 `1panel/redis-cluster:8.10.3-arm64`。校验不依赖镜像先行发布。数据库镜像构建方法与支持版本见 [database-ha](../database-ha/README.md)。 数据库校验使用唯一名称创建临时容器、网络和数据卷,结束时清理本次创建的资源。PHP 运行校验同样使用临时容器;PECL 校验会在容器中联网下载和编译扩展。 @@ -84,8 +84,8 @@ bash checks/check-redis-cluster.sh 1panel/redis-cluster:8.10 三个数据库校验脚本已接入 [Build Database Replication Images](../.github/workflows/database-cluster-release.yml): - 涉及数据库源码或数据库校验脚本的 PR,会触发对应工作流,从版本清单生成 amd64、arm64 构建及运行校验任务。 -- 每个任务先构建镜像,再调用对应的 `check-*-cluster.sh`;该项校验失败会阻止该项镜像推送。 -- PR 只构建和校验。手动运行时 `publish` 默认为 `false`;启用后才推送已验证的架构镜像,并在全部选中任务通过后发布多架构标签。 +- 每个任务先构建 `<完整版本>-amd64` 或 `<完整版本>-arm64` 候选镜像,再将该镜像传给对应的 `check-*-cluster.sh`;该项校验失败会阻止该项镜像推送。 +- PR 只构建和校验。手动运行时 `publish` 默认为 `false`;启用后才推送已验证的完整版本架构镜像,并在全部选中任务通过后,为完整版本标签和系列兼容别名发布多架构 manifest,不添加 `r` 修订后缀。同数据库版本重建会沿用标签,digest 可能变化;固定具体构建时使用 digest。 本目录中的 Java、PHP 校验脚本目前由维护者手动执行,尚未在现有发布工作流中调用。 @@ -94,6 +94,7 @@ bash checks/check-redis-cluster.sh 1panel/redis-cluster:8.10 - 退出码 `0` 表示本次实际执行的检查项通过;非零表示失败,需要结合报错和容器日志定位。 - `SKIP` 表示该项未验证。例如没有提供 PHP 7.3.33 源码包时,其源码校验会跳过,不能据此认定该项通过。 - 源码检查通过后,仍需对构建出的镜像执行运行校验。容器检查的结论限定于本次镜像版本、架构和脚本覆盖的场景。 +- 配套新数据库应用包最低支持 1Panel v2.6(`supportVersion: 2.6`),旧包保持历史镜像。镜像校验不验证面板的旧新镜像升级隔离或混合节点校验。 - 生产旧数据迁移、跨主版本升级和真实多机部署需要单独验证;一次临时环境检查不覆盖这些场景。 维护时沿用 `check-*` 命名,将共享校验集中放在本目录,并在本说明中补齐用途、输入和依赖。涉及仓库文件时,通过脚本自身位置定位仓库根目录,保持从不同工作目录执行的行为一致。 diff --git a/checks/check-postgresql-cluster.sh b/checks/check-postgresql-cluster.sh index f996345..7b6a4a8 100644 --- a/checks/check-postgresql-cluster.sh +++ b/checks/check-postgresql-cluster.sh @@ -1,7 +1,7 @@ #!/usr/bin/env bash set -Eeuo pipefail -image="${1:-${IMAGE:-1panel/postgresql-cluster:18}}" +image="${1:-${IMAGE:-1panel/postgresql-cluster:18.7}}" prefix="1panel-pg-check-$(date +%s)-$$" network="$prefix-network" master="$prefix-master" diff --git a/database-ha/README.md b/database-ha/README.md index af7b854..361a46e 100644 --- a/database-ha/README.md +++ b/database-ha/README.md @@ -14,20 +14,22 @@ database-ha/ ## 版本与标签 -发布版本号与当前安装包保持一致:MySQL、Redis 使用主次版本号,PostgreSQL 使用主版本号。安装包中的 `master`、`slave` 是节点角色,同系列的主从节点使用相同镜像。 +镜像以完整数据库补丁版本发布,并保留系列兼容别名:MySQL、Redis 使用主次版本号别名,PostgreSQL 使用主版本号别名。安装包中的 `master`、`slave` 是节点角色,同一数据库版本的主从节点使用相同镜像。 -| 数据库 | 支持系列 | 固定上游镜像 | 发布标签 | -| --- | --- | --- | --- | -| MySQL | 8.4 | `mysql:8.4.13` | `1panel/mysql-cluster:8.4` | -| PostgreSQL | 15 | `postgres:15.20-bookworm` | `1panel/postgresql-cluster:15` | -| PostgreSQL | 16 | `postgres:16.16-bookworm` | `1panel/postgresql-cluster:16` | -| PostgreSQL | 17 | `postgres:17.12-bookworm` | `1panel/postgresql-cluster:17` | -| PostgreSQL | 18 | `postgres:18.7-bookworm` | `1panel/postgresql-cluster:18` | -| Redis | 6.2 | `redis:6.2.24-bookworm` | `1panel/redis-cluster:6.2` | -| Redis | 7.4 | `redis:7.4.12-bookworm` | `1panel/redis-cluster:7.4` | -| Redis | 8.10 | `redis:8.10.3-trixie` | `1panel/redis-cluster:8.10` | +| 数据库 | 支持系列 | 固定上游镜像 | 完整版本标签 | 系列兼容别名 | +| --- | --- | --- | --- | --- | +| MySQL | 8.4 | `mysql:8.4.13` | `1panel/mysql-cluster:8.4.13` | `1panel/mysql-cluster:8.4` | +| PostgreSQL | 15 | `postgres:15.20-bookworm` | `1panel/postgresql-cluster:15.20` | `1panel/postgresql-cluster:15` | +| PostgreSQL | 16 | `postgres:16.16-bookworm` | `1panel/postgresql-cluster:16.16` | `1panel/postgresql-cluster:16` | +| PostgreSQL | 17 | `postgres:17.12-bookworm` | `1panel/postgresql-cluster:17.12` | `1panel/postgresql-cluster:17` | +| PostgreSQL | 18 | `postgres:18.7-bookworm` | `1panel/postgresql-cluster:18.7` | `1panel/postgresql-cluster:18` | +| Redis | 6.2 | `redis:6.2.24-bookworm` | `1panel/redis-cluster:6.2.24` | `1panel/redis-cluster:6.2` | +| Redis | 7.4 | `redis:7.4.12-bookworm` | `1panel/redis-cluster:7.4.12` | `1panel/redis-cluster:7.4` | +| Redis | 8.10 | `redis:8.10.3-trixie` | `1panel/redis-cluster:8.10.3` | `1panel/redis-cluster:8.10` | -[versions.json](versions.json) 是构建工作流的版本映射来源。同系列发布新补丁时,更新对应映射,通过主从运行验证后重新发布该系列标签;数据库补丁版本同时记录在镜像标签元数据 `org.opencontainers.image.version` 中。 +[versions.json](versions.json) 是构建工作流的版本映射来源。同系列发布新补丁时,更新对应映射,通过主从运行验证后发布完整版本标签,并更新系列兼容别名指向该补丁。数据库补丁版本同时记录在镜像标签元数据 `org.opencontainers.image.version` 中。相同数据库版本重建时沿用完整版本标签,不添加 `r` 修订后缀,digest 可能变化;需要固定具体构建时使用 digest。 + +配套新应用商店包使用完整补丁版本加 `-master`、`-slave` 后缀,例如 `17.12-master`、`17.12-slave`,通过 `supportVersion: 2.6` 声明最低支持 1Panel v2.6。旧包保持历史镜像,不能通过覆盖旧版本包内容替换存量实例。该版本门槛不代表面板已完成旧新镜像的普通升级隔离或混合节点校验,存量迁移仍需单独处理。 ## 版本维护范围 @@ -37,34 +39,34 @@ database-ha/ - PostgreSQL 保留 15、16、17,增加 18。13 已结束维护;14 已在 2026-11-12 发布最终版本并宣布 EOL。[官方版本策略](https://www.postgresql.org/support/versioning/)、[14 EOL 公告与当前补丁发布](https://www.postgresql.org/about/news/postgresql-187-1712-1616-1520-1425-and-19-rc-2-released-3442/) - Redis 保留 6.2、7.4,增加当前稳定系列 8.10。6.2 仍处于上游延长安全支持;8.0 在当前官方安全政策中已列为不支持,故不纳入构建列表。官方版本周期页面对 8.0 的日期与安全支持表存在差异,本目录以当前安全补丁支持状态为准。[官方安全政策](https://github.com/redis/redis/security)、[官方版本周期](https://redis.io/docs/latest/operate/oss_and_stack/install/version-mgmt/) -以上是本目录的镜像维护范围,未修改应用商店已有安装包。历史镜像仍能下载,不作为继续维护该系列的依据。 +以上是本目录的镜像维护范围。应用商店旧包保持历史镜像;历史镜像仍能下载,不作为继续维护该系列的依据。 ## 构建与验证 在 runtime 仓库根目录执行: ```bash -docker build --build-arg MYSQL_VERSION=8.4.13 -t 1panel/mysql-cluster:8.4 database-ha/mysql -bash checks/check-mysql-cluster.sh 1panel/mysql-cluster:8.4 +docker build --build-arg MYSQL_VERSION=8.4.13 -t 1panel/mysql-cluster:8.4.13 database-ha/mysql +bash checks/check-mysql-cluster.sh 1panel/mysql-cluster:8.4.13 -docker build --build-arg POSTGRESQL_VERSION=18.7 -t 1panel/postgresql-cluster:18 database-ha/postgresql -bash checks/check-postgresql-cluster.sh 1panel/postgresql-cluster:18 +docker build --build-arg POSTGRESQL_VERSION=18.7 -t 1panel/postgresql-cluster:18.7 database-ha/postgresql +bash checks/check-postgresql-cluster.sh 1panel/postgresql-cluster:18.7 -docker build --build-arg REDIS_VERSION=6.2.24 -t 1panel/redis-cluster:6.2 database-ha/redis -bash checks/check-redis-cluster.sh 1panel/redis-cluster:6.2 +docker build --build-arg REDIS_VERSION=6.2.24 -t 1panel/redis-cluster:6.2.24 database-ha/redis +bash checks/check-redis-cluster.sh 1panel/redis-cluster:6.2.24 -docker build --build-arg REDIS_VERSION=8.10.3 --build-arg REDIS_VARIANT=trixie -t 1panel/redis-cluster:8.10 database-ha/redis -bash checks/check-redis-cluster.sh 1panel/redis-cluster:8.10 +docker build --build-arg REDIS_VERSION=8.10.3 --build-arg REDIS_VARIANT=trixie -t 1panel/redis-cluster:8.10.3 database-ha/redis +bash checks/check-redis-cluster.sh 1panel/redis-cluster:8.10.3 ``` 其他系列按版本表传入固定补丁版本。Redis 6.2、7.4 使用默认 Bookworm 底座;8.10 使用 Trixie 底座,构建时需同时传入 `REDIS_VARIANT=trixie`,工作流会自动选择。详细接口及迁移限制分别见 [MySQL](mysql/README.md)、[PostgreSQL](postgresql/README.md)、[Redis](redis/README.md)。 -`Build Database Replication Images` 从版本映射生成原生 amd64、arm64 构建及测试矩阵。`database=all`、`version=all` 构建全部八个系列;选择单一数据库后,可以指定该数据库的系列号。已排除的系列和未登记的版本会被拒绝。 +以上校验使用本地构建的待发布候选镜像,不要求先行发布。`Build Database Replication Images` 从版本映射生成原生 amd64、arm64 构建及测试矩阵,以 `<完整版本>-amd64`、`<完整版本>-arm64` 标签构建并校验候选镜像。`database=all`、`version=all` 构建全部八个系列;选择单一数据库后,可以指定该数据库的系列号。已排除的系列和未登记的版本会被拒绝。 -手动运行默认只构建测试。启用 `publish` 后,全部选中任务通过才合并对应系列的多架构 manifest;发布复用仓库现有 Docker Hub Secrets。工作流尚未执行不代表远程镜像已经发布。 +手动运行默认只构建测试。启用 `publish` 后推送已验证的完整版本架构镜像,并在全部选中任务通过后,为完整版本标签和系列兼容别名发布多架构 manifest;发布复用仓库现有 Docker Hub Secrets。工作流尚未执行不代表远程镜像已经发布。 ## 数据与升级 -本目录保持现有主从复制拓扑,不包含自动选主、读写代理或 Redis Cluster 分片。持久化数据不能因更换系列标签而跨主版本直接复用;例如 PostgreSQL 17 切换至 18,仍需备份恢复或经过验证的 `pg_upgrade` 流程。Redis 6.2 的单文件 AOF 与 7.4、8.10 的多文件 AOF 也需分别验证,新增 8.10 镜像不代表已验证从旧主版本直接迁移。 +本目录保持现有主从复制拓扑,不包含自动选主、读写代理或 Redis Cluster 分片。持久化数据不能因更换镜像标签而跨主版本直接复用;例如 PostgreSQL 17 切换至 18,仍需备份恢复或经过验证的 `pg_upgrade` 流程。Redis 6.2 的单文件 AOF 与 7.4、8.10 的多文件 AOF 也需分别验证;8.0→8.10 属于跨系列升级,新增 8.10 镜像不代表旧 8.0 数据迁移已验证。 测试脚本只清理本次创建的临时容器、网络和数据卷。全新主从部署、同系列补丁升级、旧 Bitnami 单主数据迁移和已有完整集群迁移分别记录验证范围,不能相互替代。 diff --git a/database-ha/mysql/README.md b/database-ha/mysql/README.md index 83e53d5..c65a6db 100644 --- a/database-ha/mysql/README.md +++ b/database-ha/mysql/README.md @@ -6,15 +6,17 @@ 当前支持的具体数据库版本如下,与[版本清单](../versions.json)保持一致: -| 支持系列 | 具体数据库版本 | 镜像标签 | 上游基础镜像 | -| --- | --- | --- | --- | -| 8.4 | **8.4.13** | `1panel/mysql-cluster:8.4` | `mysql:8.4.13` | +| 支持系列 | 具体数据库版本 | 完整版本标签 | 系列兼容别名 | 上游基础镜像 | +| --- | --- | --- | --- | --- | +| 8.4 | **8.4.13** | `1panel/mysql-cluster:8.4.13` | `1panel/mysql-cluster:8.4` | `mysql:8.4.13` | -对外镜像标签沿用系列版本号,内部上游构建版本固定为 `MYSQL_VERSION=8.4.13`。 +上游构建版本固定为 `MYSQL_VERSION=8.4.13`,发布完整版本标签并保留指向该系列最近发布补丁的兼容别名。相同数据库版本重建时沿用完整版本标签,不添加 `r` 修订后缀,digest 可能变化;需要固定具体构建时使用 digest。 + +配套新应用包为 `8.4.13-master`、`8.4.13-slave`,通过 `supportVersion: 2.6` 声明最低支持 1Panel v2.6。旧包保持历史镜像,存量迁移单独处理;该门槛不代表面板已完成旧新镜像的普通升级隔离或混合节点校验。 ```bash -docker build --build-arg MYSQL_VERSION=8.4.13 -t 1panel/mysql-cluster:8.4 database-ha/mysql -bash checks/check-mysql-cluster.sh 1panel/mysql-cluster:8.4 +docker build --build-arg MYSQL_VERSION=8.4.13 -t 1panel/mysql-cluster:8.4.13 database-ha/mysql +bash checks/check-mysql-cluster.sh 1panel/mysql-cluster:8.4.13 ``` 目标架构为 `linux/amd64` 和 `linux/arm64`,容器默认使用 UID/GID `1001:1001`。宿主机数据目录需由该用户拥有,与当前应用商店初始化脚本一致。 diff --git a/database-ha/postgresql/README.md b/database-ha/postgresql/README.md index 1261c8b..6bd540c 100644 --- a/database-ha/postgresql/README.md +++ b/database-ha/postgresql/README.md @@ -6,18 +6,22 @@ 当前支持的具体数据库版本如下,与[版本清单](../versions.json)保持一致: -| 支持系列 | 具体数据库版本 | 镜像标签 | 上游基础镜像 | -| --- | --- | --- | --- | -| 15 | **15.20** | `1panel/postgresql-cluster:15` | `postgres:15.20-bookworm` | -| 16 | **16.16** | `1panel/postgresql-cluster:16` | `postgres:16.16-bookworm` | -| 17 | **17.12** | `1panel/postgresql-cluster:17` | `postgres:17.12-bookworm` | -| 18 | **18.7** | `1panel/postgresql-cluster:18` | `postgres:18.7-bookworm` | +| 支持系列 | 具体数据库版本 | 完整版本标签 | 系列兼容别名 | 上游基础镜像 | +| --- | --- | --- | --- | --- | +| 15 | **15.20** | `1panel/postgresql-cluster:15.20` | `1panel/postgresql-cluster:15` | `postgres:15.20-bookworm` | +| 16 | **16.16** | `1panel/postgresql-cluster:16.16` | `1panel/postgresql-cluster:16` | `postgres:16.16-bookworm` | +| 17 | **17.12** | `1panel/postgresql-cluster:17.12` | `1panel/postgresql-cluster:17` | `postgres:17.12-bookworm` | +| 18 | **18.7** | `1panel/postgresql-cluster:18.7` | `1panel/postgresql-cluster:18` | `postgres:18.7-bookworm` | + +发布完整版本标签并保留指向各系列最近发布补丁的兼容别名。相同数据库版本重建时沿用完整版本标签,不添加 `r` 修订后缀,digest 可能变化;需要固定具体构建时使用 digest。 + +配套新应用包使用完整补丁版本加 `-master`、`-slave` 后缀,例如 `17.12-master`、`17.12-slave`,通过 `supportVersion: 2.6` 声明最低支持 1Panel v2.6。旧包保持历史镜像,存量迁移单独处理;该门槛不代表面板已完成旧新镜像的普通升级隔离或混合节点校验。 支持范围以 2026-11-16 为准。PostgreSQL 13 已于 2025-11-13 结束维护;PostgreSQL 14 的 2026-11-12 最后一次发布公告已明确宣布结束维护,因此不再提供这两个系列。[官方版本维护策略](https://www.postgresql.org/support/versioning/)、[PostgreSQL 14 EOL 公告及当前补丁版本](https://www.postgresql.org/about/news/postgresql-187-1712-1616-1520-1425-and-19-rc-2-released-3442/)。 ```bash -docker build -t 1panel/postgresql-cluster:18 database-ha/postgresql -docker build --build-arg POSTGRESQL_VERSION=17.12 -t 1panel/postgresql-cluster:17 database-ha/postgresql +docker build -t 1panel/postgresql-cluster:18.7 database-ha/postgresql +docker build --build-arg POSTGRESQL_VERSION=17.12 -t 1panel/postgresql-cluster:17.12 database-ha/postgresql ``` 支持单主、多从的异步流复制。首次启动从库通过 `pg_basebackup` 获取主库已有数据,之后持续接收 WAL。主从可以位于不同主机,通过主库可访问的地址和映射端口连接。该镜像不提供自动选主、故障转移或读写代理;从库长时间离线且所需 WAL 已被回收时,需要运维人员备份并重建从库。 @@ -55,12 +59,12 @@ docker build --build-arg POSTGRESQL_VERSION=17.12 -t 1panel/postgresql-cluster:1 以上是隔离单主样本验证,不代表所有生产集群均可直接替换镜像。扩展、不同 locale、Bitnami 专属配置路径以及已有从库的迁移仍需单独验证。正式迁移前应完整备份并在隔离环境演练;复杂配置可采用从旧主库逻辑备份、恢复到新主库后重新创建从库的方式。 -不同主版本的数据不能直接复用,例如 PostgreSQL 17 数据不能直接挂到 `:18` 镜像。脚本检测到数据主版本与镜像不匹配会拒绝启动并保留数据;跨主版本需使用备份恢复或经过验证的 `pg_upgrade` 流程。新增 PostgreSQL 18 镜像不意味着已实现 17→18 的数据库迁移。 +不同主版本的数据不能直接复用,例如 PostgreSQL 17 数据不能直接挂到 `:18.7` 镜像。脚本检测到数据主版本与镜像不匹配会拒绝启动并保留数据;跨主版本需使用备份恢复或经过验证的 `pg_upgrade` 流程。新增 PostgreSQL 18 镜像不意味着已实现 17→18 的数据库迁移。 ## 验证 ```bash -IMAGE=1panel/postgresql-cluster:18 bash checks/check-postgresql-cluster.sh +IMAGE=1panel/postgresql-cluster:18.7 bash checks/check-postgresql-cluster.sh ``` 验证脚本从镜像读取 `PG_MAJOR`,使用唯一名称的临时网络、容器和卷,覆盖新库远程 SCRAM 认证、已有数据及从库克隆认证文件的白名单允许与拒绝、两处认证文件缺失时的默认规则、持续复制、重复启动、独立配置卷、非默认端口、特殊字符密码、异主版本数据安全拒绝及失败时保留已有目录。只清理本次创建的资源。 diff --git a/database-ha/redis/README.md b/database-ha/redis/README.md index 043a6bb..bb8aef5 100644 --- a/database-ha/redis/README.md +++ b/database-ha/redis/README.md @@ -6,23 +6,27 @@ 当前支持的具体数据库版本如下,与[版本清单](../versions.json)保持一致: -| 支持系列 | 具体数据库版本 | 镜像标签 | 上游基础镜像 | -| --- | --- | --- | --- | -| 6.2 | **6.2.24** | `1panel/redis-cluster:6.2` | `redis:6.2.24-bookworm` | -| 7.4 | **7.4.12** | `1panel/redis-cluster:7.4` | `redis:7.4.12-bookworm` | -| 8.10 | **8.10.3** | `1panel/redis-cluster:8.10` | `redis:8.10.3-trixie` | +| 支持系列 | 具体数据库版本 | 完整版本标签 | 系列兼容别名 | 上游基础镜像 | +| --- | --- | --- | --- | --- | +| 6.2 | **6.2.24** | `1panel/redis-cluster:6.2.24` | `1panel/redis-cluster:6.2` | `redis:6.2.24-bookworm` | +| 7.4 | **7.4.12** | `1panel/redis-cluster:7.4.12` | `1panel/redis-cluster:7.4` | `redis:7.4.12-bookworm` | +| 8.10 | **8.10.3** | `1panel/redis-cluster:8.10.3` | `1panel/redis-cluster:8.10` | `redis:8.10.3-trixie` | + +发布完整版本标签并保留指向各系列最近发布补丁的兼容别名。相同数据库版本重建时沿用完整版本标签,不添加 `r` 修订后缀,digest 可能变化;需要固定具体构建时使用 digest。 + +配套新应用包使用完整补丁版本加 `-master`、`-slave` 后缀,例如 `7.4.12-master`、`7.4.12-slave`,通过 `supportVersion: 2.6` 声明最低支持 1Panel v2.6。旧包保持历史镜像,存量迁移单独处理;该门槛不代表面板已完成旧新镜像的普通升级隔离或混合节点校验。 按 2026-11-16 核对的[官方安全支持政策](https://github.com/redis/redis/security),6.2 处于延长安全支持期,7.4 和 8.10 仍受支持,8.0 已标为不支持,因此不再构建原安装包中的 8.0 系列。[版本周期页面](https://redis.io/docs/latest/operate/oss_and_stack/install/version-mgmt/)与安全政策对 8.0 的状态存在冲突,此处以当前安全补丁支持状态作为筛选依据,不推断其准确 EOL 日期。 在仓库根目录构建: ```bash -docker build --build-arg REDIS_VERSION=6.2.24 -t 1panel/redis-cluster:6.2 database-ha/redis -IMAGE=1panel/redis-cluster:6.2 bash checks/check-redis-cluster.sh -docker build --build-arg REDIS_VERSION=7.4.12 -t 1panel/redis-cluster:7.4 database-ha/redis -IMAGE=1panel/redis-cluster:7.4 bash checks/check-redis-cluster.sh -docker build --build-arg REDIS_VERSION=8.10.3 --build-arg REDIS_VARIANT=trixie -t 1panel/redis-cluster:8.10 database-ha/redis -IMAGE=1panel/redis-cluster:8.10 bash checks/check-redis-cluster.sh +docker build --build-arg REDIS_VERSION=6.2.24 -t 1panel/redis-cluster:6.2.24 database-ha/redis +IMAGE=1panel/redis-cluster:6.2.24 bash checks/check-redis-cluster.sh +docker build --build-arg REDIS_VERSION=7.4.12 -t 1panel/redis-cluster:7.4.12 database-ha/redis +IMAGE=1panel/redis-cluster:7.4.12 bash checks/check-redis-cluster.sh +docker build --build-arg REDIS_VERSION=8.10.3 --build-arg REDIS_VARIANT=trixie -t 1panel/redis-cluster:8.10.3 database-ha/redis +IMAGE=1panel/redis-cluster:8.10.3 bash checks/check-redis-cluster.sh ``` `REDIS_VERSION` 用于选择受支持系列的补丁版本,默认 `7.4.12`;`REDIS_VARIANT` 用于选择上游 Debian 发行版,默认 `bookworm`。6.2 和 7.4 使用 Debian 12 Bookworm,8.10 使用 Debian 13 Trixie;官方没有 `8.10.3-bookworm` 标签,因此构建 8.10 时需要同时指定两个参数。发行版差异影响基础系统和依赖包,运行时的环境变量、目录和 UID/GID 约定保持一致。 @@ -50,7 +54,7 @@ IMAGE=1panel/redis-cluster:8.10 bash checks/check-redis-cluster.sh `REDIS_EXTRA_FLAGS` 沿用原脚本按空白分词的行为,不执行 Shell 表达式,也不解释其中的 Shell 引号。针对当前应用包的 `--requirepass ${REDIS_PASSWORD}`,入口将整段密码作为单个参数处理,可保留空格、引号、反斜杠、美元符号等字符。其他带空白的参数值请通过配置文件或容器命令参数数组传入。 -本镜像只提供固定主从复制,不提供 Sentinel 自动选主、Redis Cluster 分片或主节点故障后的自动切换。替换镜像不会改变现有复制拓扑。升级应先在数据副本上验证同版本换镜像,再验证同系列补丁升级;不要直接复用跨大版本升级后写入的数据进行降级。6.2 使用单文件 AOF,7.4 和 8.10 使用多文件 AOF;配置文件和数据需要与目标系列匹配,不能将含 `appenddirname` 等新配置的 7.4、8.10 配置直接套给 6.2。 +本镜像只提供固定主从复制,不提供 Sentinel 自动选主、Redis Cluster 分片或主节点故障后的自动切换。替换镜像不会改变现有复制拓扑。升级应先在数据副本上验证同版本换镜像,再验证同系列补丁升级;8.0→8.10 属于跨系列升级,不能作为普通补丁更新。不要直接复用跨系列升级后写入的数据进行降级。6.2 使用单文件 AOF,7.4 和 8.10 使用多文件 AOF;配置文件和数据需要与目标系列匹配,不能将含 `appenddirname` 等新配置的 7.4、8.10 配置直接套给 6.2。 验证脚本使用唯一名称创建容器、网络和数据卷,测试不同密码、非默认端口、连续写入、主节点重启持久化、从节点离线 AOF 恢复和重新连接,并根据镜像的 `REDIS_VERSION` 检查对应的单文件或多文件 AOF。复制就绪和重连通过轮询从库中的新值确认;脚本还通过 `CLIENT PAUSE WRITE` 制造受控复制延迟,先确认旧值仍可读取,再等待新值,避免将不同连接上的 `WAIT` 当作同步屏障。脚本仅清理本次创建的资源,不等同于旧 Bitnami 数据升级或真实多主机部署验证。