再见 greenplum_path.sh，你好 cloudberry-env.sh

2025-09-29
北京
本文字数：1923 字
阅读完需：约 6 分钟

Apache Cloudberry™ (Incubating) 是 Apache 软件基金会孵化项目，由 Greenplum 和 PostgreSQL 衍生而来，作为领先的开源 MPP 数据库，可用于建设企业级数据仓库，并适用于大规模分析和 AI/ML 工作负载。
GitHub: https://github.com/apache/cloudberry

本文翻译自 Apache Cloudberry 官方博文 https://cloudberry.apache.org/blog/from-greenplum-path.sh-to-cloudberry-env.sh，译文较原文有所调整。

概述

本文主要介绍 Apache Cloudberry 项目针对与用户直接接触的 greenplum_path.sh 脚本文件进行重命名的过渡计划，以确保与 Apache Cloudberry 官方品牌标识保持一致，并且遵循 ASF 商标政策。本计划将分两步走，旨在透明并最大限度地降低对用户的干扰。

背景：为什么需要进行此更改

随着 Apache Cloudberry (Incubating) 不断走向成熟，建立一个清晰、独立的品牌标识越发重要。虽然 Apache Cloudberry 项目基于 Greenplum 衍生而来，但现在 Apache Cloudberry 已托管在 ASF 孵化器旗下，并具有自身独特的发展演进路线。

“Greenplum”名称是博通公司（Broadcom Inc.）所有的注册商标。为了遵守 ASF 政策并避免潜在的商标混淆，Apache Cloudberry PPMC 通过在 Dev@ 邮件列表和 GitHub Issue 上进行的讨论达成了共识——重命名这一带有 Greenplum 名称并且与用户直接接触的遗留脚本。

分阶段过渡

为了顺利管理这一过渡，使其过程更加平滑，我们将分两个阶段实施这些变化：

第 1 阶段：非破坏性通知（Apache Cloudberry 2.0）

第一步已在 Pull Request #1189 中实现，并包含在即将发布的 Apache Cloudberry 2.0 版本中（备注：Cloudberry 2.0 已发布并应用此变更）。

变更内容：当用户运行 source greenplum_path.sh 时，将看到一条弹出通知，告知 Apache Cloudberry 项目独立于 Broadcom 控制下的 Greenplum，如下输出所示：

[gpadmin@cloudberry]$ source /usr/local/cloudberry-db/greenplum_path.sh# --------------------------------------------------------------------# NOTICE from the Apache Cloudberry PPMC# --------------------------------------------------------------------# This file uses the term 'greenplum' to maintain compatibility with# earlier versions of Apache Cloudberry, which was originally called# Greenplum. This usage does not refer to VMware Tanzu Greenplum,# nor does it imply that Apache Cloudberry (Incubating) is affiliated# with, endorsed by, or sponsored by Broadcom Inc.## This file will be renamed in a future Apache Cloudberry release to# ensure compliance with Apache Software Foundation guidelines.# We will announce the change on the project mailing list and website.## See: https://lists.apache.org/thread/b8o974mnnqk6zpy86dgll2pgqcvqgnwm# --------------------------------------------------------------------

复制代码

影响：该通知不会对用户传统行为造成破坏性影响。过往脚本和工作流将继续像以前一样运行。此步骤在用户执行相关命令时提供了即时的品牌说明，并提前通知即将进行的更名。

第 2 阶段：完全重命名（面向 2.1 版及后续版本）

第二步将完成品牌对齐。

变更内容：我们会将 greenplum_path.sh 正式更名为 cloudberry-env.sh。这项工作还可能包括对相关配置脚本和内部命名进行更广泛的审查，以确保一致性。
影响：这将是一个破坏性变更。用户需要运行命令 source cloudberry-env.sh 替代 source greenplum_path.sh。这一更改会记录在发行说明以及项目文档中，如果习惯于传统操作，可以按下面类似方式对新文件创建软链接： sudo ln -s /usr/local/cloudberry-db/cloudberry-env.sh /usr/local/cloudberry-db/greenplum_path.sh

变更影响

对于 2.0 版本：无需执行任何额外操作。只需注意，在设置环境变量时会显示该通知。
对于 2.1 版本：会更新关联文件名称以使用新的 cloudberry-env.sh，与传统操作习惯产生差异。

随着 Cloudberry 持续面向顶级项目成长，我们相信这一举措为 Apache Cloudberry 项目毕业及未来发展奠定了更坚实的基础。我们感谢所有参与本计划讨论的社区成员和 ASF 法律团队提供的宝贵意见和建议。

创作场景