dyrnq/livenessprobe

概述

registry.k8s.io/sig-storage/livenessprobe是由Kubernetes SIG Storage（存储特别兴趣小组）维护的官方存活探针工具镜像。该镜像包含轻量级可执行程序，用于实现Kubernetes容器的存活探测逻辑，遵循Kubernetes探针规范，可与kubelet协同工作以监控容器健康状态。

功能特性

• 多探测方式支持：兼容HTTP GET、TCP套接字、命令执行等多种Kubernetes探针类型。
• 轻量级设计：镜像体积小，资源占用低，适合在资源受限环境中运行。
• 集群兼容：与Kubernetes节点组件（kubelet）无缝集成，支持各版本Kubernetes集群。
• OCI标准：符合开放容器倡议（OCI）规范，可在任何兼容OCI的容器运行时中使用。

使用场景

主要用于Kubernetes集群中Pod的存活探针（Liveness Probe）配置，特别是以下场景：

• 容器内应用未暴露HTTP/TCP健康检查端点，需通过自定义命令执行探测逻辑。
• 需要在探针中实现复杂的状态判断逻辑（如文件存在性检查、日志关键字匹配等）。
• 作为基础工具集成到自定义探针解决方案中，扩展容器健康检查能力。

部署示例

以下是在Kubernetes Pod中使用该镜像作为存活探针执行器的示例YAML配置：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: livenessprobe-demo
spec:
  containers:
  - name: demo-container
    image: nginx:alpine
    livenessProbe:
      exec:
        command: ["/livenessprobe", "--check-command", "curl -f http://localhost:80/health || exit 1"]
      initialDelaySeconds: 10  # 容器启动后延迟10秒开始探测
      periodSeconds: 5         # 每5秒执行一次探测
      timeoutSeconds: 2        # 探测超时时间2秒
      failureThreshold: 3      # 连续3次失败则重启容器
    resources:
      limits:
        cpu: "100m"
        memory: "64Mi"
      requests:
        cpu: "50m"
        memory: "32Mi"

说明：示例中通过exec方式调用/livenessprobe工具执行自定义探测命令（检查Nginx的健康端点），当命令返回非0 exit code时，Kubelet判定容器存活探测失败并触发重启。

注意事项

• 版本兼容性：建议使用与Kubernetes集群版本匹配的镜像标签（如v1.28.0对应Kubernetes 1.28版本），避免因API差异导致探测失败。
• 资源配置：根据探测命令复杂度调整CPU/内存资源请求，避免因资源不足导致探测延迟。
• 探测参数：合理设置initialDelaySeconds（确保应用启动完成）、timeoutSeconds（避免过长阻塞）等参数，防止误判。
• 安全限制：运行时可限制容器的securityContext（如非root用户运行），降低安全风险。