GCP部署中修改ejabberd节点名后服务及ejabberdctl异常

问题根源排查 #

1. Erlang节点名解析失败 #

Erlang节点名格式为节点名@主机名，你设置的ejabberd@main中的main是Deployment名称，容器内部无法通过DNS解析该名称，导致Erlang节点启动后无法正常完成网络注册，出现start提示节点已运行但status显示下线的矛盾状态。

• 验证方式：进入容器执行ping main，若无法解析则确认是该问题。

2. ejabberdctl默认节点名不匹配 #

ejabberdctl默认连接的节点名与你通过ERLANG_NODE_ARG设置的节点名不一致时，会出现：实际节点已启动（start命令提示已运行），但ejabberdctl找不到目标节点（status显示下线）。

• 验证方式：执行ejabberdctl --node ejabberd@main status，若能正常返回节点状态，则确认是该问题。

3. Erlang分布式通讯端口未配置 #

Erlang节点依赖4369端口（epmd服务）完成节点发现，若该端口未开放或容器内epmd未正常运行，会导致节点无法被识别。

• 验证方式：进入容器执行epmd -names，若看不到ejabberd节点的注册信息，则确认是该问题。

GCP Kubernetes ejabberd集群部署指导 #

1. 正确配置Erlang节点名 #

使用Kubernetes内部可解析的主机名设置节点名，推荐两种方式：

• 利用Downward API注入Pod的主机名或IP：

  env:
    - name: ERLANG_NODE_ARG
      valueFrom:
        fieldRef:
          fieldPath: spec.hostname
  

• 若使用StatefulSet，可利用Headless Service的DNS名称：

  env:
    - name: ERLANG_NODE_ARG
      value: "ejabberd@$(hostname).ejabberd-headless.default.svc.cluster.local"
  

2. 统一配置Erlang Cookie #

集群内所有节点必须使用相同的Erlang Cookie，这是节点间通讯的认证密钥，建议通过Secret管理：

• 先创建Secret：

  kubectl create secret generic ejabberd-secrets --from-literal=erlang-cookie=your-secure-cookie
  

• 在Deployment/StatefulSet中引用：

  env:
    - name: ERLANG_COOKIE
      valueFrom:
        secretKeyRef:
          name: ejabberd-secrets
          key: erlang-cookie
  

3. 暴露分布式通讯所需端口 #

除业务端口外，必须暴露epmd端口及Erlang动态通讯端口：

ports:
  - containerPort: 4369
    name: epmd
  - containerPort: 5222
    name: xmpp-client
  - containerPort: 5269
    name: xmpp-server
  - containerPort: 5280
    name: http-api
  - containerPort: 5443
    name: https-api
  - containerPort: 4370
    name: erlang-dist-start
    protocol: TCP
  - containerPort: 4390
    name: erlang-dist-end
    protocol: TCP

4. 优先使用StatefulSet部署集群 #

StatefulSet提供稳定的网络标识和持久化存储，更适合ejabberd集群场景：

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: ejabberd
spec:
  serviceName: ejabberd-headless
  replicas: 2
  selector:
    matchLabels:
      app: ejabberd
  template:
    metadata:
      labels:
        app: ejabberd
    spec:
      containers:
        - name: ejabberd
          image: ejabberd/ecs
          env:
            - name: ERLANG_NODE_ARG
              value: "ejabberd@$(hostname).ejabberd-headless.default.svc.cluster.local"
            - name: ERLANG_COOKIE
              valueFrom:
                secretKeyRef:
                  name: ejabberd-secrets
                  key: erlang-cookie
          ports:
            - containerPort: 4369
              name: epmd
            - containerPort: 5222
              name: xmpp-client
            - containerPort: 5269
              name: xmpp-server
            - containerPort: 5280
              name: http-api
            - containerPort: 5443
              name: https-api
          volumeMounts:
            - name: ejabberd-data
              mountPath: /home/ejabberd/.ejabberd
  volumeClaimTemplates:
    - metadata:
        name: ejabberd-data
      spec:
        accessModes: [ "ReadWriteOnce" ]
        resources:
          requests:
            storage: 1Gi

配套创建Headless Service用于DNS解析：

apiVersion: v1
kind: Service
metadata:
  name: ejabberd-headless
spec:
  clusterIP: None
  selector:
    app: ejabberd
  ports:
    - name: epmd
      port: 4369
    - name: xmpp-client
      port: 5222
    - name: xmpp-server
      port: 5269
    - name: http-api
      port: 5280

5. 验证集群状态 #

进入任意Pod执行以下命令，确认节点已加入集群：

ejabberdctl --node ejabberd@ejabberd-0.ejabberd-headless.default.svc.cluster.local cluster_status

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