kvij/scuttle Docker Image Overview

kvij/scuttle

Istio边车生命周期管理工具，确保主应用在Envoy就绪后启动并在应用退出时关闭边车，解决需Istio注入的Job完成后Pod持续运行问题。

0 次下载

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资源在任务完成后及时释放。

环境变量配置

变量名	用途描述
`ENVOY_ADMIN_API`	Envoy管理接口地址，格式为`[***]`。配置后`scuttle`会轮询`/server_info`端点等待Envoy就绪；若为本地地址（`127.0.0.1`/`localhost`），应用正常退出时会自动关闭Envoy
`NEVER_KILL_ISTIO`	设为`true`时，无论何种情况均不触发Istio边车关闭
`NEVER_KILL_ISTIO_ON_FAILURE`	设为`true`时，主应用非零退出码退出时不触发Istio边车关闭
`SCUTTLE_LOGGING`	设为`true`时启用调试日志，输出关键流程信息到控制台
`START_WITHOUT_ENVOY`	设为`true`时跳过Envoy就绪等待直接启动主应用，但仍保留边车关闭功能
`WAIT_FOR_ENVOY_TIMEOUT`	Envoy就绪等待超时时间（`time.Duration`格式，如`30s`），默认无限期等待。若同时设置`QUIT_WITHOUT_ENVOY_TIMEOUT`，后者优先级更高
`ISTIO_QUIT_API`	Envoy Pilot Agent接口地址，格式为`[*]`。未配置时若`ENVOY_ADMIN_API`使用默认端口`*`则自动填充。通过向`/quitquitquit`发送POST请求关闭Envoy
`GENERIC_QUIT_ENDPOINTS`	需触发退出通知的自定义端点列表（CSV格式，如`[***]`）。请求响应状态码仅日志记录，不影响流程执行，该操作优先于Istio关闭流程
`GENERIC_QUIT_ONLY`	设为`true`时仅触发`GENERIC_QUIT_ENDPOINTS`通知，不执行Istio边车关闭操作

部署示例

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边车。

查看更多 scuttle 相关镜像 →