# @davidspekorg/semantic-release-helm 中文文档

规范地址：https://npmcn.com/package/%40davidspekorg/semantic-release-helm/

版本：1\.1\.1
npm 元数据更新时间：2024-11-25T14:45:24.871Z
中文译文更新时间：2026-11-11T16:10:10.127Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40davidspekorg/semantic-release-helm
原文对照：https://npmcn.com/package/%40davidspekorg/semantic-release-helm/?lang=original
项目主页：https://github.com/davidspek/semantic-release-helm#readme
源码仓库：https://github.com/davidspek/semantic-release-helm

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：43.6 kB，22 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2024-11-25T13:44:39.745Z
- 最新版本发布：2024-11-25T14:45:24.686Z
- 近 30 天下载量：8311（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）

## 中文简介

赫尔姆插件 [语义释放](https://github.com/semantic-release/semantic-release)

## 安装

```sh
npm install @davidspekorg/semantic-release-helm
```

也可以使用：`pnpm add @davidspekorg/semantic-release-helm`、`yarn add @davidspekorg/semantic-release-helm`、`bun add @davidspekorg/semantic-release-helm`

## README

# 语义 -- -- 释放 -- -- helm

[语义释放](https://github.com/semantic-release/semantic-release) 用于发布向方向盘存储器和 OCI 注册器的向导图的插件 .

内容更新 [赫尔姆](https://helm.sh/) 图表 `version` 财务报告和审定财务报表 `appVersion` 内 `Chart.yaml`。 。 。 .

它支持下列议定书:

-   [OCI 组织](https://helm.sh/docs/topics/registries/)
-   [图表博物馆](https://chartmuseum.com/)

## 安装

```
npm install -D @davidspekorg/semantic-release-helm
```

## 配置

| 选项 | 说明 | 需求 | 类型 | 默认 |
| --- | --- | --- | --- | --- |
| 图表存储器 | 图表存储器的 URI | 对\* | `string` | `none` |
| 社团注册 | OCI 注册的 URI | 对\* | `string` | `none` |
| 图表目录 | 图表目录 `Chart.yml` 已经找到 | 没有 | `string` | `.` |
| 版本更新政策 | 设置更新策略 `version` 图.yaml 字段 | 没有 | `"fixed" | "sync" | "desync"` | `"sync"` |
| 应用程序更新政策 | 设置更新策略 `appVersion` 图.yaml 字段 | 没有 | `"fixed" | "sync" | "desync"` | `"sync"` |

\* 需要至少一个联合登记库或图表存储库.

通过环境变量传递证书以登录主控器存储器 .

```
export HELM_REPOSITORY_USERNAME=<USERNAME>
export HELM_REPOSITORY_PASSWORD=<PASSWORD>
export HELM_REGISTRY_USERNAME=<USERNAME>
export HELM_REGISTRY_PASSWORD=<PASSWORD>
```

`HELM_REPOSITORY_USERNAME` 财务报告和审定财务报表 `HELM_REPOSITORY_PASSWORD` 用于图表库登录.

`HELM_REGISTRY_USERNAME` 财务报告和审定财务报表 `HELM_REGISTRY_PASSWORD` 用于OCI 注册登录.

如果您正在使用联合登记册,但没有提供证书,它将使用 `HELM_REPOSITORY_USERNAME` 财务报告和审定财务报表 `HELM_REPOSITORY_PASSWORD` 用于登录.

### 关于版本 Update Policy & appersion Update 政策

更新策略

-   **已固定**: 使用固定版本. 该版本不会更新
-   **同步**: 使用 `nextRelease.version`。新版本将设定为 `nextRelease.version`
-   **脱色**: 将根据 `nextRelease.type` (单位:千美元) _`major`_, (中文(简体) ), _`premajor`_, (中文(简体) ), _`minor`_, (中文(简体) ), _`preminor`_, (中文(简体) ), _`patch`_, (中文(简体) ), _`prepatch`_, (中文(简体) ), _`prerelease`_(中文(简体) )

## 示例

```json
{
  "plugins": [
    [
      "@davidspekorg/semantic-release-helm",
      {
        "chartRepository": "https://mychart.company.org/chartrepo/myproject",
        "ociRegistry": "mychart.company.org/myproject",
        "chartDirectory": "./chart",
        "versionUpdatePolicy": "sync",
        "appVersionUpdatePolicy": "fixed"
      }
    ]
  ]
}
```

-   您的图表仓库是 `https://mychart.company.org/chartrepo/myproject` oCI 登记为 `mychart.company.org/myproject`。 。 。 .
-   `Chart.yaml` 进入 `chart` 子目录
-   `version` 将会跟随下一个版本 `appVersion` 将不修改

旧版本

```yaml
# semantic-release version: 1.2.3
version: 1.2.3
appVersion: 2.3.1
```

新版本 - 案例 1 补丁

```yaml
# semantic-release version: 1.2.4
version: 1.2.4
appVersion: 2.3.1
```

新版本 - 第2个小案

```yaml
# semantic-release version: 1.3.0
version: 1.3.0
appVersion: 2.3.1
```

新版本 - 第3个案例

```yaml
# semantic-release version: 2.0.0
version: 2.0.0
appVersion: 2.3.1
```

## 常见问题

### @davidspekorg/semantic-release-helm 是什么？

赫尔姆插件 语义释放

### 如何安装 @davidspekorg/semantic-release-helm？

在项目目录运行 npm install @davidspekorg/semantic-release-helm，或使用 pnpm add / yarn add / bun add。

### @davidspekorg/semantic-release-helm 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @davidspekorg/semantic-release-helm 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @davidspekorg/semantic-release-helm 可以商用吗？

@davidspekorg/semantic-release-helm 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @davidspekorg/semantic-release-helm 的下载量有多少？

根据 npm 官方下载统计，@davidspekorg/semantic-release-helm 在 2026/10/12 – 2026/11/10 这 30 天内被下载 8,311 次，日均约 277 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @davidspekorg/semantic-release-helm 还在维护吗？

最新版本 1\.1\.1 发布于 2024/11/25（2 年前）；至今共发布 3 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/11/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。