Skip to content

HelmSharp在 .NET 中使用 Helm Chart

在托管代码里渲染、检查和发布 Helm Chart;运行时不需要启动 Helm CLI。

HelmSharp logo

按你要完成的事开始

最小的有效渲染

先安装 Chart 与渲染器包:

powershell
dotnet add package HelmSharp.Chart --version 1.3.2
dotnet add package HelmSharp.Engine --version 1.3.2

然后加载 Chart 目录、构造 values 并渲染。可直接复制运行的程序和这三个对象的职责见快速开始

csharp
var chart = await HelmChartLoader.LoadAsync(chartPath, CancellationToken.None);
var values = await HelmValues.BuildAsync(chart, valuesFiles: null, null, null, null, null, null, CancellationToken.None);
var renderer = new HelmTemplateRenderer(chart, "demo", "default", values);

var manifest = renderer.Render();
预览请使用低层路径。它只读取 Chart 输入并返回字符串。只有明确需要发布记录或 Kubernetes 变更时,才使用 HelmSharp.Action

选择入口

你在构建…从这里开始接着阅读
预览、校验或 GitOps 生成器HelmSharp.Chart + HelmSharp.Engine渲染 Chart
部署服务或 operatorHelmSharp.Action安装和升级 Release
已经持有 YAML 的 Kubernetes 控制器HelmSharp.Kube直接提交清单
Chart 仓库或打包流水线HelmSharp.Action + HelmSharp.RepoChart 交付

包和 API 选择会进一步解释这些边界,并链接到每个包的生成 API 参考。

接入现有 Chart 前

HelmSharp 在已经实现并测试的范围内遵循 Helm 行为;它不保证任意 Chart 或插件都可原样运行。把某个 Helm 边缘行为作为生产依赖前,请先查看兼容性约定模板函数矩阵

HelmCompare也可用于并排检查输出。

基于 MIT License 发布。