nuvo/docker-cqlsh

docker-cqlsh

镜像概述

本镜像将cqlsh工具容器化，方便用户在容器环境中快速使用cqlsh连接Cassandra集群，执行CQL命令或加载数据脚本，无需在本地安装cqlsh及依赖。

核心功能

1. 启动容器时自动执行/scripts路径下的所有.cql文件，向Cassandra加载数据；
2. 无需直接进入Cassandra容器，即可远程执行CQL命令；
3. 通过环境变量灵活配置Cassandra连接参数（如主机、端口、CQL版本）。

使用场景

• 本地测试Cassandra集群时，快速连接并执行命令；
• Kubernetes环境中，作为Job批量执行CQL脚本完成数据初始化；
• 团队协作中，统一cqlsh工具版本，避免环境差异问题。

配置说明

环境变量

• CQLVERSION：使用的原生传输版本，默认值为3.4.4；
• CQLSH_HOST：Cassandra主机地址，默认值为cassandra；
• CQLSH_PORT：Cassandra端口，默认值为9042。

部署示例

独立实例

启动Cassandra容器并连接：

shell
$ docker run -d -p 9042:9042 cassandra
$ docker run --rm -it -e CQLSH_HOST=localhost --net=host nuvo/docker-cqlsh bash
bash-4.4$ cqlsh -e "show host;"
Connected to Test Cluster at localhost:9042.

Kubernetes Job

用于执行CQL脚本的Kubernetes Job配置：

yaml
apiVersion: batch/v1
kind: Job
metadata:
  name: load-cql-files
spec:
  backoffLimit: 5
  activeDeadlineSeconds: 100
  template:
    spec:
      containers:
      - name: cqlsh
        image: nuvo/docker-cqlsh
        env:
        - name: CQLSH_HOST
          value: cassandra-svc
        volumeMounts:
        - mountPath: /scripts
          name: scripts
      volumes:
      - name: scripts
        configMap:
          name: cql-files
      restartPolicy: Never

许可证

本项目采用Apache 2.0许可证，详情请查看https://github.com/nuvo/docker-cqlsh/blob/master/LICENSE%E6%96%87%E4%BB%B6%E3%80%82

关于cqlsh

cqlsh是基于Python的命令行工具，是在Cassandra集群上运行简单CQL命令的最直接方式。本镜像重新打包了这个开源工具，以便在虚拟环境中安装和运行。