streamnative/sn-platform-slim

StreamNative Pulsar 操作符与镜像整合技术文档

1. 镜像概述和主要用途

1.1 概述

StreamNative 于 2024 年 3 月 31 日推出 Pulsar 集群管理优化方案，通过整合操作符（Operator）与镜像（Image）资源，简化 Pulsar 集群部署与运维流程，消除多变体带来的复杂性。该方案包括操作符与镜像两方面的整合：

• 操作符整合：将原有的 streamnative/pulsar-operator、streamnative/bookkeeper-operator 和 streamnative/zookeeper-operator 合并为单一操作符 streamnative/sn-operator，集中提供更新与维护。
• 镜像整合：将原有的多版本 Pulsar 镜像（streamnative/pulsar、streamnative/pulsar-all、streamnative/sn-pulsar）整合为两个变体：streamnative/sn-platform 和 streamnative/sn-platform-slim。

1.2 主要用途

• 简化集群管理：通过单一操作符统一管理 Pulsar、BookKeeper、ZooKeeper 组件，减少多操作符维护成本。
• 标准化镜像资源：提供两个镜像变体，减少版本混乱，适配不同部署需求（如全功能场景与资源受限场景）。
• 优化支持与服务：通过新许可机制，为商业客户提供更精准的技术支持、故障排查与咨询服务。

2. 核心功能与特性

2.1 StreamNative Operator（sn-operator）

• 整合性：合并原三个独立操作符（Pulsar、BookKeeper、ZooKeeper）为单一组件，统一生命周期管理。
• 集中更新：所有功能增强、补丁与升级仅针对 streamnative/sn-operator 发布，原操作符（版本 ≤0.17.10）停止更新。
• 简化部署：通过单一操作符实现 Pulsar 集群全组件（Pulsar Broker、BookKeeper、ZooKeeper）的自动化部署与运维。

2.2 StreamNative Pulsar 镜像

• 标准化变体：
  • streamnative/sn-platform：全功能镜像，包含 Pulsar 完整组件与工具，适用于生产环境全功能部署。
  • streamnative/sn-platform-slim：精简版镜像，去除非核心工具与依赖，适用于资源受限环境或边缘部署。
• 镜像生命周期管理：2024 年 3 月 31 日起，原镜像（streamnative/pulsar、streamnative/pulsar-all、streamnative/sn-pulsar）从 Docker Hub 移除，不再提供更新。

3. 使用场景与适用范围

3.1 现有 StreamNative 客户

• 适用场景：需要持续使用 StreamNative 商业支持的 Pulsar 集群部署与运维。
• 要求：2024 年 3 月 31 日后，部署需提供有效的许可证密钥，用于支持服务身份标识与服务优化。

3.2 未来 StreamNative 客户

• 适用场景：计划采用 StreamNative 商业方案构建 Pulsar 集群，需专业支持与服务。
• 要求：需签署商业协议或获取有效订阅许可，未授权用户需联系 StreamNative 团队咨询需求。

3.3 开源方案用户

• 适用场景：偏好社区支持的开源方案，无需商业许可。
• 建议方案：迁移至 Apache Pulsar 社区方案，包括：
  • 使用 https://github.com/apache/pulsar-helm-chart 部署集群。
  • 使用 https://hub.docker.com/u/apachepulsar%EF%BC%88%E9%81%B5%E5%BE%AA Apache Pulsar 发布政策）。

4. 使用方法与配置说明

4.1 现有客户升级与部署

1. 获取许可证密钥：通过 StreamNative 客户支持渠道获取有效许可证密钥。
2. 升级操作符：参考 官方升级文档 完成从原有 Pulsar 操作符到 sn-operator 的迁移。
3. 替换镜像：将集群配置中的镜像路径更新为 streamnative/sn-platform 或 streamnative/sn-platform-slim，指定标签版本（如 latest 或具体版本号）。

4.2 未来客户订阅与部署

1. 联系 StreamNative 团队：通过 官方联系渠道 咨询订阅需求，签署商业协议。
2. 获取部署资源：根据协议获取 sn-operator 与 sn-platform 镜像的访问权限及部署指南。
3. 配置许可：在部署配置中注入订阅许可密钥（具体参数参考官方提供的部署文档）。

4.3 开源用户迁移步骤

1. 卸载现有 StreamNative 组件：移除原 streamnative/pulsar-operator 等操作符及相关镜像。
2. 部署 Apache Pulsar Helm Chart：

   bash
   # 添加 Apache Pulsar Helm 仓库
   helm repo add apache-pulsar https://pulsar.apache.org/charts
   helm repo update
   
   # 部署 Pulsar 集群（示例配置）
   helm install pulsar apache-pulsar/pulsar --namespace pulsar --create-namespace
   

3. 使用 Apache Pulsar 官方镜像：配置集群使用 apachepulsar/pulsar-all 等官方镜像，参考 https://hub.docker.com/r/apachepulsar/pulsar-all 选择版本。

5. 许可说明

5.1 StreamNative 商业组件许可

• 生效时间：2024 年 3 月 31 日起，sn-operator 与 sn-platform 系列镜像需商业许可或订阅方可使用。
• 原有操作符许可终止：2024 年 4 月 15 日后，原 Pulsar 操作符（版本 ≤0.17.10）不再受 StreamNative Community License 许可，禁止未授权使用。

5.2 开源替代方案许可

• Apache Pulsar 社区镜像与 Helm Chart 遵循 Apache License 2.0，完全开源，用户可自由使用、修改与分发，详情参考 Apache Pulsar 许可政策。