helm

Documentation

Index

• Variables
• type Helm
  • func New(spec interface{}, rootDir, scmID string) (Helm, error)
  • func (h Helm) DiscoverManifests() ([][]byte, error)
• type MatchingRule
• type MatchingRules
• type Spec

Variables

var (
	// ChartValidFiles specifies accepted Helm chart metadata filename
	ChartValidFiles [2]string = [2]string{"Chart.yaml", "Chart.yml"}
)

Types

type Helm

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

Helm hold all information needed to generate helm manifest.

func New

func New(spec interface{}, rootDir, scmID string) (Helm, error)

New return a new valid Helm object.

func (Helm) DiscoverManifests

func (h Helm) DiscoverManifests() ([][]byte, error)

type MatchingRule

type MatchingRule struct {
	// Path specifies a Helm chart path pattern, the pattern requires to match all of name, not just a subpart of the path.
	Path string
	// Dependencies specifies a list of dependencies pattern.
	Dependencies map[string]string
	// Containers specifies a list of containers pattern.
	Containers map[string]string
}

MatchingRule allows to specifies rules to identify manifest

type MatchingRules

type MatchingRules []MatchingRule

type Spec

type Spec struct {
	/*
		auths provides a map of registry credentials where the key is the registry URL without scheme
		if empty, updatecli relies on OCI credentials such as the one used by Docker.
	*/
	Auths map[string]docker.InlineKeyChain `yaml:",omitempty"`
	/*
		digest provides a parameter to specify if the generated manifest should use a digest on top of the tag when updating container.
	*/
	Digest *bool `yaml:",omitempty"`
	// ignorecontainer disables OCI container tag update when set to true
	IgnoreContainer bool `yaml:",omitempty"`
	// ignorechartdependency disables Helm chart dependencies update when set to true
	IgnoreChartDependency bool `yaml:",omitempty"`
	// Ignore specifies rule to ignore Helm chart update.
	Ignore MatchingRules `yaml:",omitempty"`
	// rootdir defines the root directory used to recursively search for Helm Chart
	RootDir string `yaml:",omitempty"`
	// only specify required rule(s) to restrict Helm chart update.
	Only MatchingRules `yaml:",omitempty"`
	/*
		versionfilter provides parameters to specify the version pattern used when generating manifest.

		kind - semver
			versionfilter of kind `semver` uses semantic versioning as version filtering
			pattern accepts one of:
				`patch` - patch only update patch version
				`minor` - minor only update minor version
				`major` - major only update major versions
				`a version constraint` such as `>= 1.0.0`

		kind - regex
			versionfilter of kind `regex` uses regular expression as version filtering
			pattern accepts a valid regular expression

		example:
		“`
			versionfilter:
				kind: semver
				pattern: minor
		“`

		and its type like regex, semver, or just latest.
	*/
	VersionFilter version.Filter `yaml:",omitempty"`
	// [target] Defines if a Chart should be packaged or not.
	SkipPackaging bool `yaml:",omitempty"`
	// [target] Defines if a Chart changes, triggers, or not, a Chart version update, accepted values is a comma separated list of "none,major,minor,patch"
	VersionIncrement string `yaml:",omitempty"`
}

Spec defines the Helm parameters.