helm

func ActionConfigV3 ¶

func ActionConfigV3(log *zap.Logger, kubeCfg *rest.Config, ns string) (*actionV3.Configuration, error)

func AsRelease ¶ added in v0.19.1243

func AsRelease(rel relapi.Releaser) (*release.Release, error)

AsRelease unwraps a Helm 4.1 action result into the v1 release the rest of the runner reads. Helm returns the same value as an empty interface.

func ChartPathOptions ¶

func ChartPathOptions(repository, chart, version string) (*action.ChartPathOptions, string, error)

func ChartValues ¶

func ChartValues(values []string, helmSet []plantypes.HelmValue, override string) (map[string]interface{}, error)

func CheckResourceAccess ¶ added in v0.19.1243

func CheckResourceAccess(ctx context.Context, kubeCfg *rest.Config, resources []Resource, releaseNamespace string, l *zap.Logger) error

CheckResourceAccess lists each rendered kind in the namespace the chart will use. A forbidden response fails the deploy before Helm mutates the cluster. A missing namespace or a CRD that is not installed yet is skipped: Helm creates those as part of the release.

func Client ¶

func Client(log *zap.Logger, kubeCfg *rest.Config, ns string) (*action.Configuration, error)

func ClientV2 ¶

func ClientV2(log *zap.Logger, kubeCfg *rest.Config, ns string) (*action.Configuration, error)

ClientV2 initializes a new Helm client with the given logger and kube config. NOTE: it doesn't initialise the release store.

func ConfigureDefaultInstall ¶

func ConfigureDefaultInstall(client *action.Install) *action.Install

useful in case we want to configure a client that has already been created NOTE(fd): these default values were yoinked from the runner install code

func ConfigureDefaultRollback ¶ added in v0.19.1126

func ConfigureDefaultRollback(client *action.Rollback) *action.Rollback

func ConfigureDefaultUpgrade ¶

func ConfigureDefaultUpgrade(client *action.Upgrade) *action.Upgrade

func ConfirmUninstalled ¶ added in v0.19.1178

func ConfirmUninstalled(cfg *action.Configuration, name string, uninstallErr error) error

ConfirmUninstalled resolves a failed uninstall against the release store and returns nil only when the release is genuinely gone.

Helm reports "release: not found" both when there was nothing to remove and when a real uninstall got partway through and then failed to purge the release record — a 404 from the storage backend on the record it had just served. The first is success, the second is not, and the error alone cannot tell them apart. Re-reading the release can: if it is still stored, the uninstall did not finish. Anything that is not a not-found error is returned untouched.

func DefaultInstall ¶

func DefaultInstall(actionCfg *action.Configuration) *action.Install

func DefaultRollback ¶ added in v0.19.1126

func DefaultRollback(actionCfg *action.Configuration) *action.Rollback

func DefaultUpgrade ¶

func DefaultUpgrade(actionCfg *action.Configuration) *action.Upgrade

func GetChart ¶

func GetChart(name string, cpo *action.ChartPathOptions, settings *cli.EnvSettings) (*chart.Chart, string, error)

func GetChartByPath ¶

func GetChartByPath(urlOrPath string) (*chart.Chart, error)

func GetManifest ¶

func GetManifest(cfg *action.Configuration, name string) (any, error)

func GetRelease ¶

func GetRelease(cfg *action.Configuration, name string) (*release.Release, error)

func HelmInstallWithLogStreaming ¶

func HelmInstallWithLogStreaming(
	ctx context.Context,
	client *action.Install, chart *chart.Chart, values map[string]interface{},
	kubeCfg *rest.Config,
	resources []Resource,
	l *zap.Logger,
) (*release.Release, error)

func HelmUpgradeWithLogStreaming ¶

func HelmUpgradeWithLogStreaming(
	ctx context.Context,
	client *action.Upgrade, releaseName string, chart *chart.Chart, values map[string]interface{},
	kubeCfg *rest.Config,
	resources []Resource,
	l *zap.Logger,
) (*release.Release, error)

func History ¶ added in v0.19.1126

func History(cfg *action.Configuration, name string) ([]*release.Release, error)

History returns every stored revision of a release, oldest first. A release that was never stored yields an empty history rather than an error, matching GetRelease's treatment of the same condition.

func IsPending ¶ added in v0.19.1126

func IsPending(rel *release.Release) bool

IsPending reports whether a release is parked mid-operation, which helm refuses every further operation on until it is recovered.

func IsReleaseNotFound ¶ added in v0.19.1178

func IsReleaseNotFound(err error) bool

IsReleaseNotFound reports whether err means no such release is stored.

Both forms have to be handled. Helm's own errors keep the sentinel in the chain — including through the joined errors a partially failed uninstall returns — but several paths format it with %s or %v instead of %w, leaving only the message behind.

func LastGoodRevision ¶ added in v0.19.1126

func LastGoodRevision(history []*release.Release) (int, bool)

LastGoodRevision returns the highest revision that finished a rollout. Failed revisions are excluded: returning to one trades a stuck release for a broken one. False means nothing to roll back to, as on a first install.

func LoadEnvSettings ¶

func LoadEnvSettings() (*cli.EnvSettings, error)

func Logger ¶

func Logger(l *zap.Logger) func(string, ...interface{})

func NewLogger ¶

func NewLogger(debugEnabled DebugEnabledFunc) *slog.Logger

NewLogger creates a new logger with dynamic debug checking

func RenderManifest ¶ added in v0.19.1243

func RenderManifest(ch *chart.Chart, values map[string]interface{}, releaseName, namespace string) (string, error)

RenderManifest renders a chart on the client, using the release name and namespace Helm will install into. It does not contact the cluster.

func ResolveChartName ¶

func ResolveChartName(repository, name string) (string, string, error)

resolveChartName returns the proper repository and name values that the ChartPathOptions need. This is copied from Terraform.

func Rollback ¶ added in v0.19.1126

func Rollback(actionCfg *action.Configuration, name string, revision int, timeout time.Duration) error

Rollback returns the release to revision, which must still exist in history. Needs no chart on disk: the SDK rebuilds it from the stored revision.

func ShouldUpgrade ¶ added in v0.19.850

func ShouldUpgrade(rel *release.Release) bool

ShouldUpgrade returns true when a release exists in a state that warrants an upgrade rather than a fresh install. This includes deployed releases as well as failed releases — Helm's upgrade action natively handles upgrading over a failed release.

func TemplateChart ¶ added in v0.19.783

func TemplateChart(chart *chart.Chart, values map[string]interface{}) (string, error)