releaseinfo

type CachedProvider ¶

type CachedProvider struct {
	Cache map[string]*ReleaseImage
	Inner Provider
	// contains filtered or unexported fields
}

CachedProvider maintains a simple cache of release image info and only queries the embedded provider when there is no cache hit.

func (p *CachedProvider) Lookup(ctx context.Context, image string, pullSecret []byte) (releaseImage *ReleaseImage, err error)

type CincinnatiVersionResolver ¶ added in v0.1.75

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

CincinnatiVersionResolver resolves OpenShift versions to release image pullspecs by querying the Cincinnati graph API (api.openshift.com).

func NewCincinnatiVersionResolver() *CincinnatiVersionResolver

func (r *CincinnatiVersionResolver) Resolve(ctx context.Context, version, channel string) (string, error)

type ComponentVersion ¶

type ComponentVersion struct {
	Version     string
	DisplayName string
}

ComponentVersion includes the version and optional display name.

func (v ComponentVersion) String() string

type ComponentVersions ¶

type ComponentVersions map[string]ComponentVersion

ComponentVersions is a map of component names to semantic versions. Names are lowercase alphanumeric and dashes. Semantic versions will have all build labels removed, but prerelease segments are preserved.

func (v ComponentVersions) DisplayNameLabel() string

func (v ComponentVersions) OrderedKeys() []string

func (v ComponentVersions) String() string

func (v ComponentVersions) VersionLabel() string

type Provider ¶

type Provider interface {
	Lookup(ctx context.Context, image string, pullSecret []byte) (*ReleaseImage, error)
}

Provider knows how to find the release image metadata for an image referred to by its pullspec.

type ProviderWithOpenShiftImageRegistryOverrides ¶ added in v0.1.10

type ProviderWithOpenShiftImageRegistryOverrides interface {
	ProviderWithRegistryOverrides
	GetOpenShiftImageRegistryOverrides() map[string][]string
	GetMirroredReleaseImage() string
}

type ProviderWithOpenShiftImageRegistryOverridesDecorator ¶ added in v0.1.10

type ProviderWithOpenShiftImageRegistryOverridesDecorator struct {
	Delegate                        ProviderWithRegistryOverrides
	OpenShiftImageRegistryOverrides map[string][]string
	// contains filtered or unexported fields
}

func (p *ProviderWithOpenShiftImageRegistryOverridesDecorator) GetMirroredReleaseImage() string

func (p *ProviderWithOpenShiftImageRegistryOverridesDecorator) GetOpenShiftImageRegistryOverrides() map[string][]string

func (p *ProviderWithOpenShiftImageRegistryOverridesDecorator) GetRegistryOverrides() map[string]string

func (p *ProviderWithOpenShiftImageRegistryOverridesDecorator) Lookup(ctx context.Context, image string, pullSecret []byte) (*ReleaseImage, error)

type ProviderWithRegistryOverrides ¶

type ProviderWithRegistryOverrides interface {
	Provider
	GetRegistryOverrides() map[string]string
}

type RegistryClientProvider ¶

type RegistryClientProvider struct {
}

RegistryClientProvider uses a registry client to directly stream image content and extract image metadata.

func (p *RegistryClientProvider) Lookup(ctx context.Context, image string, pullSecret []byte) (releaseImage *ReleaseImage, err error)

type RegistryMirrorProviderDecorator ¶

type RegistryMirrorProviderDecorator struct {
	Delegate Provider
	// RegistryOverrides contains the source registry string as a key and the destination registry string as value.
	// images before being applied are scanned for the source registry string and if found the string is replaced with
	// the destination registry string. This allows hypershift to run in non-crio environments where mirroring is not
	// applicable.
	RegistryOverrides map[string]string
	// contains filtered or unexported fields
}

RegistryMirrorProviderDecorator decorates another Provider to add user-specified component name to image mappings. The Lookup implementation will first delegate to the given Delegate, and will then add additional TagReferences to the Delegate's results based on the ComponentImages.

func (p *RegistryMirrorProviderDecorator) GetRegistryOverrides() map[string]string

func (p *RegistryMirrorProviderDecorator) Lookup(ctx context.Context, image string, pullSecret []byte) (*ReleaseImage, error)

type ReleaseImage ¶

type ReleaseImage struct {
	*imageapi.ImageStream `json:",inline"`
	StreamMetadata        *stream.Stream `json:"streamMetadata"`
	// OSStreams holds per-stream metadata parsed from the ConfigMap "streams" key.
	// Nil for single-stream payloads (OCP < 5.0).
	OSStreams map[string]*stream.Stream `json:"-"`
}

ReleaseImage wraps an ImageStream with some utilities that help the user discover constituent component image information.

func (i *ReleaseImage) ComponentImages() map[string]string

func (i *ReleaseImage) ComponentVersions() (map[string]string, error)

func (i *ReleaseImage) StreamForName(name string) (*stream.Stream, error)

func (i *ReleaseImage) Version() string

type StaticProviderDecorator ¶

type StaticProviderDecorator struct {
	Delegate        Provider
	ComponentImages map[string]string
	// contains filtered or unexported fields
}

StaticProviderDecorator decorates another Provider to add user-specified component name to image mappings. The Lookup implementation will first delegate to the given Delegate, and will then add additional TagReferences to the Delegate's results based on the ComponentImages.

func (p *StaticProviderDecorator) Lookup(ctx context.Context, image string, pullSecret []byte) (*ReleaseImage, error)

type VersionResolver ¶ added in v0.1.75

type VersionResolver interface {
	// Resolve resolves a version to a release image pullspec using the given Cincinnati channel.
	// The channel should be the full Cincinnati channel string (e.g., "stable-4.20").
	Resolve(ctx context.Context, version, channel string) (string, error)
}

VersionResolver resolves an OpenShift version string to a release image pullspec.