packager

Documentation

Overview

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Package packager contains functions for interacting with, managing and deploying Zarf packages.

Index

• type Modifier
  • func WithCluster(cluster *cluster.Cluster) Modifier
  • func WithSource(source sources.PackageSource) Modifier
  • func WithTemp(base string) Modifier
• type Packager
  • func New(cfg *types.PackagerConfig, mods ...Modifier) (*Packager, error)
  • func NewOrDie(config *types.PackagerConfig, mods ...Modifier) *Packager
  • func (p *Packager) ClearTempPaths()
  • func (p *Packager) Create(ctx context.Context) (err error)
  • func (p *Packager) Deploy(ctx context.Context) (err error)
  • func (p *Packager) DevDeploy(ctx context.Context) error
  • func (p *Packager) FindImages(ctx context.Context) (imgMap map[string][]string, err error)
  • func (p *Packager) Generate() (err error)
  • func (p *Packager) GetVariableConfig() *variables.VariableConfig
  • func (p *Packager) Inspect(ctx context.Context) (err error)
  • func (p *Packager) Mirror(ctx context.Context) (err error)
  • func (p *Packager) Publish(ctx context.Context) (err error)
  • func (p *Packager) Pull(ctx context.Context) (err error)
  • func (p *Packager) Remove(ctx context.Context) (err error)

Types

type Modifier

type Modifier func(*Packager)

Modifier is a function that modifies the packager.

func WithCluster

func WithCluster(cluster *cluster.Cluster) Modifier

WithCluster sets the cluster client for the packager.

func WithSource

func WithSource(source sources.PackageSource) Modifier

WithSource sets the source for the packager.

func WithTemp

func WithTemp(base string) Modifier

WithTemp sets the temp directory for the packager.

This temp directory is used as the destination where p.source loads the package.

type Packager

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

Packager is the main struct for managing packages.

func New

func New(cfg *types.PackagerConfig, mods ...Modifier) (*Packager, error)

New creates a new package instance with the provided config.

Note: This function creates a tmp directory that should be cleaned up with p.ClearTempPaths().

func NewOrDie

func NewOrDie(config *types.PackagerConfig, mods ...Modifier) *Packager

NewOrDie creates a new package instance with the provided config or throws a fatal error.

Note: This function creates a tmp directory that should be cleaned up with p.ClearTempPaths().

func (*Packager) ClearTempPaths

func (p *Packager) ClearTempPaths()

ClearTempPaths removes the temp directory and any files within it.

func (*Packager) Create

func (p *Packager) Create(ctx context.Context) (err error)

Create generates a Zarf package tarball for a given PackageConfig and optional base directory.

func (*Packager) Deploy

func (p *Packager) Deploy(ctx context.Context) (err error)

Deploy attempts to deploy the given PackageConfig.

func (*Packager) DevDeploy

func (p *Packager) DevDeploy(ctx context.Context) error

DevDeploy creates + deploys a package in one shot

func (*Packager) FindImages

func (p *Packager) FindImages(ctx context.Context) (imgMap map[string][]string, err error)

FindImages iterates over a Zarf.yaml and attempts to parse any images.

func (*Packager) Generate

func (p *Packager) Generate() (err error)

Generate generates a Zarf package definition.

func (*Packager) GetVariableConfig

func (p *Packager) GetVariableConfig() *variables.VariableConfig

GetVariableConfig returns the variable configuration for the packager.

func (*Packager) Inspect

func (p *Packager) Inspect(ctx context.Context) (err error)

Inspect list the contents of a package.

func (*Packager) Mirror

func (p *Packager) Mirror(ctx context.Context) (err error)

Mirror pulls resources from a package (images, git repositories, etc) and pushes them to remotes in the air gap without deploying them

func (*Packager) Publish

func (p *Packager) Publish(ctx context.Context) (err error)

Publish publishes the package to a registry

func (*Packager) Pull

func (p *Packager) Pull(ctx context.Context) (err error)

Pull pulls a Zarf package and saves it as a compressed tarball.

func (*Packager) Remove

func (p *Packager) Remove(ctx context.Context) (err error)

Remove removes a package that was already deployed onto a cluster, uninstalling all installed helm charts.