package storage

import "helm.sh/helm/v3/pkg/storage"

Index

Constants

const HelmStorageType = "sh.helm.release.v1"

HelmStorageType is the type field of the Kubernetes storage object which stores the Helm release version. It is modified slightly replacing the '/': sh.helm/release.v1 Note: The version 'v1' is incremented if the release object metadata is modified between major releases. This constant is used as a prefix for the Kubernetes storage object name.

Types

type Storage

type Storage struct {
	driver.Driver

	// MaxHistory specifies the maximum number of historical releases that will
	// be retained, including the most recent release. Values of 0 or less are
	// ignored (meaning no limits are imposed).
	MaxHistory int

	Log func(string, ...interface{})
}

Storage represents a storage engine for a Release.

func Init

func Init(d driver.Driver) *Storage

Init initializes a new storage backend with the driver d. If d is nil, the default in-memory driver is used.

func (*Storage) Create

func (s *Storage) Create(rls *rspb.Release) error

Create creates a new storage entry holding the release. An error is returned if the storage driver fails to store the release, or a release with an identical key already exists.

func (*Storage) Delete

func (s *Storage) Delete(name string, version int) (*rspb.Release, error)

Delete deletes the release from storage. An error is returned if the storage backend fails to delete the release or if the release does not exist.

func (*Storage) Deployed

func (s *Storage) Deployed(name string) (*rspb.Release, error)

Deployed returns the last deployed release with the provided release name, or returns driver.NewErrNoDeployedReleases if not found.

func (*Storage) DeployedAll

func (s *Storage) DeployedAll(name string) ([]*rspb.Release, error)

DeployedAll returns all deployed releases with the provided name, or returns driver.NewErrNoDeployedReleases if not found.

func (*Storage) Get

func (s *Storage) Get(name string, version int) (*rspb.Release, error)

Get retrieves the release from storage. An error is returned if the storage driver failed to fetch the release, or the release identified by the key, version pair does not exist.

func (*Storage) History

func (s *Storage) History(name string) ([]*rspb.Release, error)

History returns the revision history for the release with the provided name, or returns driver.ErrReleaseNotFound if no such release name exists.

func (*Storage) Last

func (s *Storage) Last(name string) (*rspb.Release, error)

Last fetches the last revision of the named release.

func (*Storage) ListDeployed

func (s *Storage) ListDeployed() ([]*rspb.Release, error)

ListDeployed returns all releases with Status == DEPLOYED. An error is returned if the storage backend fails to retrieve the releases.

func (*Storage) ListReleases

func (s *Storage) ListReleases() ([]*rspb.Release, error)

ListReleases returns all releases from storage. An error is returned if the storage backend fails to retrieve the releases.

func (*Storage) ListUninstalled

func (s *Storage) ListUninstalled() ([]*rspb.Release, error)

ListUninstalled returns all releases with Status == UNINSTALLED. An error is returned if the storage backend fails to retrieve the releases.

func (*Storage) Update

func (s *Storage) Update(rls *rspb.Release) error

Update updates the release in storage. An error is returned if the storage backend fails to update the release or if the release does not exist.

Source Files

storage.go

Directories

PathSynopsis
pkg/storage/driver
Version
v3.17.3 (latest)
Published
Apr 9, 2025
Platform
linux/amd64
Imports
6 packages
Last checked
1 month ago

Tools for package owners.