topiaruss/kogaro

Kogaro镜像说明

镜像概述

Kogaro是运行在Kubernetes集群中的代理程序，专注于持续检测集群内资源间的引用关系是否有效，以及配置是否存在潜在问题，帮助用户及时发现并解决配置层面的风险，提升集群运维效率。

核心功能

• 资源引用验证：自动检查Deployment、StatefulSet等资源是否引用了不存在的ConfigMap、Secret或Service。
• 配置问题检测：识别资源限制不合理、标签缺失、权限配置不当等常见配置隐患。
• 实时反馈：持续监控并输出问题结果，支持集成到现有监控系统（如Prometheus）。
• 规则可扩展：允许用户自定义验证规则，适配特定业务场景需求。

使用场景

1. 日常运维：作为集群健康监控的一部分，自动发现配置错误。
2. CI/CD流程：部署前验证配置文件的合法性，避免错误配置进入生产环境。
3. 集群迁移：检测迁移过程中资源引用的一致性问题。

配置说明

• 环境变量：
  • VALIDATION_INTERVAL：验证间隔时间（秒，默认300）。
  • IGNORE_RESOURCES：忽略验证的资源类型（逗号分隔，如"Namespace,ServiceAccount"）。
• RBAC权限：需赋予集群级别的get、list、watch权限以访问所有资源。

部署示例

1. 创建ServiceAccount与RBAC权限

yaml
apiVersion: v1
kind: ServiceAccount
metadata:
  name: kogaro-sa
  namespace: default
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: kogaro-role
rules:
- apiGroups: ["*"]
  resources: ["*"]
  verbs: ["get", "list", "watch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: kogaro-binding
subjects:
- kind: ServiceAccount
  name: kogaro-sa
  namespace: default
roleRef:
  kind: ClusterRole
  name: kogaro-role
  apiGroup: rbac.authorization.k8s.io

2. 部署Kogaro代理

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: kogaro
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: kogaro
  template:
    metadata:
      labels:
        app: kogaro
    spec:
      serviceAccountName: kogaro-sa
      containers:
      - name: kogaro
        image: docker.xuanyuan.run/topiaruss/kogaro
        env:
        - name: VALIDATION_INTERVAL
          value: "300"
        - name: IGNORE_RESOURCES
          value: "Namespace,ServiceAccount"

执行部署命令：

bash
kubectl apply -f kogaro-rbac.yaml
kubectl apply -f kogaro-deployment.yaml

查看日志验证运行状态：

bash
kubectl logs -f deployment/kogaro