lumioid/waitfor

waitfor

waitfor是一个轻量工具，可作为Kubernetes的initContainer，用于等待特定条件满足后再启动主容器，确保服务依赖的正确性。

镜像概述

waitfor旨在解决Kubernetes集群中常见的服务依赖问题，例如间歇性DNS解析错误或服务启动顺序不当导致的故障。通过在主容器启动前检查预设条件，保证应用稳定运行。

核心功能

1. 环境变量检查：验证指定环境变量是否存在，若缺失则退出（可配置等待间隔）。
2. 未来计划支持：
   • 检查环境变量值对应的主机可达性（--envHost模式）
   • 检查服务是否就绪（--service模式）

使用场景

• 解决Kube-DNS间歇性解析失败问题。
• 确保服务依赖按正确顺序启动（如更新或重启Kube控制平面时）。
• 验证必要环境变量是否已正确注入Pod。

配置说明

通过命令行参数配置检查规则：

• --env：指定需检查的环境变量列表（逗号分隔）。
• --sleep：设置检查失败后的等待间隔（如1s、5m）。

部署示例

命令行使用

bash
# 检查多个环境变量是否存在，缺失则退出
waitfor --env=ENVA,ENVB,ENVC,ENV_D

# 检查环境变量并设置等待间隔为1秒
waitfor --env=ENVA,ENVB --sleep=1s

Kubernetes Pod配置

yaml
apiVersion: v1
kind: Pod
metadata:
  name: myapp-pod
  labels:
    app: myapp
spec:
  containers:
    - name: myapp-container
      image: busybox:1.28
      command: ['sh', '-c', 'echo The app is running! && sleep 3600']
  initContainers:
    - name: init-env-check
      image: lumioid/waitfor
      command: ["/go/bin/waitfor", "--env=SERVICE_HOST,SERVICE2_HOSTS", "--sleep=1s"]