packages

Documentation

Index

• func CreateTarball(fs afero.Fs, path string, destination string, overwrite bool) (target string, err error)
• func Untar(fs afero.Fs, path string, r io.Reader) (err error)
• type Operator
• type Package
  • func NewFromBytes(buf *bytes.Buffer) Package
  • func ReadPackage(fs afero.Fs, path string) (Package, error)
• type PackageCRDs
• type PackageFiles
• type PackageFilesDigest
  • func GetFilesDigest(fs afero.Fs, paths []string) []*PackageFilesDigest

Functions

func CreateTarball

func CreateTarball(fs afero.Fs, path string, destination string, overwrite bool) (target string, err error)

CreateTarball takes a path to operator files and creates a tgz of those files with the destination and name provided

func Untar

func Untar(fs afero.Fs, path string, r io.Reader) (err error)

Untar takes a destination path and a reader; a tar reader loops over the tarfile creating the file structure at 'path' along the way, and writing any files

Types

type Operator

type Operator struct {
	Name              string                       `json:"name"`
	Description       string                       `json:"description,omitempty"`
	Version           string                       `json:"version"`
	AppVersion        string                       `json:"appVersion,omitempty"`
	KUDOVersion       string                       `json:"kudoVersion,omitempty"`
	KubernetesVersion string                       `json:"kubernetesVersion,omitempty"`
	Maintainers       []*v1alpha1.Maintainer       `json:"maintainers,omitempty"`
	URL               string                       `json:"url,omitempty"`
	Tasks             map[string]v1alpha1.TaskSpec `json:"tasks"`
	Plans             map[string]v1alpha1.Plan     `json:"plans"`
}

Operator is a representation of the KEP-9 Operator YAML

type Package

type Package interface {
	// transformed server view
	GetCRDs() (*PackageCRDs, error)
	// working with local package files
	GetPkgFiles() (*PackageFiles, error)
}

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

func NewFromBytes

func NewFromBytes(buf *bytes.Buffer) Package

NewFromBytes creates a package from a byte Buffer

func ReadPackage

func ReadPackage(fs afero.Fs, path string) (Package, error)

ReadPackage creates the implementation of the packages based on the path. The expectation is the packages is always local . The path can be relative or absolute location of the packages.

type PackageCRDs

type PackageCRDs struct {
	Operator        *v1alpha1.Operator
	OperatorVersion *v1alpha1.OperatorVersion
	Instance        *v1alpha1.Instance
}

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

type PackageFiles

type PackageFiles struct {
	Templates map[string]string
	Operator  *Operator
	Params    []v1alpha1.Parameter
}

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

type PackageFilesDigest

type PackageFilesDigest struct {
	PkgFiles *PackageFiles
	Digest   string
}

PackageFilesDigest is a tuple of data used to return the package files AND the digest of a tarball

func GetFilesDigest

func GetFilesDigest(fs afero.Fs, paths []string) []*PackageFilesDigest

GetFilesDigest maps []string of paths to the [] Operators