kvij/scuttle

Scuttle

scuttle 是一款简化Istio边车容器管理的包装应用，主要功能是确保主应用程序仅在Envoy就绪后启动，并在应用退出时自动关闭Istio边车。这一工具特别适用于需要Istio边车注入的Kubernetes Job场景，可有效避免Job完成后Istio Pod无限期运行的问题。

核心功能

• Envoy就绪等待：轮询Envoy管理接口，确保主应用仅在Envoy报告LIVE状态后启动
• 边车生命周期管理：主应用退出时自动触发Istio边车关闭流程，释放集群资源
• 灵活配置控制：通过环境变量自定义等待超时、日志输出、退出行为等关键参数
• 多场景适配：支持Job、Deployment等多种工作负载，尤其优化Job场景下的边车退出逻辑

使用场景

主要适用于需要Istio边车注入的Kubernetes Job。在标准配置中，Istio边车（如Envoy代理）会在Job主进程完成后继续运行，导致Pod无法正常终止。scuttle通过精准控制边车生命周期，确保Job资源在任务完成后及时释放。

环境变量配置

部署示例

Job的Dockerfile配置

dockerfile
FROM python:latest
# 从官方镜像复制scuttle可执行文件到系统路径
COPY --from=kvij/scuttle:latest /scuttle /bin/scuttle
WORKDIR /app
COPY ./app /app
# 使用scuttle作为入口点包装主应用命令
ENTRYPOINT ["scuttle", "python", "-m", "my_app"]

上述配置会将scuttle作为主进程入口，自动管理Envoy边车生命周期，确保Python应用my_app在Envoy就绪后启动，并在应用退出时关闭Istio边车。