packages

Documentation

Index

• Constants
• type Files
• type Group
• type Groups
• type OperatorFile
• type Package
  • func (p Package) AppVersionString() string
  • func (p Package) OperatorName() string
  • func (p Package) OperatorVersionString() string
• type Parameter
  • func (p *Parameter) EnumValues() []interface{}
  • func (p *Parameter) HasDefault() bool
  • func (p Parameter) IsAdvanced() bool
  • func (p Parameter) IsEnum() bool
  • func (p Parameter) IsImmutable() bool
  • func (p Parameter) IsRequired() bool
  • func (p *Parameter) ValidateDefault() error
• type Parameters
  • func (p Parameters) Len() int
  • func (p Parameters) Less(x, y int) bool
  • func (p Parameters) Swap(i, j int)
• type ParamsFile
• type Resources
• type Templates
• type Verifier

Constants

const (
	APIVersion = "kudo.dev/v1beta1"
)

Types

type Files

type Files struct {
	Templates Templates
	Operator  *OperatorFile
	Params    *ParamsFile
}

Files represents the raw operator package format the way it is found in the tgz packages

type Group

type Group struct {
	Name        string `json:"name,omitempty"`
	DisplayName string `json:"displayName,omitempty"`
	Description string `json:"description,omitempty"`
	Priority    int    `json:"prio,omitempty"`
}

type Groups

type Groups []Group

type OperatorFile

type OperatorFile struct {
	APIVersion        string                  `json:"apiVersion,omitempty"`
	Name              string                  `json:"name"`
	Description       string                  `json:"description,omitempty"`
	OperatorVersion   string                  `json:"operatorVersion"`
	AppVersion        string                  `json:"appVersion,omitempty"`
	KUDOVersion       string                  `json:"kudoVersion,omitempty"`
	KubernetesVersion string                  `json:"kubernetesVersion,omitempty"`
	Maintainers       []*kudoapi.Maintainer   `json:"maintainers,omitempty"`
	URL               string                  `json:"url,omitempty"`
	Tasks             []kudoapi.Task          `json:"tasks"`
	Plans             map[string]kudoapi.Plan `json:"plans"`
	NamespaceManifest string                  `json:"namespaceManifest,omitempty"`
}

OperatorFile is a representation of the package operator.yaml

type Package

type Package struct {
	// transformed server view
	Resources *Resources
	// working with local package files
	Files *Files
}

Package is an abstraction of the collection of files that makes up a package. It is anything we can retrieve the Resources from.

func (Package) AppVersionString

func (p Package) AppVersionString() string

func (Package) OperatorName

func (p Package) OperatorName() string

func (Package) OperatorVersionString

func (p Package) OperatorVersionString() string

type Parameter

type Parameter struct {
	DisplayName string                `json:"displayName,omitempty"`
	Name        string                `json:"name,omitempty"`
	Description string                `json:"description,omitempty"`
	Required    *bool                 `json:"required,omitempty"`
	Default     interface{}           `json:"default,omitempty"`
	Trigger     string                `json:"trigger,omitempty"`
	Type        kudoapi.ParameterType `json:"type,omitempty"`
	Immutable   *bool                 `json:"immutable,omitempty"`
	Enum        *[]interface{}        `json:"enum,omitempty"`

	// The following fields are descriptive only and are not used in the OperatorVersion. They are only used on the
	// package level and are not converted to the CRDs, as they are only used during installation of an operator and
	// are not necessary server-side.
	Group    string `json:"group,omitempty"`
	Advanced *bool  `json:"advanced,omitempty"`
	Hint     string `json:"hint,omitempty"`
}

Modified kudoapi.Parameter that allows for defaults provided as YAML.

func (*Parameter) EnumValues

func (p *Parameter) EnumValues() []interface{}

func (*Parameter) HasDefault

func (p *Parameter) HasDefault() bool

func (Parameter) IsAdvanced

func (p Parameter) IsAdvanced() bool

func (Parameter) IsEnum

func (p Parameter) IsEnum() bool

func (Parameter) IsImmutable

func (p Parameter) IsImmutable() bool

func (Parameter) IsRequired

func (p Parameter) IsRequired() bool

func (*Parameter) ValidateDefault

func (p *Parameter) ValidateDefault() error

type Parameters

type Parameters []Parameter

func (Parameters) Len

func (p Parameters) Len() int

Len returns the number of params. This is needed to allow sorting of params.

func (Parameters) Less

func (p Parameters) Less(x, y int) bool

Less returns true if the name of a param a is less than the name of param b. This is needed to allow sorting of params.

func (Parameters) Swap

func (p Parameters) Swap(i, j int)

Swap swaps the position of two items in the params slice. This is needed to allow sorting of params.

type ParamsFile

type ParamsFile struct {
	APIVersion string     `json:"apiVersion,omitempty"`
	Groups     Groups     `json:"groups,omitempty"`
	Parameters Parameters `json:"parameters"`
}

ParamsFile is a representation of the package params.yaml

type Resources

type Resources struct {
	Operator        *kudoapi.Operator
	OperatorVersion *kudoapi.OperatorVersion
	Instance        *kudoapi.Instance
}

Resources is collection of CRDs that are used when installing operator during installation, package format is converted to this structure

type Templates

type Templates map[string]string

Templates is a map of file names and stringified files in the template folder of an operator

type Verifier

type Verifier interface {
	Verify(pf *Files) verifier.Result
}

Verifier defines the interface for all parameter verifiers