helm

package
v0.5.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 25, 2026 License: Apache-2.0 Imports: 37 Imported by: 0

Documentation

Overview

Package helm generates Helm charts from Deployah specs and drives install, upgrade, list, and delete operations against a cluster.

PrepareChart renders templates and values for an environment. Client wraps Helm v4 actions with Deployah-specific release naming, labels, and caching through ChartCache.

Index

Constants

View Source 
const (
	// ChartNameTemplate is the template for generated chart names
	ChartNameTemplate = "%s-%s"

	// ReleaseNameTemplate is the template for Helm release names
	ReleaseNameTemplate = "%s-%s"

	// TempChartPrefix is the prefix for temporary chart directories
	TempChartPrefix = "deployah-chart-"

	// ChartYamlTemplate is the template file name for Chart.yaml
	ChartYamlTemplate = "Chart.yaml.gotmpl"

	// ValuesYamlFile is the name of the values file
	ValuesYamlFile = "values.yaml"
)

Chart and Template Constants

Variables

View Source 
var (
	// ErrClusterUnreachable is returned when the Kubernetes cluster cannot be reached.
	ErrClusterUnreachable = errors.New("kubernetes cluster unreachable")
	// ErrReleaseNotFound is returned when a Helm release does not exist.
	ErrReleaseNotFound = errors.New("release not found")
	// ErrReleaseAlreadyExists is returned when a Helm release already exists.
	ErrReleaseAlreadyExists = errors.New("release already exists")
	// ErrReleasePending is returned when a Helm release has an operation in progress.
	ErrReleasePending = errors.New("another operation is in progress")
)
View Source 
var ChartTemplateFS embed.FS

ChartTemplateFS embeds the chart directory. Underscore-prefixed templates were renamed so directory embedding includes them without explicit listing.

Functions

func CleanupExpiredCharts 

func CleanupExpiredCharts()

CleanupExpiredCharts removes expired chart cache entries

func ClearChartCache 

func ClearChartCache() error

ClearChartCache clears all cached charts and removes their directories

func CreateChartCopy 

func CreateChartCopy(sourcePath string) (string, error)

CreateChartCopy creates a copy of a cached chart directory to avoid conflicts

func GenerateCacheKey 

func GenerateCacheKey(manifest *spec.Spec, environment string, resolved *spec.ResolvedSpec) (string, error)

GenerateCacheKey creates a cache key from the resolved spec (or raw spec when resolved is nil), the target environment, and the embedded chart template hash.

environment must be part of the key: PrepareChart bakes the environment-filtered component set and environment label into the cached chart's values.yaml, so rendering environment A then B for the same manifest must not reuse A's cached chart for B.

When resolved is non-nil it is hashed instead of the full raw spec: this covers only the target-environment subset and ensures platform file changes invalidate the cache. encoding/json sorts map keys deterministically since Go 1.12, so the serialization is stable.

func GenerateReleaseName 

func GenerateReleaseName(projectName, environmentName string) string

GenerateReleaseName returns the Helm release name for project and environment. Format: PROJECT_NAME-ENVIRONMENT_NAME.

func GetCachedChart 

func GetCachedChart(cacheKey string) (string, bool)

GetCachedChart retrieves a cached chart if it exists and is valid

func GetChartCacheStats 

func GetChartCacheStats() (count int, totalSize int64)

GetChartCacheStats returns statistics about the chart cache

func MapSpecToChartValues added in v0.3.0 

func MapSpecToChartValues(m *spec.Spec, desiredEnvironment string, resolved *spec.ResolvedSpec) (map[string]any, error)

MapSpecToChartValues converts a spec into Helm chart values for the given environment (resolved, if non-nil, supplies FQDN/TLS) and writes a deployah.resolved block so the hostname guard can compare across deploys.

func PrepareChart 

func PrepareChart(ctx context.Context, manifest *spec.Spec, desiredEnvironment string, resolved *spec.ResolvedSpec) (string, error)

PrepareChart expands the embedded chart into a temporary directory, rendering .gotmpl files with Go templates and Sprig functions, and returns the prepared chart root directory (cached across calls for identical charts).

func SetCachedChart 

func SetCachedChart(cacheKey, chartPath string)

SetCachedChart stores a chart path in the cache

Types

type ChartCache 

type ChartCache struct {
	Path      string
	CreatedAt time.Time
}

ChartCache represents a cached chart entry

type ChartCacheInfo 

type ChartCacheInfo struct {
	Count     int      `json:"count"`
	TotalSize int64    `json:"totalSize"`
	ChartHash string   `json:"chartHash"`
	TTL       string   `json:"ttl"`
	CacheKeys []string `json:"cacheKeys,omitempty"`
}

ChartCacheInfo provides detailed information about the chart cache

func GetChartCacheInfo 

func GetChartCacheInfo() (*ChartCacheInfo, error)

GetChartCacheInfo returns detailed information about the chart cache

type ChartData 

type ChartData struct {
	// Chart holds metadata rendered into Chart.yaml.
	Chart struct {
		Name        string
		Description string
		Version     string
		AppVersion  string
	}
	// Values is the data map for values.yaml templating.
	Values map[string]any
	// Spec is the source Deployah spec for dynamic sub-charts.
	Spec *spec.Spec
}

ChartData holds values substituted in Helm chart templates.

type Client 

