k8s

package

v1.0.15 Latest Latest Go to latest Published: May 3, 2026 License: MIT Imports: 5 Imported by: 0

Details

Package k8s provides a thin wrapper around the Helm CLI for managing nSelf Helm chart deployments (B50).

Status: PLANNED — deferred. Requires UD-12 minor release approval. The nSelf Helm chart lives in charts/nself/ at the repo root.

View Source

const ChartRepo = "https://charts.nself.org"

ChartRepo is the Helm repository URL for the nSelf chart.

View Source

const HelmReleaseName = "nself"

HelmReleaseName is the default Helm release name used by nself k8s install.

View Source

var ErrHelmNotFound = fmt.Errorf("k8s: helm binary not found; install from https://helm.sh")

ErrHelmNotFound is returned when the helm binary is not in PATH.

func Install(ctx context.Context, opts InstallOptions) error

Install runs `helm install` for the nSelf chart.

func RepoAdd(ctx context.Context) error

RepoAdd adds the nSelf Helm repository.

func Status(ctx context.Context, releaseName, kubeconfig string) (string, error)

Status returns the Helm release status summary.

func Upgrade(ctx context.Context, opts InstallOptions) error

Upgrade runs `helm upgrade` for the nSelf chart with rolling update semantics.

type InstallOptions struct {
	ReleaseName string
	Domain      string
	Kubeconfig  string
	LicenseKey  string
	Plugins     []string
}

InstallOptions holds parameters for helm install/upgrade.