helm

Documentation

Index

• Variables
• func IsMissingDependencyErr(err error) bool
• func IsVersion(text string) bool
• func Version() (string, error)
• type Client
  • func NewClient(repoURL string, creds Creds) Client
  • func NewClientWithLock(repoURL string, creds Creds, repoLock *util.KeyLock) Client
• type Cmd
  • func NewCmd(workDir string) (*Cmd, error)
  • func NewCmdWithVersion(workDir string, version HelmVer) (*Cmd, error)
  • func (c *Cmd) Close()
  • func (c *Cmd) Fetch(repo, chartName, version, destination string, creds Creds) (string, error)
  • func (c *Cmd) Init() (string, error)
  • func (c *Cmd) RepoAdd(name string, url string, opts Creds) (string, error)
• type Creds
• type Entries
  • func (e Entries) MaxVersion(constraints *semver.Constraints) (*semver.Version, error)
• type Entry
• type Helm
  • func NewHelmApp(workDir string, repos []HelmRepository) (Helm, error)
• type HelmRepository
• type HelmVer
• type Index
  • func (i *Index) GetEntries(chart string) (Entries, error)
• type TemplateOpts

Variables

var (
	// HelmV2 represents helm V2 specific settings
	HelmV2 = HelmVer{
			// contains filtered or unexported fields
	}
	// HelmV3 represents helm V3 specific settings
	HelmV3 = HelmVer{
			// contains filtered or unexported fields
	}
)

Functions

func IsMissingDependencyErr

func IsMissingDependencyErr(err error) bool

IsMissingDependencyErr tests if the error is related to a missing chart dependency

func IsVersion

func IsVersion(text string) bool

func Version

func Version() (string, error)

Types

type Client

type Client interface {
	CleanChartCache(chart string, version *semver.Version) error
	ExtractChart(chart string, version *semver.Version) (string, util.Closer, error)
	GetIndex() (*Index, error)
}

func NewClient

func NewClient(repoURL string, creds Creds) Client

func NewClientWithLock

func NewClientWithLock(repoURL string, creds Creds, repoLock *util.KeyLock) Client

type Cmd

type Cmd struct {
	HelmVer

	WorkDir string
	// contains filtered or unexported fields
}

A thin wrapper around the "helm" command, adding logging and error translation.

func NewCmd

func NewCmd(workDir string) (*Cmd, error)

func NewCmdWithVersion

func NewCmdWithVersion(workDir string, version HelmVer) (*Cmd, error)

func (*Cmd) Close

func (c *Cmd) Close()

func (*Cmd) Fetch

func (c *Cmd) Fetch(repo, chartName, version, destination string, creds Creds) (string, error)

func (*Cmd) Init

func (c *Cmd) Init() (string, error)

func (*Cmd) RepoAdd

func (c *Cmd) RepoAdd(name string, url string, opts Creds) (string, error)

type Creds

type Creds struct {
	Username string
	Password string
	CAPath   string
	CertData []byte
	KeyData  []byte
}

type Entries

type Entries []Entry

func (Entries) MaxVersion

func (e Entries) MaxVersion(constraints *semver.Constraints) (*semver.Version, error)

type Entry

type Entry struct {
	Version string
	Created time.Time
}

type Helm

type Helm interface {
	// Template returns a list of unstructured objects from a `helm template` command
	Template(opts *TemplateOpts) (string, error)
	// GetParameters returns a list of chart parameters taking into account values in provided YAML files.
	GetParameters(valuesFiles []string) (map[string]string, error)
	// DependencyBuild runs `helm dependency build` to download a chart's dependencies
	DependencyBuild() error
	// Init runs `helm init --client-only`
	Init() error
	// Dispose deletes temp resources
	Dispose()
}

Helm provides wrapper functionality around the `helm` command.

func NewHelmApp

func NewHelmApp(workDir string, repos []HelmRepository) (Helm, error)

NewHelmApp create a new wrapper to run commands on the `helm` command-line tool.

type HelmRepository

type HelmRepository struct {
	Creds
	Name string
	Repo string
}

type HelmVer

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

HelmVer contains Helm version specific settings such as helm binary and command names

type Index

type Index struct {
	Entries map[string]Entries
}

func (*Index) GetEntries

func (i *Index) GetEntries(chart string) (Entries, error)

type TemplateOpts

type TemplateOpts struct {
	Name        string
	Namespace   string
	KubeVersion string
	APIVersions []string
	Set         map[string]string
	SetString   map[string]string
	SetFile     map[string]string
	Values      []string
}