type Client struct {
	// contains filtered or unexported fields
}

Client wraps Helm action configuration for Deployah operations.

func NewClient 

func NewClient(opts ...Option) (*Client, error)

NewClient initializes Helm action configuration with functional options. Default storage driver is "secret" if not specified. Default timeout is 5 minutes if not specified.

func (*Client) DeleteRelease 

func (c *Client) DeleteRelease(ctx context.Context, project, environment string, wait bool) error

DeleteRelease uninstalls the given release. When wait is false (the default) it returns right after hooks complete, matching vanilla `helm uninstall`. When wait is true it blocks until all resources are removed, via the legacy polling strategy with foreground cascade deletion -- StatusWatcherStrategy is avoided here because it can report cluster-scoped resources as Terminating forever after Kubernetes already deleted them (helm/helm#31766).

func (*Client) GetRelease 

func (c *Client) GetRelease(ctx context.Context, project, environment string) (*v1.Release, error)

GetRelease retrieves a release by project and environment.

func (*Client) GetReleaseHistory 

func (c *Client) GetReleaseHistory(ctx context.Context, project, environment string) ([]*v1.Release, error)

GetReleaseHistory returns the history of a specific release.

func (*Client) InstallApp 

func (c *Client) InstallApp(ctx context.Context, manifest *spec.Spec, environment string, dryRun bool, resolved *spec.ResolvedSpec, postRenderer postrenderer.PostRenderer) error

InstallApp installs or upgrades the app using the embedded chart, using resolved (if non-nil) for platform-resolved FQDN/TLS values. When dryRun is true, it renders client-side via Client.RenderManifests instead of touching the cluster. postRenderer, when non-nil, is applied to rendered manifests before they are installed or upgraded.

func (*Client) IsReachable 

func (c *Client) IsReachable() error

IsReachable reports whether the configured Kubernetes cluster is reachable. Also works around helm/helm#32183: Helm v4.2.0 panics on a second IsReachable call after the first one fails (typed-nil cached in getKubeClient), so calling this once before InstallApp keeps InstallApp from ever hitting that second call against a poisoned client.

func (*Client) ListReleases 

func (c *Client) ListReleases(ctx context.Context, selector labels.Selector) ([]*v1.Release, error)

ListReleases returns release details in the current namespace.

func (*Client) Namespace added in v0.5.0 

func (c *Client) Namespace() string

Namespace returns the release namespace Helm will use for installs and offline renders (from WithNamespace, HELM_NAMESPACE, or the kubeconfig context default).

func (*Client) RenderManifests added in v0.4.0 

func (c *Client) RenderManifests(ctx context.Context, manifest *spec.Spec, environment string, resolved *spec.ResolvedSpec, postRenderer postrenderer.PostRenderer) (result *render.RenderResult, cleanup func(), err error)

RenderManifests renders the chart via Helm's DryRunClient strategy, so hooks/templates see the same values, capabilities, and revision as a real apply. It mirrors InstallApp's install-vs-upgrade decision so the result compares 1:1 with what InstallApp would produce, but on an upgrade this means it also performs InstallApp's cluster-reachability check (skipped only for a fresh install).

Callers must invoke the returned cleanup func; ChartPath is not removed automatically so callers like deploy can reuse it for the real apply.

func (*Client) RenderOffline added in v0.4.0 

func (c *Client) RenderOffline(ctx context.Context, manifest *spec.Spec, environment string, resolved *spec.ResolvedSpec, postRenderer postrenderer.PostRenderer) (result *render.RenderResult, cleanup func(), err error)

RenderOffline renders the chart for manifest/environment as a fresh install, without any Kubernetes API access: no reachability check and no release-history lookup. It is the engine behind `deployah plan --offline`. Because it never looks at release history, the result always describes a fresh install (IsUpgrade false, Revision 1) even when a release already exists, so it can't be diffed against a prior release like Client.RenderManifests can; use that instead when cluster access is fine.

func (*Client) RollbackRelease 

func (c *Client) RollbackRelease(ctx context.Context, releaseName string, revision int, timeout time.Duration) error

RollbackRelease rolls back a release to a previous revision.

type Option 

type Option func(*Client)

Option is a functional option for configuring the Helm client

func WithDebug 

func WithDebug(keep bool) Option

WithDebug controls whether to keep temporary chart directories.

func WithExtraKubeconfigPaths 

func WithExtraKubeconfigPaths(paths ...string) Option

WithExtraKubeconfigPaths appends additional kubeconfig file paths so their contexts are available alongside the default kubeconfig. This is ignored when WithKubeconfig is also set, because an explicit path takes full precedence and makes extra paths redundant.

func WithKubeContext 

func WithKubeContext(kubeContext string) Option

WithKubeContext sets the Kubernetes context to use, overriding the kubeconfig's current context.

func WithKubeconfig 

func WithKubeconfig(kubeconfig string) Option

WithKubeconfig sets the path to the kubeconfig file

func WithNamespace 

func WithNamespace(namespace string) Option

WithNamespace sets the Kubernetes namespace for Helm operations

func WithStorageDriver 

func WithStorageDriver(driver string) Option

WithStorageDriver sets the Helm storage driver (secret, configmap, or memory)

func WithTimeout 

func WithTimeout(timeout time.Duration) Option

WithTimeout sets the default timeout for Helm operations

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.