发版日志

v4.5.1

新增和优化功能

  • 基于 Altinity clickhouse-operator 0.27.4 重新构建的 operator。现在,operator 和 metrics exporter 基于上游 0.27.4 版本构建,而不是 0.20.0,因此包含这两个版本之间的上游修复和功能。软件包名称、clickhouse.altinity.com/v1 API 组以及现有实例均保持不变。
  • 由 operator 管理的 Keeper 仲裁组。新的 ClickHouseKeeperInstallation 资源(简称 chk,API 组为 clickhouse-keeper.altinity.com/v1)可部署和管理 ClickHouse Keeper 仲裁组。operator 提供服务器镜像、Keeper 配置、每个成员对应的 Service、客户端 Service 和 PodDisruptionBudget,并在 Pod Security Admission restricted 配置文件下运行 pod。Keeper 使用产品已提供的 ClickHouse 服务器镜像运行,因此不会新增镜像。请参阅部署 Keeper 仲裁组。
  • 按名称引用仲裁组。ClickHouseInstallation 可以在 spec.configuration.zookeeper.keeper 下指定一个 ClickHouseKeeperInstallation,而无需在 zookeeper.nodes 下列出成员地址。operator 会等待仲裁组就绪,并将成员地址写入 ClickHouse® 配置。对于自行运行的仲裁组,仍支持 zookeeper.nodes。
  • ClickHouse® engine 26.8.39.19。默认服务器镜像从 25.8.33.6(25.8 LTS)升级为 26.8.39.19(26.8 LTS)。新实例和 ClickHouseKeeperInstallation 仲裁组默认使用 26.8.39.19;在 pod 模板中固定服务器镜像的现有实例会继续使用该镜像,直到按照升级中的说明进行更新。在 arm64 上,服务器镜像包含用于兼容 ARMv8.0+ 处理器(包括 Huawei Kunpeng 920)的 arm_v80compat(armv8.0-a+crc)构建版本。
  • 运行时基础镜像和安全更新。clickhouse-server 运行时基础镜像从 Ubuntu 20.04(glibc 2.31)切换为 AlmaLinux 10.3 Minimal(glibc 2.39),clickhouse-log sidecar 镜像也从 busybox 切换为由软件包管理的 alpine:3.23.3。operator 和 metrics exporter 使用 Go 1.26.11 在 Alpine 3.23.3 上编译,并更新了 Go 依赖项,包括 golang.org/x/net 0.62.0 和 OpenTelemetry 1.47.0。

升级说明

  • 升级 operator 会使 ClickHouse pod 重启一次。新的 operator 以不同方式渲染主机配置和 StatefulSet,因此每个实例都会进行一次滚动重启,每次处理一个主机,同时保留其数据卷。单副本实例的 pod 重启期间将不可用。请参阅升级。
  • 手动构建的 Keeper 仲裁组不受影响。在 zookeeper.nodes 下列出仲裁组成员的实例将继续正常运行。是否迁移到 ClickHouseKeeperInstallation 是可选的,相关说明请参阅部署 Keeper 仲裁组。
  • 一旦存在 ClickHouseKeeperInstallation,便不支持将 operator 回滚到 v4.4.x。

v4.4.0

新增和优化功能

  • 新的产品名称。该插件现列为 Alauda Data Services Analytical Database E1。此更改仅涉及显示名称:软件包名称、自定义资源类型和 API 组,以及现有实例均未更改。
  • ClickHouse® 引擎 25.8.33.6。默认服务器镜像从 25.8.16.34 更新为 25.8.33.6,这是同一 25.8 LTS 系列中的补丁版本。新实例默认使用该版本;现有实例会继续使用其指定的镜像,除非按照升级中的说明进行更改。
  • 重新构建的镜像。operator 和 metrics exporter 使用更新后的 Go 工具链在更新后的 Alpine 基础镜像上编译,busybox 辅助镜像则固定为特定标签,而不再使用浮动标签。ClickHouse 服务器镜像包含其基础镜像截至 2.31-0ubuntu9.18 发布的 GNU C Library 安全更新,并同时支持 amd64 和 arm64。
  • 镜像来源信息。operator、metrics exporter 和 bundle 镜像带有 org.opencontainers.image.source、org.opencontainers.image.revision 和 org.opencontainers.image.ref.name 标签,用于标识其构建来源。
  • 感知内存的 operator 运行时。operator 和 metrics exporter 根据其容器内存限制设置 Go 运行时的软内存限制,从而降低大型安装中 operator 因 OOM 被终止的风险。
  • 许可证声明。从上游项目修改的文件包含修改声明,且 operator、metrics exporter 和服务器镜像中均包含许可证文本。

