efrecon/vcluster

vcluster Docker镜像

镜像概述和主要用途

本Docker镜像提供了vcluster CLI的容器化版本，包含vcluster运行所需的helm客户端作为依赖。镜像自动从https://github.com/efrecon/k8s-images生成，旨在提供一个隔离、便捷的环境用于运行vcluster命令，无需在本地系统安装vcluster和helm。

核心功能和特性

• 完整依赖集成：包含vcluster CLI和helm客户端，满足vcluster运行的所有依赖要求
• 版本自定义：支持通过构建时参数指定vcluster和helm的版本
• 自动版本更新：当vcluster发布新版本时，镜像会自动重建以集成最新版本
• 便捷命令执行：vcluster作为镜像入口点，可直接执行vcluster命令

使用场景和适用范围

• 隔离环境需求：在需要隔离运行环境的场景中使用，避免本地环境依赖冲突
• CI/CD集成：适用于CI/CD流水线，提供标准化的vcluster执行环境
• 多版本测试：通过自定义构建参数，可快速切换不同vcluster/helm版本进行测试
• 临时操作环境：用于临时执行vcluster命令，无需在系统中持久安装依赖

详细使用方法和配置说明

基本使用方式

vcluster是镜像的默认入口点，运行容器时可直接执行vcluster命令。使用时需挂载本地kubeconfig文件和helm工作目录，或通过环境变量指定helm目录路径。

容器运行示例

shell
docker run -it --rm \
  -u $(id -u):$(id -g) \
  -v ${HOME}/.kube/config:/.kube/config:ro \
  -v ${HOME}/.cache/helm:/.cache/helm \
  -v ${HOME}/.config/helm:/.config/helm \
  -v ${HOME}/.local/share/helm:/.local/share/helm \
  efrecon/vcluster help

参数说明

• -u $(id -u):$(id -g)：设置容器内运行用户ID和组ID，避免文件权限问题
• -v ${HOME}/.kube/config:/.kube/config:ro：挂载本地kubeconfig文件（只读），用于集群访问授权
• Helm目录挂载：
  • -v ${HOME}/.cache/helm:/.cache/helm：挂载helm缓存目录
  • -v ${HOME}/.config/helm:/.config/helm：挂载helm配置目录
  • -v ${HOME}/.local/share/helm:/.local/share/helm：挂载helm数据目录

环境变量配置

可通过以下环境变量自定义helm工作目录（替代目录挂载）：

• HELM_CACHE_HOME：helm缓存目录路径（默认：/.cache/helm）
• HELM_CONFIG_HOME：helm配置目录路径（默认：/.config/helm）
• HELM_DATA_HOME：helm数据目录路径（默认：/.local/share/helm）

构建时配置参数

镜像支持通过以下构建时参数自定义组件版本：