emrekenci/k8s-healthcheck

emrekenci/k8s-healthcheck 镜像说明

镜像概述

emrekenci/k8s-healthcheck是针对Kubernetes集群的健康检查工具，部署到集群内部后，可实时采集并返回Master组件与节点的运行状态，帮助运维人员快速掌握集群健康情况。

核心功能

• 获取Kubernetes Master组件（如kube-apiserver、kube-controller-manager）的状态
• 查看集群所有节点的就绪状态及基础运行信息

使用场景

• 集群日常运维监控
• 故障排查时快速确认Master组件与节点健康状态
• 自动化监控系统集成，触发集群异常告警

配置说明

1. 部署需绑定具有集群访问权限的ServiceAccount（需包含节点、Master组件的读取权限）
2. 应用默认暴露HTTP接口，通过访问接口即可获取状态数据

部署示例

1. 权限配置（rbac-config.yaml）

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

2. 部署应用（deployment.yaml）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: k8s-healthcheck
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: k8s-healthcheck
  template:
    metadata:
      labels:
        app: k8s-healthcheck
    spec:
      serviceAccountName: k8s-healthcheck-sa
      containers:
      - name: k8s-healthcheck
        image: emrekenci/k8s-healthcheck
        ports:
        - containerPort: 8080

3. 应用部署命令

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

4. 访问状态接口

bash
# 端口转发到本地
kubectl port-forward deployment/k8s-healthcheck 8080:8080
# 访问接口获取状态
curl http://localhost:8080/status