行为变更

  • 实例状态现在反映 Pod 就绪情况。仅当每个主机的 StatefulSet 报告其所需副本数均已就绪时,实例才会标记为 Completed;如果某个主机之后失去就绪状态,实例会返回 InProgress。Pod 再次就绪后,实例会自动恢复为 Completed;无需更改实例即可清除该状态。升级后,Pod 不健康的实例会报告 InProgress,而早期版本会报告 Completed。请参阅Pod 不健康时实例报告 Completed。
  • operator 要求配置服务器镜像。如果未配置服务器镜像,operator 不再回退到内置的服务器镜像引用,而是在启动时报告配置错误。通过插件软件包安装时始终会配置镜像,因此不受影响。

升级说明

  • 升级 operator 会重启 ClickHouse Pod。新的 operator 会更改默认服务器镜像和共享日志记录器配置,因此所有未指定自有服务器镜像的实例都会执行滚动重启,每次重启一个副本。单副本实例会在其 Pod 重启期间不可用。如果运行单副本实例,请将 operator 升级安排在维护时段内。

已修复的问题

  • ClickHouse 无法以非 root 用户启动。默认日志记录器配置将错误日志指向 /dev/null。服务器根据该路径推导其日志目录,并尝试管理 /dev;没有 root 权限时此操作会失败,因此 Pod 以非 root 用户运行的实例(包括位于强制执行 Pod Security Admission restricted 配置文件的命名空间中的任何实例)始终无法启动。现在错误日志会写入 /var/log/clickhouse-server/clickhouse-server.err.log。
  • Pod 失败时实例仍报告 Completed。所有对象提交完成后 reconcile 过程就会被标记为完成,而不会等待 Pod 就绪;当 Pod 后续失败时,已经达到 Completed 的状态也不会更新。这两种情况现已修复;请参阅上文的“行为变更”。

已知问题

  • 在 Pod Security Admission restricted 配置文件下,设置了 logVolumeClaimTemplate 的实例会被拒绝,除非自行定义日志容器。operator 会添加一个 clickhouse-log 容器,其安全上下文仅设置用户 ID。请在 Pod 模板中定义名为 clickhouse-log 的容器,并为其设置符合要求的安全上下文。请参阅Pod 被 Pod Security Admission 拒绝。
  • 内存限制低于 2 GiB 的实例可能拒绝小型查询。ClickHouse 会将自身内存使用量限制为容器内存限制的 90%,而空闲服务器的常驻内存可能接近 1 GiB。在 1 GiB 限制下,服务器即使处于空闲状态也可能超过其上限,并因 Code: 241 … (total) memory limit exceeded 而无法执行甚至是非常简单的查询。请将 clickhouse 容器的 resources.limits.memory 设置为至少 2Gi。如果不设置限制,容器会继承命名空间 LimitRange 的默认内存限制,而该限制可能低于 2 GiB。早期版本同样受此影响。
  • 在 operator 升级更新实例期间删除实例,所需时间会比通常更长。将 operator 升级到此版本后,未设置服务器镜像的实例会逐个主机更新为新的服务器镜像。如果在此更新期间删除此类实例,删除操作要等到所有主机完成更新后才会开始,每个主机可能需要数分钟。之后删除操作会完成。

ClickHouse 是 ClickHouse, Inc. 的注册商标。https://clickhouse.com

Alauda 是独立供应商。本产品与 ClickHouse, Inc. 没有关联,也未获得其认可或赞助。所有商标均归其各自所有者所有,此处仅用于标识目的。