Kubernetes部署Artemis高可用集群遇UnknownHostException问题

根据你描述的场景——在K8s 1.8中用StatefulSet部署2节点Artemis/JMS集群，配置了静态连接器但出现跨节点的UnknownHostException，这个问题大概率和StatefulSet依赖的Headless Service配置或K8s内部DNS解析有关，以下是具体排查和解决步骤：

1. 确认Headless Service是否正确配置 #

StatefulSet的稳定Pod DNS记录完全依赖Headless Service（clusterIP: None），如果缺少或配置错误，Pod之间无法通过固定域名解析彼此。

你需要确保存在这样的Headless Service，示例YAML如下：

apiVersion: v1
kind: Service
metadata:
  name: jms-service
  namespace: default
spec:
  clusterIP: None  # 必须设置为None，标识这是Headless Service
  ports:
    - port: 61616
      name: jms
  selector:
    app: artemis-jms  # 必须和StatefulSet Pod的标签匹配

2. 检查StatefulSet的serviceName字段 #

在你的StatefulSet配置中，必须指定serviceName字段，且值要和上述Headless Service的名称完全一致，这样K8s才会为Pod生成正确的DNS记录：

apiVersion: apps/v1beta1
kind: StatefulSet
metadata:
  name: jms-service
  namespace: default
spec:
  serviceName: "jms-service"  # 与Headless Service名称严格匹配
  replicas: 2
  template:
    metadata:
      labels:
        app: artemis-jms  # 与Service的selector匹配
    # 其余容器、存储配置...

3. 验证Pod内的DNS解析能力 #

进入任意一个Artemis Pod，手动测试对另一个节点域名的解析，定位是否是DNS层面的问题：

# 进入jms-service-0 Pod
kubectl exec -it jms-service-0 -- /bin/bash

# 测试解析jms-service-1的域名
nslookup jms-service-1.jms-service.default.svc.cluster.local

如果解析失败：

• 检查kube-system命名空间下的DNS组件（kube-dns或coredns）Pod是否正常运行：kubectl get pods -n kube-system
• 查看Pod的/etc/resolv.conf文件，确认是否配置了K8s集群DNS（通常是类似nameserver 10.96.0.10的地址）

4. 排查网络连通性 #

如果DNS解析正常但仍无法连接，检查Pod之间的网络是否连通：

# 在jms-service-0中ping jms-service-1的IP（从nslookup结果获取）
ping <jms-service-1-ip>

如果ping不通，说明K8s网络插件（如Flannel、Calico）可能存在问题，需要检查插件的部署状态和日志。

5. 可选：动态生成Artemis连接器配置 #

静态配置连接器虽然能满足当前2节点的需求，但如果后续集群扩容，需要手动修改配置。可以在Artemis启动脚本中通过K8s API查询Headless Service的Endpoints，动态生成broker.xml的connectors部分，示例逻辑（伪代码）：

# 获取Headless Service的所有Endpoints节点
ENDPOINTS=$(kubectl get endpoints jms-service -o jsonpath='{.subsets[0].addresses[*].ip}')
# 遍历IP生成connector配置
for IP in $ENDPOINTS; do
  ORDINAL=$(echo $IP | awk -F '.' '{print $4}')  # 假设IP最后一段对应Pod序号
  echo "<connector name=\"jms-service-$ORDINAL\">tcp://jms-service-$ORDINAL.jms-service.default.svc.cluster.local:61616</connector>" >> connectors.tmp
done
# 将生成的connectors合并到broker.xml
sed -i '/<connectors>/r connectors.tmp' broker.xml

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