combor/k8s-mongo-labeler-sidecar

Kubernetes MongoDB 副本集 Pod 标签器

镜像概述和主要用途

该镜像作为sidecar容器，用于解决在Kubernetes上以StatefulSet运行MongoDB副本集时，外部服务（如Load***）随机选择pod导致连接到只读从节点的问题。通过自动检测MongoDB副本集中的主节点，并为主节点pod添加primary=true标签，使外部服务可通过选择器定向连接主节点，确保读写操作正常执行。

核心功能和特性

• 自动主节点检测：实时监控MongoDB副本集，识别当前主节点
• 动态标签管理：为主节点pod添加primary=true标签，非主节点自动移除该标签
• Kubernetes集成：运行在集群内时自动检测Kubernetes配置，无需额外设置
• 灵活配置：通过环境变量自定义标签选择器、命名空间和日志详细程度

使用场景和适用范围

适用于以下场景：

• 在Kubernetes集群中以StatefulSet部署MongoDB副本集
• 需要通过外部服务（如Load***）暴露MongoDB，且需确保连接到可读写的主节点
• 解决因随机选择pod导致连接到只读从节点的问题

使用方法和配置说明

服务定义示例

创建外部服务时，使用primary=true标签作为选择器，确保仅定向到主节点：

yaml
apiVersion: v1
kind: Service
metadata:
  name: mongo-external
  labels:
    name: mongo
spec:
  type: LoadBalancer
  ports:
  - name: mongo
    port: 27017
  selector:
    role: mongo  # 匹配MongoDB pod的基础标签
    primary: "true"  # 匹配sidecar标记的主节点

环境变量配置

通过环境变量自定义sidecar行为：

环境变量配置示例

在StatefulSet的容器定义中添加环境变量：

yaml
env:
  - name: LABEL_SELECTOR
    value: "role=mongo,environment=dev"  # 匹配角色为mongo且环境为dev的pod
  - name: NAMESPACE
    value: "dev"  # 仅在dev命名空间中搜索
  - name: DEBUG
    value: "true"  # 启用详细日志

测试方法

若需在集群外测试，需：

1. 确保Kubernetes配置文件位于~/.kube/config
2. 使用kubectl port-forward将MongoDB pod端口转发到本地：

   bash
   kubectl port-forward mongo-0 27017  # 将mongo-0 pod的27017端口转发到本地
   

3. 此时sidecar将默认连接到localhost:27017进行测试

StatefulSet部署示例

以下是包含sidecar的MongoDB StatefulSet简化配置：

yaml
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: mongo
spec:
  serviceName: mongo
  replicas: 3
  selector:
    matchLabels:
      role: mongo
  template:
    metadata:
      labels:
        role: mongo
    spec:
      containers:
      - name: mongo
        image: mongo
        args: ["--replSet", "rs0", "--bind_ip_all"]
        ports:
        - containerPort: 27017
      - name: mongo-labeler  # sidecar容器
        image: [镜像名称]  # 替换为实际的sidecar镜像名称
        env:
        - name: LABEL_SELECTOR
          value: "role=mongo"
        - name: NAMESPACE
          valueFrom:
            fieldRef:
              fieldPath: metadata.namespace
        - name: DEBUG
          value: "false"

注意：需将配置中的[镜像名称]替换为实际使用的sidecar镜像名称。