如何使用极狐GitLab 软件包仓库功能托管 helm chart?

极狐GitLab 是 GitLab 在中国的发行版,关于中文参考文档和资料有:

软件包库中的 Helm charts (BASIC ALL)


WARNING:Helm chart 库正在开发中,由于功能有限,尚未准备好用于生产。

在项目的软件包库中发布 Helm chart。然后在需要将它们用作依赖项时安装它们。

构建 Helm 包


在 Helm 文档中阅读有关这些主题的更多信息:

  • 创建您自己的 Helm chart
  • 将 Helm chart 打包成 chart 存档

对 Helm 库进行身份验证


要对 Helm 库进行身份验证,您需要:

  • 个人访问令牌,其范围设置为api。

  • 部署令牌,其范围设置为 read_package_registrywrite_package_registry 或两者均有。

  • CI/CD 作业令牌。

发布软件包


NOTE:您可以发布具有重复名称或版本的 Helm chart。如果存在重复项,系统总是返回最新版本的 chart。

构建完成后,可以使用 curlhelm cm-push 将 chart 上传到所需的 channel:

使用 curl

clike 复制代码
curl --request POST \
     --form 'chart=@mychart-0.1.0.tgz' \
     --user <username>:<access_token> \
     https://gitlab.example.com/api/v4/projects/<project_id>/packages/helm/api/<channel>/charts
  • <username>:GitLab 用户名或部署令牌用户名。

  • <access_token>:个人访问令牌或部署令牌。

  • <project_id>:项目 ID(如 42)或 URL-encoded 项目路径(如group%2Fproject)。

  • <channel>:channel 的名称(如 stable)。

使用 helm cm-push 插件:

clike 复制代码
helm repo add --username <username> --password <access_token> project-1 https://gitlab.example.com/api/v4/projects/<project_id>/packages/helm/<channel>
helm cm-push mychart-0.1.0.tgz project-1
  • <username>:GitLab 用户名或部署令牌用户名。

  • <access_token>:个人访问令牌或部署令牌。

  • <project_id>:项目 ID(如 42)。

  • <channel>:channel 的名称(如 stable)。

发布频道

您可以将 Helm 包发布到极狐GitLab 中的频道。频道是一个方法,您可以使用它来区分 Helm 包库。例如,您可以使用 stabledevel 作为频道,以允许用户添加 stable 仓库,而 devel 仓库是隔离的。

使用 CI/CD 发布 Helm 包


要通过 GitLab CI/CD 自动发布 Helm 包,您可以使用 CI_JOB_TOKEN 代替命令中的个人访问令牌。

例如:

clike 复制代码
image: curlimages/curl:latest

stages:
  - upload

upload:
  stage: upload
  script:
    - 'curl --request POST --user gitlab-ci-token:$CI_JOB_TOKEN --form "chart=@mychart-0.1.0.tgz" "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/helm/api/<channel>/charts"'
  • <username>:GitLab 用户名或部署令牌用户名。

  • <access_token>:个人访问令牌或部署令牌。

  • <channel>:channel 的名称(如 stable)。

安装软件包


NOTE:当请求一个包时,系统只考虑最近创建的 1000 个包。对于每个包,只返回最近的包文件。

要安装最新版本的 chart,请使用以下命令:

clike 复制代码
helm repo add --username <username> --password <access_token> project-1 https://gitlab.example.com/api/v4/projects/<project_id>/packages/helm/<channel>
helm install my-release project-1/mychart
  • <username>:GitLab 用户名或部署令牌用户名。

  • <access_token>:个人访问令牌或部署令牌。

  • <project_id>:项目 ID(如 42)。

  • <channel>:channel 的名称(如 stable)。

如果先前已添加仓库,则可能需要运行:

clike 复制代码
helm repo update

使用最新可用的 chart 更新 Helm 客户端。

有关更多信息,请参阅使用 Helm。

故障排查


上传后,chart 在软件包库中不可见

检查 Sidekiq 日志是否有任何相关错误。如果您看到 Validation failed: Version is invalid,则表示您的 Chart.yaml 文件中的版本不符合 Helm Chart 版本规范。

要修复错误,请使用正确的版本语法并再次上传 chart。

helm push 导致错误

Helm 3.7 为 helm-push 插件引入了重大更改。您可以更新 Chart Museum plugin,使用 helm cm-push

相关推荐
我是一颗柠檬11 小时前
【MySQL全面教学】MySQL面试高频考点汇总Day15(2026年)
数据库·后端·mysql·面试
橙淮11 小时前
并发编程(六)
java·jvm
拽着尾巴的鱼儿11 小时前
springboot openfeign 自定义feign 接口重试机制
java·spring boot·后端
白露与泡影12 小时前
2026大厂Java面试题大全!牛客网最新版
java·开发语言
凯瑟琳.奥古斯特12 小时前
高阶子查询题目精炼
开发语言·数据库·python·职场和发展·数据库开发
lolo大魔王12 小时前
Linux 文件系统超全面详解(原理、结构、挂载、分区、inode、日志、管理命令)
linux·运维·服务器
身如柳絮随风扬12 小时前
数据库读写分离:从原理到实战,构建高并发系统
数据库·mysql
EntyIU12 小时前
JVM内存与GC笔记
java·jvm·笔记
XS03010613 小时前
并发编程 六
java·后端