chatwork/helmfile

helmfile Docker镜像文档

镜像概述

helmfile Docker镜像是封装了helmfile工具的容器化镜像，旨在提供便捷的方式通过helmfile管理Helm Charts。该镜像仅支持Helm 3版本，适用于需要在容器环境中统一管理Helm Chart部署配置的场景。

项目源码：https://github.com/helmfile/helmfile

核心功能与特性

• 支持Helm 3：镜像仅兼容Helm 3版本，确保与最新Helm功能同步
• 容器化部署：将helmfile工具容器化，避免本地环境依赖冲突
• 配置灵活性：支持挂载外部配置文件（如helmfile.yaml、Kubernetes配置、Helm配置），实现自定义部署逻辑
• 集成便捷：可直接集成到CI/CD流程或容器化部署管道中，简化Helm Chart的批量管理操作

使用场景

• 容器化环境中通过helmfile管理多个Helm Chart的部署配置
• CI/CD流水线中自动化执行Helm Chart的同步、部署或测试操作
• 开发/测试环境中快速初始化Helm部署环境，避免本地工具版本不一致问题

使用方法与配置说明

基础使用命令

通过docker run命令启动容器，执行helmfile操作。以下为基本使用示例：

bash
docker run -v ~/.kube:/root/.kube -v ${PWD}/.helm:/root/.helm -v ${PWD}/helmfile.yaml:/helmfile.yaml --net=host chatwork/helmfile sync --args --debug --args --dry-run

参数说明

上述命令中各参数的作用如下：

自定义配置

可根据实际需求调整挂载的文件或目录，例如：

• 若需使用自定义helmfile配置文件路径，可修改挂载路径（如-v /path/to/custom/helmfile.yaml:/custom/path/helmfile.yaml），并在命令中指定配置文件路径（chatwork/helmfile -f /custom/path/helmfile.yaml sync）
• 如需持久化Helm缓存或插件，可额外挂载Helm缓存目录（如-v ${PWD}/.helm/cache:/root/.helm/cache）

注意事项

• 该镜像仅支持Helm 3，不兼容Helm 2版本
• 确保挂载的Kubernetes配置（~/.kube/config）具有目标集群的访问权限
• --net=host选项可能在部分容器运行时（如Docker Desktop）中需要额外网络配置，若网络访问异常可尝试移除该选项并通过-p映射必要端口