该镜像提供特定 Kubernetes 版本的 kubectl 二进制，避免 CI Agent 本机版本漂移。典型用法为挂载 kubeconfig、--rm 执行 apply/diff，或在 Kubernetes Job 中作为轻量工具容器。需确保镜像内 kubectl 版本与目标 API Server 相差不超过一个 minor 版本。

快速启动

docker run --rm \
  -v $HOME/.kube/config:/root/.kube/config:ro \
  docker.io/clastix/kubectl:latest \
  kubectl get nodes

推荐实践

docker run --rm \
  -v $HOME/.kube/config:/root/.kube/config:ro \
  -e KUBECONFIG=/root/.kube/config \
  docker.io/clastix/kubectl:v1.30.0 \
  kubectl apply -f deployment.yaml

核心参数说明

• -v .../.kube/config:ro — 只读挂载集群凭证
• kubectl:v1.30.0 — 与集群 control plane 版本对齐
• --rm — CI 一次性任务
• -e KUBECONFIG — 多 context 时指定配置路径
• 凭证安全 — 勿将 kubeconfig bake 进镜像层