datastax/dse-server

DataStax Enterprise Docker镜像文档

镜像概述和主要用途

DataStax Enterprise（DSE）基于Apache Cassandra™的最佳发行版构建，是一款专为实时应用设计的始终可用的数据库。它将图、搜索、分析、管理、开发工具和监控集成到单一统一平台中，支持轻松构建和扩展应用，为实时业务场景提供即时洞察和强大的客户体验。

核心功能和特性

• 统一平台：集成Apache Cassandra™的事务能力、搜索、分析（Spark）和图功能于一体
• 高可用性：专为始终在线设计，支持无缝扩展
• 多工作负载支持：同时处理事务、搜索、分析和图数据需求
• 灵活配置：通过环境变量、配置卷或自定义配置文件进行灵活配置
• 数据持久化：支持挂载卷以持久化存储数据，防止容器删除时数据丢失

使用场景和适用范围

适用于需要处理实时数据、构建高可用分布式应用的场景，包括：

• 实时客户体验应用
• 大规模数据存储与检索系统
• 复杂关系分析（图数据库应用）
• 全文搜索应用
• 实时分析与报表系统

详细使用方法和配置说明

快速参考

获取帮助

DataStax Docker文档、DataStax ***、https://github.com/datastax/docker-images%E3%80%81%E8%81%94%E7%B3%BBDataStax%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E4%BF%A1%E6%81%AF

高级教程位于DataStax Academy和https://hub.docker.com/r/datastax/dse-studio/%EF%BC%8C%E7%A4%BA%E4%BE%8BCompose%E6%96%87%E4%BB%B6%E5%8F%AF%E5%9C%A8https://github.com/datastax/docker-images/tree/master/example_compose_yamls%E8%8E%B7%E5%8F%96

特色教程 - DataStax Enterprise 6 导览

问题反馈

https://github.com/datastax/docker-images/issues

维护方

DataStax

创建DataStax Enterprise容器

默认情况下，DSE服务器镜像以仅Cassandra模式运行。要启用高级DSE功能，可在docker run命令末尾添加以下选项的任意组合：

可组合使用启动选项以运行多个功能。更多示例参见以独立进程启动DataStax Enterprise。

示例

创建DSE数据库容器

bash
docker run -e DS_LICENSE=accept --name my-dse -d datastax/dse-server:<版本标签>

创建启用图功能的DSE容器

bash
docker run -e DS_LICENSE=accept --name my-dse -d datastax/dse-server:<版本标签> -g

创建启用分析（Spark）的DSE容器

bash
docker run -e DS_LICENSE=accept --name my-dse -d datastax/dse-server:<版本标签> -k

创建启用搜索功能的DSE容器

bash
docker run -e DS_LICENSE=accept --name my-dse -d datastax/dse-server:<版本标签> -s

创建同时启用搜索、分析和图功能的DSE容器

bash
docker run -e DS_LICENSE=accept --name my-dse -d datastax/dse-server:<版本标签> -s -k -g

配置管理

可通过以下方式管理DSE配置：

使用DSE配置卷

1. 在本地主机创建目录
2. 从https://github.com/datastax/docker-images/tree/master/config-templates%E4%B8%8B%E8%BD%BD%E5%B9%B6%E8%87%AA%E5%AE%9A%E4%B9%89%E6%89%80%E9%9C%80%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6
3. 将自定义配置文件添加到本地目录（文件名必须与镜像中的对应配置文件匹配，如cassandra.yaml、dse.yaml）
4. 将暴露的卷/config挂载到本地目录
5. 启动容器，例如：

bash
docker run -e DS_LICENSE=accept --name my-dse -v /dse/config:/config -d datastax/dse-server:<版本标签>

注意：修改/config卷中的配置文件后，需通过docker restart container_name重启容器使DSE生效。

使用环境变量

通过docker run命令的-e标志设置环境变量配置DSE镜像。

注意：使用内存资源限制时，必须通过环境变量JVM_EXTRA_OPTS或自定义cassandra-env.sh设置JVM堆大小，否则DSE会将堆大小设为Docker主机物理内存的1/4。

卷和数据

要持久化数据，需在本地主机预创建目录，并使用docker run -v标志将目录映射到对应卷。

注意：若未从本地主机挂载卷，容器删除时所有数据将丢失。

DSE镜像暴露以下卷：

• 对于DataStax Enterprise事务、搜索、图和分析工作负载：
  • /var/lib/cassandra：Cassandra数据
  • /var/lib/spark：DSE分析（含Spark）数据
  • /var/lib/dsefs：DSEFS数据
  • /var/log/cassandra：Cassandra日志
  • /var/log/spark：Spark日志

挂载示例：

bash
docker run -v <本地目录>:<容器卷>

更多信息参见Docker文档>使用卷。

运行DSE命令和查看日志

使用docker exec -it <容器名称>命令执行特定命令。

打开交互式bash shell

若容器在后台运行（使用-d），可通过以下命令打开交互式bash shell运行DSE命令：

bash
docker exec -it <容器名称> bash

输入exit可退出shell而不停止容器。

打开交互式CQL shell（cqlsh）

bash
docker exec -it <容器名称> cqlsh

查看节点状态

bash
docker exec -it <容器名称> nodetool status

查看日志

使用Docker日志命令查看DSE日志：

bash
docker logs <容器名称>

下一步

高级教程位于DataStax Academy和https://hub.docker.com/r/datastax/dse-studio/%EF%BC%8C%E7%A4%BA%E4%BE%8BCompose%E6%96%87%E4%BB%B6%E5%8F%AF%E5%9C%A8https://github.com/datastax/docker-images/tree/master/example_compose_yamls%E8%8E%B7%E5%8F%96%E3%80%82

许可证

DataStax许可条款