Documentation
¶
Index ¶
- Constants
- func NewCreator(logger *zap.SugaredLogger, readFile func(string) ([]byte, error), ...) *creator
- type DiffError
- type EnvironmentSpec
- type HelmSpec
- type HelmState
- func (state *HelmState) Clean() []error
- func (state *HelmState) DeleteReleases(helm helmexec.Interface, purge bool) []error
- func (state *HelmState) DiffReleases(helm helmexec.Interface, additionalValues []string, workerLimit int, ...) ([]*ReleaseSpec, []error)
- func (state *HelmState) FilterReleases(labels []string) error
- func (state *HelmState) JoinBase(relPath string) string
- func (state *HelmState) LintReleases(helm helmexec.Interface, additionalValues []string, args []string, ...) []error
- func (state *HelmState) ReleaseStatuses(helm helmexec.Interface, workerLimit int) []error
- func (state *HelmState) RenderValuesFileToBytes(path string) ([]byte, error)
- func (state *HelmState) SyncReleases(helm helmexec.Interface, additionalValues []string, workerLimit int) []error
- func (state *HelmState) SyncRepos(helm helmexec.Interface) []error
- func (state *HelmState) TemplateReleases(helm helmexec.Interface, additionalValues []string, args []string, ...) []error
- func (state *HelmState) TestReleases(helm helmexec.Interface, cleanup bool, timeout int) []error
- func (state *HelmState) UpdateDeps(helm helmexec.Interface) []error
- type LabelFilter
- type ReleaseError
- type ReleaseFilter
- type ReleaseSpec
- type RepositorySpec
- type SetValue
- type StateLoadError
- type UndefinedEnvError
Constants ¶
const DefaultEnv = "default"
Variables ¶
This section is empty.
Functions ¶
func NewCreator ¶ added in v0.33.4
Types ¶
type DiffError ¶ added in v0.32.0
type DiffError struct { *ReleaseSpec Code int // contains filtered or unexported fields }
type EnvironmentSpec ¶ added in v0.28.0
type HelmSpec ¶ added in v0.20.0
type HelmSpec struct { KubeContext string `yaml:"kubeContext"` TillerNamespace string `yaml:"tillerNamespace"` Args []string `yaml:"args"` Verify bool `yaml:"verify"` // Devel, when set to true, use development versions, too. Equivalent to version '>0.0.0-0' Devel bool `yaml:"devel"` // Wait, if set to true, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful Wait bool `yaml:"wait"` // Timeout is the time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks, and waits on pod/pvc/svc/deployment readiness) (default 300) Timeout int `yaml:"timeout"` // RecreatePods, when set to true, instruct helmfile to perform pods restart for the resource if applicable RecreatePods bool `yaml:"recreatePods"` // Force, when set to true, forces resource update through delete/recreate if needed Force bool `yaml:"force"` }
HelmSpec to defines helmDefault values
type HelmState ¶
type HelmState struct { Environments map[string]EnvironmentSpec FilePath string HelmDefaults HelmSpec `yaml:"helmDefaults"` Helmfiles []string `yaml:"helmfiles"` Context string `yaml:"context"` DeprecatedReleases []ReleaseSpec `yaml:"charts"` Namespace string `yaml:"namespace"` Repositories []RepositorySpec `yaml:"repositories"` Releases []ReleaseSpec `yaml:"releases"` // contains filtered or unexported fields }
HelmState structure for the helmfile
func (*HelmState) DeleteReleases ¶
DeleteReleases wrapper for executing helm delete on the releases
func (*HelmState) DiffReleases ¶
func (state *HelmState) DiffReleases(helm helmexec.Interface, additionalValues []string, workerLimit int, detailedExitCode, suppressSecrets bool) ([]*ReleaseSpec, []error)
DiffReleases wrapper for executing helm diff on the releases It returns releases that had any changes
func (*HelmState) FilterReleases ¶
FilterReleases allows for the execution of helm commands against a subset of the releases in the helmfile.
func (*HelmState) JoinBase ¶ added in v0.33.2
JoinBase returns an absolute path in the form basePath/relative
func (*HelmState) LintReleases ¶ added in v0.20.0
func (state *HelmState) LintReleases(helm helmexec.Interface, additionalValues []string, args []string, workerLimit int) []error
LintReleases wrapper for executing helm lint on the releases
func (*HelmState) ReleaseStatuses ¶ added in v0.14.0
func (*HelmState) RenderValuesFileToBytes ¶ added in v0.28.0
func (*HelmState) SyncReleases ¶
func (state *HelmState) SyncReleases(helm helmexec.Interface, additionalValues []string, workerLimit int) []error
SyncReleases wrapper for executing helm upgrade on the releases
func (*HelmState) TemplateReleases ¶ added in v0.31.0
func (state *HelmState) TemplateReleases(helm helmexec.Interface, additionalValues []string, args []string, workerLimit int) []error
TemplateReleases wrapper for executing helm template on the releases
func (*HelmState) TestReleases ¶ added in v0.18.0
TestReleases wrapper for executing helm test on the releases
type LabelFilter ¶
type LabelFilter struct {
// contains filtered or unexported fields
}
LabelFilter matches a release with the given positive lables. Negative labels invert the match for cases such as tier!=backend
func ParseLabels ¶
func ParseLabels(l string) (LabelFilter, error)
ParseLabels takes a label in the form foo=bar,baz!=bat and returns a LabelFilter that will match the labels
func (LabelFilter) Match ¶
func (l LabelFilter) Match(r ReleaseSpec) bool
Match will match a release that has the same labels as the filter
type ReleaseError ¶ added in v0.23.0
type ReleaseError struct { *ReleaseSpec // contains filtered or unexported fields }
func (*ReleaseError) Error ¶ added in v0.23.0
func (e *ReleaseError) Error() string
type ReleaseFilter ¶
type ReleaseFilter interface { // Match returns true if the ReleaseSpec matches the Filter Match(r ReleaseSpec) bool }
ReleaseFilter is used to determine if a given release should be used during helmfile execution
type ReleaseSpec ¶
type ReleaseSpec struct { // Chart is the name of the chart being installed to create this release Chart string `yaml:"chart"` Version string `yaml:"version"` Verify *bool `yaml:"verify"` // Devel, when set to true, use development versions, too. Equivalent to version '>0.0.0-0' Devel *bool `yaml:"devel"` // Wait, if set to true, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful Wait *bool `yaml:"wait"` // Timeout is the time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks, and waits on pod/pvc/svc/deployment readiness) (default 300) Timeout *int `yaml:"timeout"` // RecreatePods, when set to true, instruct helmfile to perform pods restart for the resource if applicable RecreatePods *bool `yaml:"recreatePods"` // Force, when set to true, forces resource update through delete/recreate if needed Force *bool `yaml:"force"` // Name is the name of this release Name string `yaml:"name"` Namespace string `yaml:"namespace"` Labels map[string]string `yaml:"labels"` Values []interface{} `yaml:"values"` Secrets []string `yaml:"secrets"` SetValues []SetValue `yaml:"set"` // The 'env' section is not really necessary any longer, as 'set' would now provide the same functionality EnvValues []SetValue `yaml:"env"` // contains filtered or unexported fields }
ReleaseSpec defines the structure of a helm release
type RepositorySpec ¶
type RepositorySpec struct { Name string `yaml:"name"` URL string `yaml:"url"` CertFile string `yaml:"certFile"` KeyFile string `yaml:"keyFile"` Username string `yaml:"username"` Password string `yaml:"password"` }
RepositorySpec that defines values for a helm repo
type SetValue ¶
type SetValue struct { Name string `yaml:"name"` Value string `yaml:"value"` File string `yaml:"file"` Values []string `yaml:"values"` }
SetValue are the key values to set on a helm release
type StateLoadError ¶ added in v0.32.0
type StateLoadError struct { Cause error // contains filtered or unexported fields }
func (*StateLoadError) Error ¶ added in v0.32.0
func (e *StateLoadError) Error() string
type UndefinedEnvError ¶ added in v0.32.0
type UndefinedEnvError struct {
// contains filtered or unexported fields
}
func (*UndefinedEnvError) Error ¶ added in v0.32.0
func (e *UndefinedEnvError) Error() string