karlkfi/kubexit

kubexit

用于协调Kubernetes Pod容器终止的命令监督器。

!kubexit dockerhub stars !kubexit dockerhub pulls !kubexit license !kubexit latest release

镜像概述

kubexit是一款针对Kubernetes Pod的命令监督工具，旨在解决Pod内多容器间的依赖顺序问题，支持启动依赖（Birth Dependencies）和终止依赖（Death Dependencies）管理，确保容器按预期启动和优雅退出。

核心功能

墓碑机制（Tombstones）

kubexit会自动在本地文件系统的指定目录（墓地）生成墓碑文件，记录被监督进程的启动时间（Born）、退出时间（Died）及退出码（ExitCode）。Pod内容器可通过共享内存卷访问该目录，实现容器间状态感知。

墓碑文件内容示例：

Born: <timestamp>
Died: <timestamp>
ExitCode: <int>

启动依赖

kubexit可阻塞依赖容器的启动，直到被依赖容器（如侧car代理）就绪。适用于侧car代理需先于主容器启动的场景，避免主容器网络请求失败。

终止依赖

当被依赖容器（如主应用）退出时，kubexit会向依赖容器（如侧car）发送TERM信号，确保其优雅退出。适用于Kubernetes Job场景，避免侧car持续运行导致Job无法完成。

使用场景

1. Kubernetes Job侧car退出：Job需所有容器退出才结束，通过终止依赖确保侧car在主容器退出后优雅关闭。
2. 侧car代理启动顺序：主容器需等待侧car代理（如Istio、CloudSQL Proxy）就绪后再启动，避免网络请求失败。

配置说明

kubexit通过环境变量配置：

• 墓碑相关：
  • KUBEXIT_NAME：墓碑文件名，若使用启动依赖需与Pod容器名一致。
  • KUBEXIT_GRAVEYARD：墓碑存储目录路径。
• 终止依赖：
  • KUBEXIT_DEATH_DEPS：终止依赖的容器名列表（逗号分隔）。
  • KUBEXIT_GRACE_PERIOD：优雅终止等待时长，默认30s。
• 启动依赖：
  • KUBEXIT_BIRTH_DEPS：启动依赖的容器名列表（逗号分隔）。
  • KUBEXIT_BIRTH_TIMEOUT：等待启动依赖就绪的超时时间，默认30s。
  • KUBEXIT_POD_NAME：Pod名称。
  • KUBEXIT_NAMESPACE：Pod所在命名空间。

安装与部署

多阶段构建示例

dockerfile
FROM karlkfi/kubexit:latest AS kubexit

FROM alpine:3.11
RUN apk --no-cache add ca-certificates tzdata
COPY --from=kubexit /bin/kubexit /bin/
ENTRYPOINT ["kubexit"]

Init容器部署示例

yaml
volumes:
- name: kubexit
  emptyDir: {}

initContainers:
- name: kubexit
  image: karlkfi/kubexit:latest
  command: ['cp', '/bin/kubexit', '/kubexit/kubexit']
  volumeMounts:
  - mountPath: /kubexit
    name: kubexit

示例

• 客户端-服务器Job
• CloudSQL Proxy Job