yiorgos/liveness

Kubernetes存活探针测试容器

镜像概述

本镜像为一个轻量级容器，专为Kubernetes存活探针（liveness probe）测试设计。其核心功能是模拟服务不稳定状态，随机返回HTTP状态码：30%的请求返回500（服务错误），70%的请求返回200（正常）。可用于替代默认的k8s.gcr.io/liveness镜像（该镜像仅在启动10秒后固定返回500），更贴近真实环境中服务的随机故障场景。

核心功能与特性

• 轻量级设计：容器体积小，资源占用低，适合在Kubernetes集群中快速部署和测试
• 随机状态码响应：访问/healthz端点时，30%概率返回HTTP 500，70%概率返回HTTP 200
• 存活探针兼容性：完全符合Kubernetes存活探针的HTTP检测标准，可直接配置使用

使用场景与适用范围

• Kubernetes存活探针配置验证：测试存活探针的阈值设置（如failureThreshold、periodSeconds）是否合理
• 故障自愈机制测试：模拟服务间歇性故障，验证Kubernetes对异常Pod的重启或替换能力
• 服务稳定性测试：在CI/CD流程中集成，验证集群在服务不稳定状态下的整体可靠性

使用方法与配置说明

基本使用（Docker运行）

bash
# 启动容器，映射容器8080端口到主机8080端口
docker run -d -p 8080:8080 <镜像名称>

# 测试端点（多次执行可观察随机状态码）
curl http://localhost:8080/healthz

Kubernetes部署示例

1. Pod配置

yaml
apiVersion: v1
kind: Pod
metadata:
  name: liveness-test-pod
spec:
  containers:
  - name: liveness-test-container
    image: <镜像名称>
    ports:
    - containerPort: 8080
    livenessProbe:
      httpGet:
        path: /healthz
        port: 8080
      initialDelaySeconds: 5  # 容器启动后延迟5秒开始探测
      periodSeconds: 5       # 每5秒探测一次
      failureThreshold: 3    # 连续3次失败后标记为不健康

2. 部署与观察

bash
# 创建Pod
kubectl apply -f liveness-test-pod.yaml

# 观察Pod状态（由于30%概率失败，Pod可能会被重启）
kubectl get pods -w

端点说明

• 访问路径：/healthz
• 响应行为：
  • 70%概率返回HTTP 200（状态文本：OK）
  • 30%概率返回HTTP 500（状态文本：Internal Server Error）
• 无需额外配置：镜像启动后无需任何环境变量或配置文件，直接提供随机状态码响应

注意事项

• 本镜像仅用于测试目的，不可用于生产环境
• 若需调整500状态码的概率，需基于原镜像源码修改后重新构建
• 确保Kubernetes集群网络策略允许Pod内部访问容器的8080端口