Kubernetes上MinIO分布式集群部署DNS解析错误求助

核心问题分析 #

你遇到的DNS解析错误，本质是MinIO Pod无法通过Kubernetes StatefulSet的Headless Service DNS机制找到集群内的其他节点。Kubernetes中StatefulSet的Pod会通过pod-name.service-name.namespace.svc.cluster.local格式的DNS记录互相访问，这个机制依赖Headless Service的正确配置和StatefulSet的关联。

分步排查与修复 #

1. 验证Headless Service配置 #

Headless Service必须满足以下要求：

• clusterIP: None（关键标识，确保Kubernetes为每个Pod分配独立DNS记录）
• selector与StatefulSet Pod的标签完全匹配
• 命名空间与StatefulSet一致

正确的Headless Service示例：

apiVersion: v1
kind: Service
metadata:
  name: minio
  namespace: minio
spec:
  clusterIP: None
  selector:
    app: minio # 必须和StatefulSet Pod模板的labels一致
  ports:
    - name: http
      port: 9000
      targetPort: 9000

2. 检查StatefulSet与Service的关联 #

StatefulSet的spec.serviceName必须严格等于Headless Service的名称，否则Kubernetes不会生成对应的DNS记录：

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: minio
  namespace: minio
spec:
  serviceName: "minio" # 与Headless Service的name完全一致
  replicas: 4
  selector:
    matchLabels:
      app: minio
  template:
    metadata:
      labels:
        app: minio # 与Service的selector匹配
    spec:
      containers:
        - name: minio
          image: minio/minio:latest
          args:
            - server
            - http://minio-{0...3}.minio.minio.svc.cluster.local:9000/data # 注意DNS格式中的命名空间

3. 确认MinIO启动参数的端点格式 #

启动命令中的节点地址必须遵循http://minio-{0...3}.minio.<namespace>.svc.cluster.local:9000/data格式：

• minio-{0...3}：StatefulSet的Pod序号范围
• minio：Headless Service的名称
• minio：部署所在的命名空间（如果命名空间不是minio，替换为实际值）

4. 测试DNS连通性 #

在任意MinIO Pod中执行DNS查询，验证记录是否存在：

kubectl exec -it minio-0 -n minio -- nslookup minio-1.minio.minio.svc.cluster.local

如果解析失败，检查集群DNS组件状态：

# 查看CoreDNS Pod状态
kubectl get pods -n kube-system | grep coredns

# 查看CoreDNS日志排查问题
kubectl logs -n kube-system <coredns-pod-name>

5. 排除其他干扰因素 #

• 确保所有MinIO Pod处于Running状态，DNS记录仅在Pod Ready时注册
• 检查命名空间是否存在NetworkPolicy规则，阻止了DNS（53端口）流量
• 重启Minikube的DNS组件（如果是MinIO环境特定问题）：

  minikube addons disable coredns
  minikube addons enable coredns
  

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