如何从Kubernetes集群应用访问DSE集群？及Cassandra解析故障排查

一、Cassandra连接报错（UnknownHostException）排查 #

报错UnknownHostException: cassandra: Temporary failure in name resolution明确是主机名解析失败，按以下步骤排查：

• 测试容器内DNS解析
  在运行的应用容器中执行nslookup cassandra或dig cassandra，确认cassandra主机名能否被解析到对应IP。如果解析失败，说明Kubernetes集群的DNS服务无法识别该域名。
• 替换主机名为IP测试
  临时将应用连接串中的cassandra替换为Cassandra服务器的内网/公网IP，重新启动容器。如果能正常连接，问题根源就是域名解析，需要确保该主机名能被K8s集群的DNS服务器解析，或直接使用IP配置。
• 检查网络连通性
  在容器内执行nc -zv <cassandra-ip> 9042，验证9042端口是否可达。如果不通，检查Cassandra服务器的防火墙、安全组，确保K8s集群的出口IP被允许访问该端口。
• 核对应用连接配置
  检查应用的Cassandra连接参数，确认主机名/IP、端口拼写正确，没有额外的配置错误（比如误写为cassandra:9043）。

二、Kubernetes集群应用访问外部DSE集群的配置建议 #

DSE基于Cassandra，访问时除基础网络配置外，需注意DSE专属特性：

• 网络端口开放
  确保K8s集群能访问DSE集群所有节点的以下端口：
  • 9042：CQL连接端口
  • 7000：Gossip节点通信端口
  • 若使用DSE搜索、Analytics等组件，需额外开放对应端口（如8983搜索端口）
    同时配置DSE节点的rpc_address和broadcast_rpc_address为K8s集群可访问的IP/域名，避免应用获取到内部不可达地址。
• 连接串配置
  • 建议指定多个DSE节点地址（如dse-node-1:9042,dse-node-2:9042），提升连接可用性，避免单点依赖。
  • 确保应用使用的DSE驱动版本与DSE集群版本兼容，避免兼容性问题。
• 安全配置（若启用）
  • 若DSE开启密码认证，在应用连接配置中添加用户名、密码参数；若使用Kerberos认证，需配置对应的票据获取逻辑。
  • 若启用SSL加密，在应用中加载DSE集群的CA证书，开启SSL连接配置。
• Kubernetes内部映射优化
  若DSE与K8s集群在同一内网，可通过K8s的Endpoint和Service统一映射DSE节点，简化应用配置：

  apiVersion: v1
  kind: Endpoints
  metadata:
    name: dse-cluster
  subsets:
  - addresses:
    - ip: <dse-node-1-ip>
    - ip: <dse-node-2-ip>
    ports:
    - port: 9042
      name: cql
  ---
  apiVersion: v1
  kind: Service
  metadata:
    name: dse-cluster
  spec:
    ports:
    - port: 9042
      name: cql
  

  应用可直接使用dse-cluster:9042作为连接地址。

内容的提问来源于stack exchange，提问作者Andrej Flieger