redpandadata/redpanda-internal

Redpanda (内部/不支持/未发布版本) Docker镜像文档

1. 镜像概述和主要用途

1.1 镜像概述

本镜像包含Redpanda的内部、不支持或未发布版本，仅供开发、测试或内部验证场景使用。不建议用于生产环境。
官方稳定版Redpanda Docker镜像请参考：https://hub.docker.com/r/redpandadata/redpanda%E3%80%82

1.2 主要用途

Redpanda是一个分布式流数据平台，兼容Apache Kafka® API，旨在提供高吞吐量、低延迟的实时数据传输能力。本镜像中的版本可用于早期功能验证、开发环境测试或内部特性评估。

2. 核心功能和特性

（注：以下特性基于Redpanda通用功能集描述，当前镜像版本可能存在功能不稳定、未完全实现或与官方稳定版差异，具体以实际镜像内容为准）

• Kafka API兼容：支持Kafka协议，可无缝替换现有Kafka集群，无需修改客户端代码。
• Raft共识算法：基于Raft协议实现分布式数据一致性，确保高可用性和分区容错性。
• 高性能存储引擎：采用自研存储引擎，优化磁盘I/O，支持百万级消息/秒的吞吐量。
• 低延迟处理：最小化消息传输延迟，适合实时流处理场景（微秒级端到端延迟）。
• 多租户支持：通过命名空间和访问控制列表（ACL）实现资源隔离与权限管理。

3. 使用场景和适用范围

3.1 适用场景

• 开发环境测试：验证Redpanda新功能或特性在开发阶段的表现。
• 内部功能评估：团队内部评估未发布特性的可行性、性能或兼容性。
• 临时原型验证：快速搭建测试集群，验证流数据处理逻辑或客户端集成。

3.2 不适用场景

• 生产环境部署：本镜像版本未经过官方测试和支持，存在稳定性、安全性风险。
• 关键业务系统：不保证数据可靠性或服务可用性，可能导致数据丢失或服务中断。

4. 使用方法和配置说明

4.1 前置要求

• Docker Engine 20.10+
• 单节点测试建议至少2GB内存，多节点测试建议8GB+内存

4.2 基本使用（Docker Run）

以下为单节点启动示例，用于快速验证镜像可用性：

bash
docker run -d \
  --name redpanda-unreleased \
  -p 9092:9092 \  # Kafka API端口（客户端连接）
  -p 8081:8081 \  # Admin API端口（集群管理）
  -e REDPANDA_NODE_ID=0 \  # 节点唯一ID（集群内不可重复）
  -e REDPANDA_SEEDS="" \  # 单节点模式无需种子节点
  -e REDPANDA_ADVERTISED_KAFKA_API_ADDR=localhost:9092 \  # 客户端访问地址
  redpandadata/redpanda:latest  # 替换为实际镜像标签（如内部版本号）

4.3 多节点集群示例（Docker Compose）

创建docker-compose.yml文件，快速搭建2节点测试集群：

yaml
version: '3.8'
services:
  redpanda-0:
    image: redpandadata/redpanda:latest  # 替换为实际镜像标签
    container_name: redpanda-0
    ports:
      - "9092:9092"  # Kafka API
      - "8081:8081"  # Admin API
    environment:
      - REDPANDA_NODE_ID=0
      - REDPANDA_SEEDS=redpanda-0:33145  # 种子节点RPC地址（集群发现）
      - REDPANDA_ADVERTISED_KAFKA_API_ADDR=localhost:9092
      - REDPANDA_ADVERTISED_RPC_ADDR=redpanda-0:33145  # 节点间通信地址
    volumes:
      - redpanda-0-data:/var/lib/redpanda/data  # 数据持久化

  redpanda-1:
    image: redpandadata/redpanda:latest  # 替换为实际镜像标签
    container_name: redpanda-1
    ports:
      - "9093:9092"  # 避免端口冲突，映射到主机9093
      - "8082:8081"
    environment:
      - REDPANDA_NODE_ID=1
      - REDPANDA_SEEDS=redpanda-0:33145  # 连接到seed节点redpanda-0
      - REDPANDA_ADVERTISED_KAFKA_API_ADDR=localhost:9093
      - REDPANDA_ADVERTISED_RPC_ADDR=redpanda-1:33145
    volumes:
      - redpanda-1-data:/var/lib/redpanda/data

volumes:
  redpanda-0-data:
  redpanda-1-data:

启动集群：

bash
docker-compose up -d

5. 配置参数与环境变量

（注：以下参数基于Redpanda官方稳定版通用配置，当前镜像版本可能存在差异，建议参考镜像内置文档或联系内部维护者获取准确信息）

5.1 核心环境变量

5.2 高级配置

可通过挂载配置文件（如redpanda.yaml）自定义更多参数，配置文件默认路径为/etc/redpanda/redpanda.yaml。示例：

bash
docker run -d \
  --name redpanda-unreleased \
  -v $(pwd)/redpanda.yaml:/etc/redpanda/redpanda.yaml \  # 挂载自定义配置
  redpandadata/redpanda:latest

6. 注意事项

• 不支持声明：本镜像版本未经过Redpanda官方测试和支持，使用过程中遇到的问题请联系内部维护团队，而非Redpanda官方支持渠道。
• 数据安全：请勿在本镜像中存储敏感或生产数据，存在数据丢失风险。
• 版本兼容性：镜像标签可能频繁变更，建议固定具体版本标签（如v23.3.1-internal）以避免意外更新。

7. 参考链接

• 官方稳定版Redpanda Docker镜像：https://hub.docker.com/r/redpandadata/redpanda
• Redpanda官方文档：[***]