如何在部署CnosDB集群时使用K8s DNS名称及最佳实践

一、替换IP为DNS名称的具体操作 #

1. 修改CnosDB集群配置 #

把原配置里的固定IP替换成K8s内部稳定的DNS名称，示例如下：
原IP形式配置：

cluster:
  peers:
    - "10.0.0.1:8901"
    - "10.0.0.2:8901"

修改为DNS形式：

cluster:
  peers:
    - "cnosdb-node-0.cnosdb-headless:8901"
    - "cnosdb-node-1.cnosdb-headless:8901"

这里cnosdb-headless是对应StatefulSet的无头服务名，cnosdb-node-<序号>是StatefulSet Pod的固定域名，K8s会自动维护这些DNS记录的可用性。

2. 配置无头服务 #

如果还没创建无头服务，得定义一个，确保Pod能被稳定的DNS访问：

apiVersion: v1
kind: Service
metadata:
  name: cnosdb-headless
spec:
  clusterIP: None
  selector:
    app: cnosdb
  ports:
    - name: rpc
      port: 8901
      targetPort: 8901

无头服务不会分配ClusterIP，直接返回Pod的DNS记录，完美适配有状态集群的节点间通信需求。

3. 调整StatefulSet启动参数 #

在StatefulSet的Pod模板里，把启动命令中的IP参数换成DNS名称，比如：

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: cnosdb-node
spec:
  serviceName: "cnosdb-headless"
  replicas: 3
  template:
    spec:
      containers:
      - name: cnosdb
        image: cnosdb/cnosdb:latest
        args:
          - "run"
          - "--cluster.peers=cnosdb-node-0.cnosdb-headless:8901,cnosdb-node-1.cnosdb-headless:8901,cnosdb-node-2.cnosdb-headless:8901"

二、K8s部署CnosDB的最佳实践 #

• 用StatefulSet部署：CnosDB是有状态数据库，StatefulSet能保证Pod的固定网络标识和持久化存储，适配集群节点的稳定性要求。
• 挂载持久化卷：给每个Pod配置独立的PVC，避免数据丢失，推荐用K8s存储类动态分配存储。
• 设置资源限制：根据集群规模配置CPU、内存的requests和limits，防止CnosDB占用过多资源影响其他服务：

resources:
  requests:
    cpu: "1"
    memory: "2Gi"
  limits:
    cpu: "2"
    memory: "4Gi"

• 启用探针检测：配置存活探针和就绪探针，及时发现异常Pod并重启，保障集群可用性：

livenessProbe:
  httpGet:
    path: /health
    port: 8902
  initialDelaySeconds: 30
  periodSeconds: 10
readinessProbe:
  tcpSocket:
    port: 8901
  initialDelaySeconds: 15
  periodSeconds: 5

• 合理配置服务暴露：外部访问用NodePort、LoadBalancer或Ingress，内部访问优先用无头服务或ClusterIP服务，别直接暴露Pod。
• 定期备份数据：结合K8s快照功能或CnosDB自身备份命令，定期备份集群数据，确保数据可恢复。
• 监控与日志集成：用Prometheus+Grafana监控运行状态，用Loki或ELK收集日志，方便排查问题。

内容的提问来源于stack exchange，提问作者xufei Alex