helm

Documentation

Overview

Package helm resolves Helm chart versions from both classic HTTP chart repositories (an index.yaml served under the repo URL) and OCI registries (oci://, where a chart's versions are the repository's tags). The OCI path reuses the shared internal/oci client; the classic path parses the index for versions, release dates, and the chart-tarball digest.

Index

• type Option
  • func WithKeychain(kc authn.Keychain) Option
  • func WithTransport(rt http.RoundTripper) Option
• type Provider
  • func New(opts ...Option) *Provider
  • func (p *Provider) Dated()
  • func (p *Provider) Describe(r provider.Resource) string
  • func (p *Provider) Digest(ctx context.Context, r provider.Resource, tag string) (string, error)
  • func (p *Provider) Discover(ctx context.Context, r provider.Resource) ([]model.Candidate, error)
  • func (p *Provider) Keys() []provider.Key
  • func (p *Provider) Name() string
  • func (p *Provider) Resource(d directive.Directive) (provider.Resource, error)

Types

type Option

type Option func(*Provider)

Option configures a Provider.

func WithKeychain

func WithKeychain(kc authn.Keychain) Option

WithKeychain overrides the credential keychain, for tests.

func WithTransport

func WithTransport(rt http.RoundTripper) Option

WithTransport overrides the HTTP transport, for tests.

type Provider

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

Provider resolves Helm chart versions. A classic https:// repository is read from its index.yaml; an oci:// registry lists the chart's tags through the shared OCI client. The OCI protocol and the classic index fetch share one cached, rate-limited HTTP client across a run.

func New

func New(opts ...Option) *Provider

New returns the Helm provider, defaulting to the keychain that reads the user's existing docker/helm login so clover piggybacks on credentials already stored for OCI chart registries.

func (*Provider) Dated

func (p *Provider) Dated()

Dated marks the listing as date-bearing: the classic index carries release dates. OCI tags do not, and fall to the post-discovery date check.

func (*Provider) Describe

func (p *Provider) Describe(r provider.Resource) string

Describe returns a human-readable label for a resource.

func (*Provider) Digest

func (p *Provider) Digest(ctx context.Context, r provider.Resource, tag string) (string, error)

Digest resolves the content digest a chart tag points at, for digest-pinned rewriting. It is available only for oci:// charts; a classic repository already exposes the chart-tarball digest as an asset on each candidate.

func (*Provider) Discover

func (p *Provider) Discover(ctx context.Context, r provider.Resource) ([]model.Candidate, error)

Discover lists candidate versions for a chart, reading a classic repository's index.yaml or an OCI registry's tags.

func (*Provider) Keys

func (p *Provider) Keys() []provider.Key

Keys reports the directive keys helm accepts, in canonical order.

func (*Provider) Name

func (p *Provider) Name() string

Name identifies the provider.

func (*Provider) Resource

func (p *Provider) Resource(d directive.Directive) (provider.Resource, error)

Resource validates a directive into a Helm resource.