devth/helm

helm-docker

镜像概述与主要用途

devth/helm 是一个集成了 Helm 包管理工具及相关云服务与 Kubernetes 工具的 Docker 镜像。该镜像旨在提供一站式环境，方便用户在容器化场景中使用 Helm 进行 Kubernetes 应用的打包、发布与管理，同时集成 gcloud（Google Cloud 命令行工具）、kubectl（Kubernetes 命令行工具）及其他辅助工具，简化云服务与 Kubernetes 集群的交互流程。

核心功能与特性

内置工具

• Helm：Kubernetes 包管理工具，用于定义、安装和升级 Kubernetes 应用。
• gcloud：Google Cloud 平台命令行工具，支持云资源管理、认证及集群操作。
• kubectl：Kubernetes 集群命令行工具，用于直接与 Kubernetes API 交互。
• envsubst：环境变量替换工具，用于动态替换配置文件中的变量。
• jq：轻量级 JSON 处理工具，用于解析和转换 JSON 数据。
• vals：配置值管理工具，支持从多种数据源（如环境变量、密钥管理服务）加载配置值。

Helm 插件

• viglesiasce/helm-gcs：Helm 插件，支持将 Chart 仓库托管至 Google Cloud Storage (GCS)。
• databus23/helm-diff：Helm 插件，用于比较不同发布版本或本地 Chart 与集群中部署状态的差异。
• helm/helm-2to3：Helm 插件，提供从 Helm 2 到 Helm 3 的平滑迁移工具。

使用场景与适用范围

1. Kubernetes 应用部署自动化：在 CI/CD 流水线中集成该镜像，实现基于 Helm 的应用打包、版本管理与部署。
2. 多工具集成环境：需要同时使用 Helm、gcloud、kubectl 的场景，避免在本地或构建环境中手动安装配置多工具。
3. Helm 插件依赖场景：依赖 helm-gcs、helm-diff 等插件的工作流，如 GCS 仓库管理、发布差异校验。
4. 云服务与 Kubernetes 结合部署：通过 gcloud 进行云资源认证（如 GKE 集群访问），结合 kubectl 和 helm 完成应用部署。

使用方法与配置说明

镜像获取

Docker Hub 地址

镜像托管于 Docker Hub：https://hub.docker.com/r/devth/helm/

版本标签说明

• latest：对应 Helm 最新稳定版本（非 beta/RC 版本）。
• master：对应 Helm 源码仓库 master 分支最新提交，包含开发阶段特性。
• 特定版本标签：如 v3.6.3，对应 Helm 官方发布版本，标签与 https://github.com/helm/helm/releases 一致。

本地构建

如需本地构建镜像，执行以下命令：

bash
docker build -t devth/helm .

容器运行示例

基本使用（查看 Helm 版本）

bash
docker run --rm devth/helm helm version

交互式使用

启动容器并进入交互式终端，可直接使用所有内置工具：

bash
docker run -it --rm devth/helm /bin/sh

挂载配置文件（如 kubeconfig、gcloud 配置）

为使容器内工具能访问本地配置（如 Kubernetes 集群凭证、gcloud 认证信息），可挂载本地配置目录：

bash
docker run -it --rm \
  -v ~/.kube/config:/root/.kube/config \  # 挂载 kubectl 配置
  -v ~/.config/gcloud:/root/.config/gcloud \  # 挂载 gcloud 配置
  devth/helm /bin/sh

进入容器后，即可直接使用 kubectl 访问集群，或通过 gcloud 执行云服务操作。

环境变量说明

版本管理与发布（维护参考）

版本更新流程

1. 修改版本号：更新 Dockerfile 中的 VERSION 环境变量，指定目标 Helm 版本。
2. 提交与打标签：提交修改并创建与版本号一致的 Git 标签，触发 Docker Hub 自动构建。

示例命令（适用于 macOS sed）：

bash
# 定义目标版本和关联 Issue
VERSION=v3.6.3
ISSUE=124

# 修改 Dockerfile 中的 VERSION
sed -i "" "3s/.*/ENV VERSION $VERSION/" Dockerfile

# 验证修改
git diff

# 提交并打标签
git commit -am "Bump to $VERSION; fix #$ISSUE"
git tag $VERSION

# 推送提交和标签（触发自动构建）
git push && git push --tags

重新发布版本

如需重新构建特定版本（如修复构建问题），需先删除本地及远程 Git 标签，再重新打标签推送：

bash
# 删除远程标签
git push origin :$VERSION

# 删除本地标签
git tag -d $VERSION

# 重新打标签并推送
git tag $VERSION
git push --tags

本地构建测试

在推送标签前，可本地构建镜像验证：

bash
docker build .