Helm 制品库

446 字约 1 分钟

登录 CNB Helm 制品库

CNB Helm 仅支持 OCI 格式的 Helm 制品，建议使用 Helm v3.8.0 以上版本，详情请查阅 Helm 文档

登录命令如下。如何获取 CNB_TOKEN 请参考创建访问令牌。

helm registry login helm.cnb.cool -u cnb -p ${CNB_TOKEN}

Helm 制品路径规则

helm 制品在发布到某一仓库时，支持两种命名规则

同名制品 - 制品路径与仓库路径一致，如：helm.cnb.cool/${CNB_REPO_SLUG_LOWERCASE}
非同名制品 - 以仓库路径作为制品的命名空间，制品路径 = 仓库路径/制品名称，如：helm.cnb.cool/${CNB_REPO_SLUG_LOWERCASE}/<ARTIFACT_NAME>

注意：helm push remote 时，chart name 不出现在 remote-url 中，而是从 chart 中读取。

所以，同名制品的 remote-url 为 helm.cnb.cool/${CNB_GROUP_SLUG_LOWERCASE}，非同名制品的 remote-url 为 helm.cnb.cool/${CNB_REPO_SLUG_LOWERCASE}。

推送制品

本地推送

同名制品

# chart name 需与仓库同名
helm package chart-path
helm push chartname-version.tgz oci://helm.cnb.cool/${CNB_GROUP_SLUG_LOWERCASE}

非同名制品

helm package chart-path
helm push chartname-version.tgz oci://helm.cnb.cool/${CNB_REPO_SLUG_LOWERCASE}

云原生构建中推送

.cnb.yml
main:
  push:
    - docker:
        image: alpine/helm
      stages:
        - name: helm login
          script: helm registry login -u ${CNB_TOKEN_USER_NAME} -p "${CNB_TOKEN}" ${CNB_HELM_REGISTRY}
        - name: helm package
          script: helm package ${YOUR_CHART_PATH}
        - name: helm push
          script: helm push oci://${CNB_HELM_REGISTRY}/${CNB_GROUP_SLUG_LOWERCASE}

云原生开发中推送

同名制品

# chart name 需与仓库同名
helm package ${YOUR_CHART_PATH}
helm push chartname-version.tgz oci://helm.cnb.cool/${CNB_GROUP_SLUG_LOWERCASE}

非同名制品

helm package ${YOUR_CHART_PATH}
helm push chartname-version.tgz oci://helm.cnb.cool/${CNB_REPO_SLUG_LOWERCASE}

使用制品

本地命令行拉取

helm pull oci://helm.cnb.cool/<ARTIFACT_PATH> --version <VERSION>

# ...

其他常用命令

查看 Helm 信息

helm show all oci://helm.cnb.cool/<ARTIFACT_PATH> --version <VERSION>

预览 manifest

helm template <RELEASE_NAME> oci://helm.cnb.cool/<ARTIFACT_PATH> --version <VERSION>

安装 helm chart

helm install <RELEASE_NAME> oci://helm.cnb.cool/<ARTIFACT_PATH> --version <VERSION>

升级 helm chart

helm upgrade <RELEASE_NAME> oci://helm.cnb.cool/<ARTIFACT_PATH> --version <VERSION>