kineticdata/cassandra-cqlsh

Cassandra脚本执行工具容器

镜像概述

本镜像为实用工具容器，专门设计用于执行Apache Cassandra数据库相关脚本。它集成了必要的客户端工具与运行环境，简化了与Cassandra集群的脚本交互流程，适用于数据库初始化、数据迁移、定时维护及开发测试等场景。

核心功能与特性

核心功能

• 预安装Cassandra官方客户端工具（如cqlsh），支持直接执行CQL脚本
• 兼容多种脚本类型，包括CQL脚本（.cql）、Shell脚本（.sh）及Python脚本（需依赖Cassandra Python驱动）
• 支持与远程Cassandra集群建立安全连接，执行脚本时自动处理连接配置

特性

• 轻量级设计：基于精简基础镜像，减少资源占用
• 灵活挂载：支持通过卷挂载本地脚本文件/目录，无需内置脚本到镜像
• 环境变量配置：通过环境变量快速配置Cassandra连接参数，无需手动修改配置文件
• 易于集成：可无缝接入CI/CD流程、容器编排平台（如Kubernetes）及定时任务系统

使用场景

1. 数据库初始化
   执行schema创建脚本（如创建keyspace、table），完成Cassandra集群的初始配置。

2. 数据迁移
   运行数据导入/导出脚本，实现跨集群数据迁移或备份恢复。

3. 定时维护任务
   集成到定时任务系统（如Cron），定期执行数据清理、索引优化等维护脚本。

4. 开发与测试
   开发阶段快速验证脚本功能，或在测试环境自动化执行测试脚本。

使用方法

基本使用（执行本地CQL脚本）

通过docker run命令启动容器，挂载本地脚本目录并执行指定CQL脚本：

bash
docker run -it --rm \
  -v /path/to/local/scripts:/scripts \  # 挂载本地脚本目录到容器内/scripts
  -e CASSANDRA_HOST=cassandra-cluster  # 指定Cassandra集群地址
  -e CASSANDRA_PORT=9042              # 指定Cassandra CQL端口（默认9042）
  -e CASSANDRA_USER=admin             # （可选）Cassandra认证用户名
  -e CASSANDRA_PASSWORD=secret        # （可选）Cassandra认证密码
  [镜像名称] \
  cqlsh -f /scripts/init_schema.cql   # 执行CQL脚本

执行Shell脚本

若需执行包含多个CQL命令或逻辑控制的Shell脚本，可直接运行挂载的.sh文件：

bash
docker run -it --rm \
  -v /path/to/local/scripts:/scripts \
  -e CASSANDRA_HOST=cassandra-cluster \
  [镜像名称] \
  sh /scripts/migrate_data.sh  # 执行Shell脚本

集成到Docker Compose

在docker-compose.yml中配置服务，用于应用启动前执行数据库初始化：

yaml
version: '3'
services:
  cassandra-script:
    image: [镜像名称]
    volumes:
      - ./init-scripts:/scripts
    environment:
      - CASSANDRA_HOST=cassandra
      - CASSANDRA_PORT=9042
    command: cqlsh -f /scripts/init.cql
    depends_on:
      - cassandra  # 依赖Cassandra服务启动后执行

  cassandra:
    image: cassandra:latest
    ports:
      - "9042:9042"

配置参数

环境变量

卷挂载

建议挂载本地脚本目录至容器内/scripts路径，便于灵活管理脚本文件，避免每次修改脚本需重新构建镜像。

注意事项

• 确保Cassandra集群与容器网络互通，可通过--network参数指定共享网络
• 执行敏感操作（如数据删除）前，建议先在测试环境验证脚本
• 如需使用SSL连接Cassandra集群，通过CQLSH_OPTS="--ssl"配置，并挂载SSL证书至容器内对应路径