ppc64le/cassandra 镜像文档

镜像概述和主要用途

ppc64le/cassandra 是针对 ppc64le 架构构建的 Apache Cassandra 官方镜像的特定架构仓库。Apache Cassandra 是一款开源分布式数据库管理系统，旨在跨多台普通服务器处理大量数据，提供高可用性且无单点故障。该镜像适用于在 ppc64le 架构环境中快速部署和运行 Cassandra 数据库，支持集群部署、多数据中心扩展及低延迟数据操作。

核心功能和特性

• 分布式架构：支持跨多服务器集群部署，数据自动分片存储，具备线性扩展能力
• 高可用性：无单点故障设计，通过多副本机制确保数据可靠性
• 多数据中心支持：原生支持跨数据中心集群，满足地理分布式部署需求
• 异步无主复制：采用 gossip 协议实现节点间数据同步，支持低延迟读写操作
• 灵活的数据模型：基于列族的数据模型，支持动态 schema 调整，适合半结构化数据存储
• 高写入性能：优化的写入路径设计，适合写入密集型应用场景

使用场景和适用范围

• 大数据存储与处理：需存储和管理 TB/PB 级海量数据的场景
• 高可用关键业务：金融、电商等对数据可用性要求极高的核心系统
• 跨地域部署：需在多个数据中心部署以实现低延迟访问的全球化应用
• 写入密集型应用：日志收集、传感器数据、用户行为分析等高频写入场景
• 弹性扩展需求：业务增长快，需通过添加节点快速扩展存储和计算能力的场景

支持的标签及对应 Dockerfile 链接

快速参考

维护者

Docker 社区

获取帮助

• Docker 社区 Slack
• Server Fault
• Unix & Linux Stack Exchange
• Stack Overflow

提交 issues

[***]

支持的架构

amd64, arm32v7, arm64v8, ppc64le, s390x

镜像元数据

repo-info 仓库的 repos/cassandra/ 目录（包含镜像元数据、传输大小等）

详细使用方法和配置说明

启动单个 Cassandra 服务实例

通过以下命令启动一个基础的 Cassandra 容器：

$ docker run --name some-cassandra --network some-network -d ppc64le/cassandra:tag

• some-cassandra：容器名称（可自定义）
• some-network：Docker 网络（需提前创建，如 docker network create some-network）
• tag：指定 Cassandra 版本标签（如 5.0.5、latest，见「支持的标签」列表）

创建 Cassandra 集群

同一主机多实例集群

1. 启动第一个节点（种子节点）：

   $ docker run --name some-cassandra -d --network some-network ppc64le/cassandra:tag
   

2. 启动后续节点，指定种子节点地址：

   $ docker run --name some-cassandra2 -d --network some-network -e CASSANDRA_SEEDS=some-cassandra ppc64le/cassandra:tag
   

   （some-cassandra 为第一个节点的容器名称，Docker 网络内部可通过容器名解析 IP）

跨主机集群（如两台云服务器）

假设主机 A IP 为 10.42.42.42，主机 B IP 为 10.43.43.43：

1. 在主机 A 启动种子节点，暴露 gossip 端口（7000）并指定广播地址：

   $ docker run --name some-cassandra -d -e CASSANDRA_BROADCAST_ADDRESS=10.42.42.42 -p 7000:7000 ppc64le/cassandra:tag
   

2. 在主机 B 启动节点，指向主机 A 的种子节点：

   $ docker run --name some-cassandra -d -e CASSANDRA_BROADCAST_ADDRESS=10.43.43.43 -p 7000:7000 -e CASSANDRA_SEEDS=10.42.42.42 ppc64le/cassandra:tag
   

使用 cqlsh 连接 Cassandra

通过以下命令启动临时容器并运行 cqlsh（Cassandra 查询语言 shell）连接到集群：

$ docker run -it --network some-network --rm ppc64le/cassandra cqlsh some-cassandra

• --rm：容器退出后自动删除
• some-cassandra：目标 Cassandra 节点的容器名称或 IP

容器 shell 访问与日志查看

进入容器 shell

$ docker exec -it some-cassandra bash

查看 Cassandra 日志

$ docker logs some-cassandra

配置 Cassandra

方法 1：通过环境变量配置

镜像支持以下环境变量，用于修改 cassandra.yaml 配置（变量名对应配置项说明如下）：

方法 2：挂载自定义配置文件

通过绑定挂载自定义 cassandra.yaml 覆盖默认配置：

$ docker run --name some-cassandra -v /host/path/to/cassandra.yaml:/etc/cassandra/cassandra.yaml -d ppc64le/cassandra:tag

若需使用非默认配置文件名，可通过启动参数指定：

$ docker run --name some-cassandra -d ppc64le/cassandra:tag -Dcassandra.config=/path/to/custom-config.yaml

Docker Compose 部署示例（单节点）

创建 docker-compose.yml 文件：

version: '3'
services:
  cassandra:
    image: ppc64le/cassandra:latest
    container_name: some-cassandra
    ports:
      - "7000:7000"   # Gossip 通信端口
      - "9042:9042"   # CQL 端口
    volumes:
      - /my/own/datadir:/var/lib/cassandra  # 数据持久化
    environment:
      - CASSANDRA_CLUSTER_NAME=MyCluster
      - CASSANDRA_NUM_TOKENS=256
    networks:
      - cassandra-network

networks:
  cassandra-network:
    driver: bridge

启动服务：

$ docker-compose up -d

注意事项

数据存储位置

Cassandra 默认将数据存储在容器内 /var/lib/cassandra 目录。为避免数据丢失，建议通过 -v 参数挂载主机目录持久化数据：

$ docker run --name some-cassandra -v /my/own/datadir:/var/lib/cassandra -d ppc64le/cassandra:tag

（/my/own/datadir 为主机目录，需确保权限正确，如 chmod 777 /my/own/datadir）

初始化完成前无法连接

容器启动时，若首次初始化数据库，需等待初始化完成后才能接受连接。自动化部署（如 Docker Compose 多容器同时启动）可能需添加重试机制或健康检查。

许可证

软件许可证

镜像中 Cassandra 软件的许可证信息见 Apache Cassandra 许可证。

其他软件许可证

该镜像可能包含基础系统（如 Ubuntu）及依赖软件（如 Bash 等），其许可证可能不同。详细信息可参考 repo-info 仓库的 cassandra/ 目录。

使用前请确保遵守所有包含软件的许可证要求。