如何使用极狐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_registry、write_package_registry 或两者均有。

  • CI/CD 作业令牌。

发布软件包


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

构建完成后,可以使用 curl 或 helm 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 包库。例如,您可以使用 stable 和 devel 作为频道,以允许用户添加 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。

相关推荐
长安米粒贵1 分钟前
事务隔离级别选对了,为什么还是会出现丢失更新?聊聊 5 个并发误区
数据库
祥Sir的SRE笔记11 分钟前
CPU 100% 不一定是故障:压测打满、业务饱和、突变打满的判断与排查
linux·面试·性能优化·dba·sre·故障定位·性能排查
一条泥憨鱼11 分钟前
【Redis | 黑马点评】达人探店功能源码解读
数据库·redis·缓存
可爱系程序猿23 分钟前
nvcuvid.dll 加载失败定位:CUDA 视频解码、驱动接口与进程位数逐项核查
运维·服务器·程序人生·电脑·音视频
泡茶喝茶写代码24 分钟前
A股量化策略回测实战:从行情数据到绩效评估(第 13 篇):放量突破策略
java·python·股票数据api·股票数据api接口·股票量化数据api·股票量化数据接口
郝亚军24 分钟前
在win11上用openssl生成私钥、再从私钥导出公钥、...
linux·运维·服务器
hanjq_code25 分钟前
gitlab本地文件 跨分支 忽略改动 不提交
gitlab
赵渝强老师25 分钟前
【赵渝强老师】崖山数据库的命令行客户端工具
数据库·国产数据库·yashandb·崖山数据库
文丑颜不良啊28 分钟前
LeetCode626~650题目解析
java·leetcode
忡黑梨35 分钟前
PostgreSQL 小版本升级实战:14.23 升级到 14.24(源码编译方式)
数据库·postgresql