efrecon/kubectl Docker 镜像 - 轩辕镜像

Krew-Capable kubectl Docker镜像

镜像概述和主要用途

该Docker镜像提供集成多个krew插件的kubectl工具，基于k8s-images项目自动构建，托管于Docker Hub。主要用途是简化Kubernetes管理工具链部署，用户无需手动安装配置kubectl、krew及其插件，可直接使用预配置插件的kubectl环境，适用于各类Kubernetes集群管理场景。

核心功能和特性

• 版本定制：支持通过构建参数指定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 \
  [***]

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

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发布版本格式一致