---
url: /zh/artifact/helm.md
---
## 登录 CNB Helm 制品库

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

登录命令如下。如何获取 `CNB_TOKEN` 请参考[创建访问令牌](./intro.md#创建访问令牌)。

```bash
helm registry login helm.cnb.share.ralphlauren.cn -u cnb -p ${CNB_TOKEN}
```

## Helm 制品路径规则

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

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

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

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

## 推送制品

### 本地推送

同名制品

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

非同名制品

```bash
helm package chart-path
helm push chartname-version.tgz oci://helm.cnb.share.ralphlauren.cn/${CNB_REPO_SLUG_LOWERCASE}
```

### 云原生构建中推送

```yaml title=".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}
```

### 云原生开发中推送

同名制品

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

非同名制品

```bash
helm package ${YOUR_CHART_PATH}
helm push chartname-version.tgz oci://helm.cnb.share.ralphlauren.cn/${CNB_REPO_SLUG_LOWERCASE}
```

## 使用制品

### 本地命令行拉取

```bash
helm pull oci://helm.cnb.share.ralphlauren.cn/<ARTIFACT_PATH> --version <VERSION>

# ...
```

### 其他常用命令

#### 查看 Helm 信息

```bash
helm show all oci://helm.cnb.share.ralphlauren.cn/<ARTIFACT_PATH> --version <VERSION>
```

#### 预览 manifest

```bash
helm template <RELEASE_NAME> oci://helm.cnb.share.ralphlauren.cn/<ARTIFACT_PATH> --version <VERSION>
```

#### 安装 helm chart

```bash
helm install <RELEASE_NAME> oci://helm.cnb.share.ralphlauren.cn/<ARTIFACT_PATH> --version <VERSION>
```

#### 升级 helm chart

```bash
helm upgrade <RELEASE_NAME> oci://helm.cnb.share.ralphlauren.cn/<ARTIFACT_PATH> --version <VERSION>
```

## 更多用法

更多 Helm 用法，请查阅官方文档