efrecon/kubectl

Krew-Capable kubectl Docker镜像

镜像概述和主要用途

该Docker镜像提供集成多个krew插件的kubectl工具，基于https://github.com/efrecon/k8s-images%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%89%98%E7%AE%A1%E4%BA%8Ehttps://hub.docker.com/r/efrecon/kubectl%E3%80%82%E4%B8%BB%E8%A6%81%E7%94%A8%E9%80%94%E6%98%AF%E7%AE%80%E5%8C%96Kubernetes%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7%E9%93%BE%E9%83%A8%E7%BD%B2%EF%BC%8C%E7%94%A8%E6%88%B7%E6%97%A0%E9%9C%80%E6%89%8B%E5%8A%A8%E5%AE%89%E8%A3%85%E9%85%8D%E7%BD%AE%60kubectl%60%E3%80%81krew%E5%8F%8A%E5%85%B6%E6%8F%92%E4%BB%B6%EF%BC%8C%E5%8F%AF%E7%9B%B4%E6%8E%A5%E4%BD%BF%E7%94%A8%E9%A2%84%E9%85%8D%E7%BD%AE%E6%8F%92%E4%BB%B6%E7%9A%84%60kubectl%60%E7%8E%AF%E5%A2%83%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%90%84%E7%B1%BBKubernetes%E9%9B%86%E7%BE%A4%E7%AE%A1%E7%90%86%E5%9C%BA%E6%99%AF%E3%80%82

核心功能和特性

• 版本定制：支持通过构建参数指定kubectl版本（K8S_VERSION）和krew版本（KREW_VERSION），满足不同环境版本需求
• 插件预装：通过KREW_PLUGINS参数指定预装krew插件列表，构建时自动安装
• 路径配置：krew插件安装于KREW_ROOT目录，PATH环境变量优先包含$KREW_ROOT/bin，确保插件可直接调用
• 即开即用：以kubectl为镜像入口点，挂载kubeconfig后即可直接执行kubectl及插件命令

使用场景和适用范围

• 开发测试：快速搭建带有常用插件的kubectl环境，无需本地配置
• CI/CD流水线：集成需要特定插件的Kubernetes操作（如资源分析、上下文切换）
• 团队协作：统一团队使用的kubectl和插件版本，消除环境差异
• 临时管理任务：快速部署包含特定插件的环境，用于集群诊断或维护

使用方法和配置说明

构建时配置参数

构建镜像时可通过--build-arg调整以下参数：

运行时使用示例

基本使用（默认镜像）

挂载本地kubeconfig文件，执行kubectl命令：

shell
# 查看版本信息
docker run -it --rm -v ${HOME}/.kube/config:/root/.kube/config:ro efrecon/kubectl version

# 获取集群节点信息
docker run -it --rm -v ${HOME}/.kube/config:/root/.kube/config:ro efrecon/kubectl get nodes

自定义构建示例

构建包含kubectl 1.28.0、krew v0.4.3及插件ctx（kubectx）、ns（kubens）、tree的镜像：

shell
docker build \
  --build-arg K8S_VERSION=v1.28.0 \
  --build-arg KREW_VERSION=v0.4.3 \
  --build-arg KREW_PLUGINS="ctx ns tree" \
  -t custom-kubectl:v1 \
  https://github.com/efrecon/k8s-images.git#master:kubectl

使用自定义镜像执行插件命令：

shell
# 列出Kubernetes contexts
docker run -it --rm -v ${HOME}/.kube/config:/root/.kube/config:ro custom-kubectl:v1 ctx

# 以树形结构查看Pod
docker run -it --rm -v ${HOME}/.kube/config:/root/.kube/config:ro custom-kubectl:v1 tree pod my-pod -n default

注意事项

• 挂载kubeconfig时建议使用ro（只读）模式，避免容器内意外修改配置
• KREW_PLUGINS需指定krew插件仓库中存在的插件名称，可通过krew插件列表查询
• KREW_VERSION指定具体版本时必须以v开头（如v0.4.3），与krew发布版本格式一致