DataStax OpsCenter Docker镜像文档

1. 镜像概述

DataStax OpsCenter 是 DataStax Enterprise (DSE) 的基于 Web 的可视化管理与监控解决方案。该镜像提供了便捷的部署方式，用于管理 DSE 集群的配置、监控性能指标及执行日常运维操作。

2. 核心功能与特性

• 可视化管理：通过 Web 界面实现 DSE 集群的可视化配置与管理，支持节点添加、服务启停等操作。
• 性能监控：实时收集并展示 DSE 集群的关键指标（如吞吐量、延迟、资源使用率等），提供趋势分析与告警功能。
• 与 DSE 深度集成：原生支持 DSE 所有核心组件（如 Cassandra、Spark、Graph 等），无需额外配置即可实现监控覆盖。
• 简化运维：内置 Agent 组件，与 DSE 容器无缝对接，无需手动安装监控代理。

3. 使用场景与适用范围

该镜像仅授权用于非生产环境的开发用途，具体适用场景包括：

• 学*** DSE、OpsCenter 及 DataStax Studio 的功能与操作；
• 测试应用与 DSE 集群的集成效果；
• 演示应用功能或 DSE 集群特性。

4. 使用方法与配置说明

4.1 快速开始

4.1.1 创建 OpsCenter 容器并连接 DSE 集群

以下步骤在同一 Docker 主机上创建 OpsCenter 容器及关联的 DSE 服务器容器：

1. 创建 OpsCenter 容器
   执行以下命令启动 OpsCenter 容器，映射必要端口（8888 为 Web 界面端口，61620 为 Agent 通信端口）：

   bash
   docker run -e DS_LICENSE=accept -d -p 8888:8888 -p 61620:61620 --name my-opscenter datastax/dse-opscenter:<version tag>
   

   如需持久化配置或自定义参数，可参考 4.2 配置管理 添加额外选项。

2. 创建关联的 DSE 容器
   启动 DSE 服务器容器，并通过 --link 选项关联至 OpsCenter 容器：

   bash
   docker run -e DS_LICENSE=accept --link my-opscenter:opscenter --name my-dse -d datastax/dse-server:<version tag>
   

3. 获取 DSE 容器 IP 地址
   在运行 DSE 容器的主机上执行以下命令，获取 DSE 节点的 IP：

   bash
   docker inspect my-dse | grep '"IPAddress":'
   

4. 访问 OpsCenter 并配置集群

   • 打开浏览器，访问 http://<DOCKER_HOST_IP>:8888；
   • 点击 "Manage existing cluster"（管理现有集群）；
   • 在 "host name" 字段输入步骤 3 获取的 DSE IP 地址；
   • 点击 "Install agents manually"（手动安装代理），注意：DSE 镜像已预安装代理，无需额外操作。

   完成后，OpsCenter 即可与 DSE 集群配合使用。详细操作参见 OpsCenter 用户指南。

4.2 配置管理

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

4.2.1 使用 DSE 配置卷

该方式无需自定义容器或过度使用主机卷，仅需将自定义配置文件挂载至容器的 /config 卷，容器会自动映射配置至内部路径。步骤如下：

1. 在本地主机创建目录（如 /opsc/config）；

2. 从 config-templates 下载并自定义所需配置文件（如 opscenterd.conf），确保文件名与镜像内对应配置文件一致且包含所有必填项；

3. 启动容器时挂载该目录至 /config 卷：

   bash
   docker run -e DS_LICENSE=accept --name my-opscenter -v /opsc/config:/config -d datastax/dse-opscenter:<version tag>
   

   注意：修改 /config 卷中的配置文件后，需通过 docker restart <container_name> 重启容器，DSE 服务将随容器重启并加载新配置。

4.2.2 其他配置方式

• Docker 文件/目录挂载：直接挂载主机目录至容器内配置文件路径（如 -v /local/path:/opt/opscenter/conf/opscenterd.conf）；
• Docker 覆盖文件系统：通过自定义 Dockerfile 修改配置。

4.3 数据持久化与卷管理

• 监控数据存储：OpsCenter 指标存储在 DSE 的 OpsCenter 键空间中，无需额外持久化配置。
• 配置文件持久化：如需持久化特定配置文件（如 opscenterd.conf），可通过目录挂载实现：
  1. 在 Docker 主机创建本地目录（如 /opsc/persist-config）；
  2. 启动容器时通过 -v 挂载目录至目标配置文件路径：

     bash
     docker run -e DS_LICENSE=accept -d -v /opsc/persist-config:/opt/opscenter/conf/opscenterd.conf datastax/dse-opscenter:<version tag> --name my-opscenter
     

4.4 容器管理

4.4.1 交互式 Bash Shell

若容器在后台运行（使用 -d 选项），可通过以下命令进入交互式 Bash 终端：

bash
docker exec -it <container_name> bash

输入 exit 可退出终端，容器将继续运行。

4.4.2 查看日志

通过 Docker 日志命令查看 OpsCenter 运行日志：

bash
docker logs my-opscenter

5. 配置参数与环境变量

6. 问题反馈与支持

• 获取帮助：DataStax Docker 文档、DataStax Slack、GitHub 仓库
• 提交问题：GitHub Issues
• 进阶教程：DataStax Academy（推荐教程：DataStax Enterprise 6 导览）

7. 许可信息

• 镜像仅授权用于非生产环境的开发用途。
• 详细许可条款参见：
  • OpsCenter 许可条款
  • DataStax 许可条款

8. 维护者

由 DataStax ***维护。