ChartMuseum 是 Kubernetes 生态中用于存储、管理和发布 Helm Charts 的开源系统,主要用于扩展 Helm 包管理器的功能
核心功能
集中存储:提供中央化仓库存储Charts,支持版本管理和权限控制。
跨集群部署:支持多集群环境下共享Charts,简化部署流程。
离线部署:适配无网络环境,可将Charts存储在本地或局域网内。
HTTP接口:通过HTTP协议提供服务,用户可通过Helm客户端上传、下载及搜索Charts。
1.docker启动ChartMuseum
docker run -d \
--name chartmuseum \
-p 8080:8080 \
-v $(pwd)/charts:/charts \
-e STORAGE=local \
-e STORAGE_LOCAL_ROOTDIR=/charts \
chartmuseum/chartmuseum:latest
-v $(pwd)/charts:/charts:将当前目录下的 charts/ 文件夹作为存储路径。
1.1给charts文件夹权限
chmod -R 777 /app/KubeSphere/charts

2.添加私有仓库到 Helm 客户端
在你的 Helm 客户端机器上执行:
helm repo add sinopsrepo http://172.23.123.117:8080
helm repo list

3.安装 helm-push 插件
cm-push 是一个 Helm 插件,允许你将本地 .tgz 格式的 Helm Chart 包上传到 ChartMuseum 或兼容的 Helm 仓库服务器(如 Harbor、Nexus、Jfrog Artifactory 等)
3.1解压
#tar -zxvf ++++helm-push_0.10.4_linux_amd64.tar.gz++++
3.2查看 Helm Home(插件安装路径)
HELM_PLUGINS_DIR=$(helm env | grep HELM_PLUGINS | cut -d '=' -f2 | tr -d '"')
root@master bin\]# echo $HELM_PLUGINS_DIR  #### 3.3******创建插件目录****** mkdir -p "$HELM_PLUGINS_DIR/helm-push" 把下载好的 helm-push 放在"$HELM_PLUGINS_DIR/helm-push" 并解压 #tar -zxvf helm-push_0.10.4_linux_amd64.tar.gz 解压后包括/bin/helm-cm-push及plugin.yaml #### 3.4******赋予可执行权限****** chmod +x "$HELM_PLUGINS_DIR/helm-push/bin/helm-cm-push" #### 3.5******验证插件****** helm plugin list  ### 4.上传zookeeper到 Chart helm cm-push zookeeper-13.8.4.tgz sinopsrepo  ### 5.******查看私有仓库的组件****** helm repo update(如果不执行该行代码,会导致最新上传的chart看不到) helm search repo sinopsrepo  ### 6.私有仓库安装 Helm Chart helm repo update helm install zookeeper sinopsrepo/zookeeper --version 13.8.4 ### 7卸载 helm uninstall my-zookeeper ### 8.参数详解 #### ⚙️ 通用设置 | 参数 | 环境变量 | 含义 | |----------------------------|--------------------------|------------------------------------------------------| | `--access-token string` | `HELM_REPO_ACCESS_TOKEN` | 使用 Token 认证时提供访问令牌(例如 GitHub Personal Access Token)。 | | `-a, --app-version string` | - | 覆盖 Chart 中的 `appVersion` 字段。 | | `--auth-header string` | `HELM_REPO_AUTH_HEADER` | 自定义认证请求头字段名称。 | | `--ca-file string` | `HELM_REPO_CA_FILE` | 指定 CA 证书文件路径,用于验证 HTTPS 服务器。 | | `--cert-file string` | `HELM_REPO_CERT_FILE` | 客户端 SSL 证书文件路径(用于双向 TLS)。 | | `--check-helm-version` | - | 输出当前使用的 Helm 主版本号(2 或 3)。 | | `--context-path string` | `HELM_REPO_CONTEXT_PATH` | ChartMuseum 的上下文路径(如 `/charts`)。 | | `--debug` | - | 开启调试模式,显示更详细的日志信息。 | | `-d, --dependency-update` | - | 打包前更新依赖项(从 `requirements.yaml` 到 `charts/` 目录)。 | | `-f, --force` | - | 即使远程仓库已存在相同版本也强制推送。 | | `-h, --help` | - | 显示帮助信息。 | *** ** * ** *** #### 🏠 Helm 配置目录 | 参数 | 默认值 | 含义 | |-----------------|---------------|---------------------------------------| | `--home string` | `/root/.helm` | 设置 Helm 的配置根目录(可覆盖环境变量 `$HELM_HOME`)。 | *** ** * ** *** #### 🛡️ Tiller 设置(Helm 2 特有) > Helm 3 已移除 Tiller,以下参数主要用于兼容旧 Helm 2 行为。 | 参数 | 默认值 | 含义 | |-----------------------------------|---------------|------------------------| | `--host string` | - | Tiller 地址(若使用 Helm 2)。 | | `--tiller-namespace string` | `kube-system` | Tiller 所在命名空间。 | | `--tiller-connection-timeout int` | `300` 秒 | 连接 Tiller 的超时时间。 | *** ** * ** *** #### 🔐 HTTPS 和认证相关 | 参数 | 环境变量 | 含义 | |-------------------------|----------------------|---------------------------------------| | `--insecure` | `HELM_REPO_INSECURE` | 忽略 HTTPS 证书校验(适用于自签名证书)。 | | `--key-file string` | `HELM_REPO_KEY_FILE` | 客户端 SSL 密钥文件路径(用于双向 TLS)。 | | `--keyring string` | - | GPG 公钥环路径(默认:`~/.gnupg/pubring.gpg`)。 | | `-p, --password string` | `HELM_REPO_PASSWORD` | HTTP Basic Auth 密码。 | | `-u, --username string` | `HELM_REPO_USERNAME` | HTTP Basic Auth 用户名。 | *** ** * ** *** #### 🕒 超时控制 | 参数 | 默认值 | 含义 | |---------------------|--------|----------------------------| | `-t, --timeout int` | `30` 秒 | 等待 ChartMuseum 响应的最大时间(秒)。 | *** ** * ** *** #### 📦 Chart 元数据覆盖 | 参数 | 含义 | |------------------------|------------------------------| | `-v, --version string` | 覆盖 Chart 的版本号(`version` 字段)。 |