Kubernetes就绪探针失败求助：GitHub流水线部署验证偶发失败

我使用Kubernetes搭配Helm进行部署，GitHub流水线包含以下验证步骤：

- name: Verify deployment
    run: kubectl rollout status deployment/name-api --namespace my-prod --timeout=60s

该步骤有时会失败，报错信息如下：

Readiness probe failed: Get "https://***:80/": dial tcp ***:80: connect: connection refused

重新运行Action后通常能够成功。我已在templates文件夹的deployment.yaml中添加了就绪探针的初始延迟配置，但并未解决问题：

spec:
  template:
    spec:
      containers:
        - name: {{ .Chart.Name }}
          …
          readinessProbe:
            initialDelaySeconds: 5

实用优化方案 #

• 完善就绪探针参数配置
  仅设置initialDelaySeconds: 5不足以覆盖服务启动的全部初始化时间（比如加载配置、建立外部依赖连接等）。建议补充更多参数，给服务足够的缓冲和容错空间：

  readinessProbe:
    initialDelaySeconds: 15  # 延长初始等待时间，根据服务实际启动时长调整
    periodSeconds: 5         # 每隔5秒执行一次探测
    failureThreshold: 6      # 连续6次失败才判定容器未就绪
    successThreshold: 2      # 连续2次成功才判定容器就绪
  

• 延长部署验证的超时时间
  当前kubectl rollout status的60秒超时可能不足以等待服务完成启动。可以适当延长超时时间，比如：

  kubectl rollout status deployment/name-api --namespace my-prod --timeout=120s
  

• 优化就绪探针的探测目标
  确保探针访问的路径（比如示例中的/）是服务真正就绪的标识。如果服务启动后需要先完成依赖加载，根路径可能无法及时响应，建议改用专门的健康检查接口（如/healthz），该接口仅在服务完全初始化完成后返回成功状态。

• 给流水线步骤添加自动重试
  在GitHub Action的验证步骤中配置重试逻辑，无需手动触发即可自动重试失败的任务：

  - name: Verify deployment
    run: kubectl rollout status deployment/name-api --namespace my-prod --timeout=120s
    retries: 2
    retry-delay-seconds: 30
  

内容的提问来源于stack exchange，提问作者Marty