cycoresystems/dispatchers

Dispatchers 镜像文档

概述

Dispatchers镜像是一个专为Kubernetes环境设计的工具，主要功能是为Kamailio SIP服务器维护dispatchers.list配置文件。该文件包含Kamailio用于负载均衡和故障转移的调度器列表，镜像通过监听Kubernetes集群内的相关资源变化，实现dispatchers.list文件的自动生成与动态更新，确保Kamailio配置与集群状态保持同步。

核心功能与特性

• 动态配置管理：实时监控Kubernetes集群中的相关服务或端点变化，自动更新dispatchers.list文件。
• Kamailio集成：生成符合Kamailio格式要求的调度器列表，直接供Kamailio加载使用。
• Kubernetes原生支持：适配Kubernetes的服务发现机制，无需手动配置调度器节点信息。
• 轻量级设计：镜像体积小，资源占用低，适合在容器化环境中部署。

使用场景与适用范围

• Kubernetes环境中的Kamailio部署：当Kamailio运行在Kubernetes集群内，且需要动态管理后端媒体服务器或SIP代理节点时。
• SIP负载均衡场景：需通过Kamailio实现对多个SIP后端节点的负载均衡和故障转移，且后端节点可能动态扩缩容的场景。
• 云原生通信系统：在基于Kubernetes构建的云原生通信平台中，作为Kamailio的配置管理组件使用。

使用方法与配置说明

部署前提

• 已部署Kubernetes集群（版本1.19+）。
• Kamailio实例已在集群中运行，且配置为从指定路径加载dispatchers.list文件。

环境变量配置

Docker run 示例

bash
docker run -d \
  --name dispatchers \
  -e KUBERNETES_NAMESPACE=sip-service \
  -e SERVICE_NAME=sip-backend \
  -v /path/to/kamailio/config:/etc/kamailio \
  --restart always \
  dispatchers:latest

Kubernetes部署示例（Deployment）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: dispatchers
  namespace: sip-service
spec:
  replicas: 1
  selector:
    matchLabels:
      app: dispatchers
  template:
    metadata:
      labels:
        app: dispatchers
    spec:
      containers:
      - name: dispatchers
        image: dispatchers:latest
        env:
        - name: KUBERNETES_NAMESPACE
          value: "sip-service"
        - name: SERVICE_NAME
          value: "sip-backend"
        - name: REFRESH_INTERVAL
          value: "30"
        volumeMounts:
        - name: kamailio-config
          mountPath: /etc/kamailio
      volumes:
      - name: kamailio-config
        persistentVolumeClaim:
          claimName: kamailio-config-pvc

生成的dispatchers.list格式示例

# Auto-generated by dispatchers (2023-10-01T12:00:00Z)
dispatcher 1 sip:10.244.1.5:5060 0
dispatcher 1 sip:10.244.2.8:5060 0

注意事项

• 确保容器具有足够的Kubernetes API访问权限（建议通过Service Account配置适当的RBAC权限）。
• Kamailio需配置为定期重新加载dispatchers.list文件（可通过reload命令或配置自动加载机制实现）。
• 当后端服务的端口或协议发生变化时，需通过环境变量或配置文件调整生成规则。