argoproj/sensor-controller

传感器Kubernetes资源控制器镜像

镜像概述

本镜像为Kubernetes集群中的传感器资源控制器，主要用于管理传感器相关Kubernetes资源的全生命周期，包括资源创建、更新、删除及状态协调，确保集群中传感器资源的实际状态与期望状态一致，适用于需要在K8s环境中统一管理传感器资源的场景。

核心功能与特性

• 资源生命周期管理：支持传感器相关Kubernetes资源（如Deployment、ConfigMap、Secret等）的创建、更新与删除操作
• 状态监控与协调：持续监控传感器资源状态，自动触发协调逻辑以修复状态偏差，保障资源稳定性
• Kubernetes原生集成：通过Kubernetes API Server实现资源交互，遵循Kubernetes控制器模式（Controller Pattern）
• 可配置化：支持通过环境变量或配置文件自定义资源监控间隔、重试策略等核心参数

使用场景与适用范围

• 物联网（IoT）平台：在K8s集群中管理大规模物联网传感器节点资源，适配动态传感器部署需求
• 工业监控系统：协调工业环境中传感器采集单元的资源分配与状态监控，保障数据采集连续性
• 边缘计算场景：在边缘Kubernetes集群中管理分布式传感器资源，适配边缘节点动态扩缩容
• 智能设备管理：适用于需要通过K8s标准化管理传感器设备接入、配置与维护的场景

使用方法与配置说明

基本部署（Docker Run）

通过以下命令在K8s集群节点或具备K8s API访问权限的环境中运行控制器：

bash
docker run -d \
  --name sensor-k8s-controller \
  -e KUBERNETES_API_URL="https://kube-apiserver:6443" \
  -e KUBERNETES_TOKEN="your-k8s-token" \
  -e WATCH_NAMESPACE="sensor-namespace" \
  -e SYNC_INTERVAL="30s" \
  docker.xuanyuan.run/sensor-k8s-controller:latest

环境变量配置

配置参数说明

控制器支持通过挂载配置文件（如/config/controller.yaml）进行高级配置，配置文件示例：

yaml
apiVersion: controller.config/v1alpha1
kind: SensorControllerConfig
syncInterval: 30s
reconcileRetryLimit: 5
resourceTypes:  # 指定需要管理的传感器资源类型
  - deployment
  - configmap
  - secret
watchLabels:  # 仅监控包含指定标签的资源
  sensor: "true"

与Kubernetes集成建议

1. 建议通过Kubernetes Deployment部署控制器，确保高可用性：

   yaml
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: sensor-controller
     namespace: kube-system
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: sensor-controller
     template:
       metadata:
         labels:
           app: sensor-controller
       spec:
         containers:
         - name: controller
           image: docker.xuanyuan.run/sensor-k8s-controller:latest
           env:
           - name: KUBERNETES_TOKEN
             valueFrom:
               secretKeyRef:
                 name: controller-token
                 key: token
           - name: WATCH_NAMESPACE
             value: "sensor-ns"
   

2. 为控制器配置RBAC权限，确保具备传感器资源的管理权限：

   yaml
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: sensor-controller-role
   rules:
   - apiGroups: ["apps", ""]
     resources: ["deployments", "configmaps", "secrets"]
     verbs: ["get", "list", "watch", "create", "update", "patch", "delete"]