efrecon/helm

helm Docker镜像

镜像概述与主要用途

efrecon/helm镜像在支持https://krew.sigs.k8s.io/的https://hub.docker.com/r/efrecon/kubectl基础上提供`helm`工具，用于在Docker环境中便捷运行`helm`命令。该镜像基于https://github.com/efrecon/k8s-images自动构建生成，专为Kubernetes相关操作设计。

核心功能与特性

• 集成工具链：包含helm和kubectl工具，helm作为镜像入口点，直接支持helm命令行操作。
• 自动构建更新：当helm发布新稳定版本时，镜像会自动重建，确保用户可获取最新helm版本。
• 可配置构建参数：支持通过构建时参数自定义工具版本：
  • K8S_VERSION：指定kubectl客户端版本（可带或不带前缀v，需为已存在版本）。
  • HELM_VERSION：指定helm版本，可设为latest（构建时安装最新稳定版）或具体版本号（可带或不带前缀v，需为已存在版本）。

使用场景与适用范围

• 容器化helm操作：在无本地helm安装环境中，通过容器快速执行helm命令（如Chart安装、升级、卸载等）。
• CI/CD流水线集成：作为临时环境在持续集成/部署流程中运行helm部署Kubernetes应用。
• 临时管理环境：用于临时Kubernetes集群管理，避免本地环境配置冲突。
• 多工具协同：需同时使用helm和kubectl的场景，镜像已集成两者，无需额外配置。

使用方法与配置说明

运行前准备

使用镜像需挂载以下目录，确保helm正常访问Kubernetes集群及持久化配置数据：

• Kubernetes配置文件：本地kubeconfig文件（通常位于${HOME}/.kube/config），需以只读方式挂载。
• Helm数据目录：包括缓存（~/.cache/helm）、配置（~/.config/helm）和数据（~/.local/share/helm）目录，用于持久化Helm缓存、配置及数据。

Docker运行示例

通过docker run命令直接执行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 \
  docker.xuanyuan.run/efrecon/helm --version

参数说明：

• -u $(id -u):$(id -g)：指定运行用户ID和组ID，避免容器内权限问题。
• -v ${HOME}/.kube/config:/.kube/config:ro：挂载本地kubeconfig文件（只读模式）。
• 后续-v参数：分别挂载Helm的缓存、配置、数据目录，确保数据持久化。

Docker Compose配置示例

yaml
version: '3'
services:
  helm:
    image: docker.xuanyuan.run/efrecon/helm
    user: "${UID}:${GID}"  # 需提前设置环境变量UID=$(id -u)、GID=$(id -g)
    volumes:
      - "${HOME}/.kube/config:/.kube/config:ro"
      - "${HOME}/.cache/helm:/.cache/helm"
      - "${HOME}/.config/helm:/.config/helm"
      - "${HOME}/.local/share/helm:/.local/share/helm"
    entrypoint: ["helm"]  # 镜像默认入口点为helm，可省略

运行命令：UID=$(id -u) GID=$(id -g) docker-compose run --rm helm --version

环境变量说明

运行时可通过以下环境变量自定义Helm目录（替代默认挂载路径）：

• HELM_CACHE_HOME：Helm缓存目录，默认/.cache/helm。
• HELM_CONFIG_HOME：Helm配置目录，默认/.config/helm。
• HELM_DATA_HOME：Helm数据目录，默认/.local/share/helm。

注意事项

• kubectl版本自动更新：每次镜像重建（包括helm新版本发布时）会自动使用最新kubectl版本，这是构建流程的已知副作用，可能不符合需固定kubectl版本的场景。如需特定kubectl版本，建议通过K8S_VERSION构建自定义镜像。