Alauda build of CloudNativePG
  • 简体中文

    • 安装

    本页介绍如何安装 Alauda 版本的 CloudNativePG operator。安装完成后，你可以通过应用一个 Cluster CR 来部署你的第一个 PostgreSQL 集群（Functions 指南将在后续版本中提供）。

    目录

    前提条件通过平台目录安装（推荐）验证安装下一步

    前提条件

    • 一个 Alauda Container Platform (ACP) 集群，版本 4.3 或更高。
    • Cluster admin 或 platform admin 访问权限。
    • 已为你的版本下载 cloudnative-pg package（.tgz）——通常通过平台目录 UI 安装。
    • 目标集群中可用的块模式 StorageClass（例如 global-topolvmsc）。

    通过平台目录安装（推荐）

    Web Console
    kubectl
    1. 在左侧导航栏中，进入 Marketplace > Operator Hub。
    2. 选择你的目标集群。
    3. 在 platform catalog source 下搜索 CloudNativePG。
    4. 点击 Install。
    5. 在安装对话框中，接受建议的 namespace cnpg-system（该 bundle 通过 operatorframework.io/suggested-namespace 注解声明了这一点），选择 channel stable，install plan approval Automatic，然后确认。
    6. 等待 operator 的 CSV 进入 Succeeded 阶段，并且 cnpg-controller-manager deployment 达到 1/1 Ready。

    验证安装

    在 CSV 为 Succeeded 后：

    kubectl get csv -n cnpg-system
kubectl get deploy cnpg-controller-manager -n cnpg-system
kubectl get pods -n cnpg-system

    预期结果：

    • 一个 CSV cloudnative-pg.<version>，阶段为 Succeeded。
    • cnpg-controller-manager deployment，1/1 ready replicas。
    • 一个 operator pod cnpg-controller-manager-<hash> 正在运行。

    检查 operator 的环境变量，确认 ACP 特定的默认值：

    kubectl get deploy cnpg-controller-manager -n cnpg-system \
  -o jsonpath='{.spec.template.spec.containers[0].env}' | python3 -c "
import json,sys
[print(e['name'], '=', e.get('value','')) for e in json.load(sys.stdin)
 if e['name'] in ('ENABLE_IMAGE_REWRITE_TOLERANCE','POSTGRES_IMAGE_NAME','PGBOUNCER_IMAGE_NAME')]"

    你应看到：

    • ENABLE_IMAGE_REWRITE_TOLERANCE = true
    • POSTGRES_IMAGE_NAME = build-harbor.alauda.cn/middleware/cnpg/postgresql:18.3-standard-trixie
    • PGBOUNCER_IMAGE_NAME = build-harbor.alauda.cn/middleware/cnpg/pgbouncer:1.25.1

    如果 POSTGRES_IMAGE_NAME 带有时间戳标签（例如 18.3-202605070509-standard-trixie），或者缺少 ENABLE_IMAGE_REWRITE_TOLERANCE，说明你使用的是 pre-v1.29.0-acp.1 build。请参阅 升级 了解修复操作步骤。

    下一步

    • 架构 — operator + Cluster CR model。
    • 升级 — patch/minor version upgrade 操作步骤。
    • release notes — 各版本变更。

    “创建集群”演练和 Troubleshooting 参考将安排在后续的文档版本中。目前，架构页面介绍了 Cluster CR model，而升级页面包含常见安装问题的诊断步骤。