relativeociref

package
v0.13.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 5, 2024 License: Apache-2.0 Imports: 6 Imported by: 0

README

Access Method relativeOciReference - OCI Artifact Access in OCI-registry-based OCM Repository

Synopsis
type: relativeOciReference/v1

Provided blobs use the following media type:

  • application/vnd.oci.image.manifest.v1+tar+gzip: OCI image manifests
  • application/vnd.oci.image.index.v1+tar.gzip: OCI index manifests

Depending on the repository appropriate docker legacy types might be used.

The artifact content is provided in the Artifact Set Format. The tag is provided as annotation.

Description

This method implements the access of an OCI artifact stored in an OCI registry, which is used to host the OCM repository the component version is retrieved from.

It works similar to the ociArtifact access method, but the used reference does not contain the OCI registry host, which is taken from the OCI registry used to host the component version containing the access specification.

Supported specification version is v1

Specification Versions

This access method is a legacy access method formerly used to enable physical replication of OCI registry content together with referenced OCI artifacts.

This should basically be done by a value transport of the component versions, because it is a special case for OCI artifacts stored together with component versions in the same OCI registry.

Version v1

The type specific specification fields are:

  • reference string

    OCI image/artifact reference following the OCI schemes to describe an arifact inside an OCI registry (OCI reference without the host part):

    • <artifact>:<digest>@<tag>
    • <repo path>/<artifact>:<version>@<tag>
Go Bindings

The go binding can be found here

Documentation

Index

Constants

View Source
const (
	Type   = "relativeOciReference"
	TypeV1 = Type + runtime.VersionSeparator + "v1"
)

Type describes the access of an OCI artifact stored as OCI artifact in the OCI registry hosting the actual component version.

Variables

This section is empty.

Functions

This section is empty.

Types

type AccessSpec

type AccessSpec struct {
	runtime.ObjectVersionedType `json:",inline"`
	// Reference is the OCI repository name and version separated by a colon.
	Reference string `json:"reference"`
}

AccessSpec describes the access of an OCI artifact stored as OCI artifact in the OCI registry hosting the actual component version.

func New

func New(ref string) *AccessSpec

New creates a new localFilesystemBlob accessor.

func (*AccessSpec) AccessMethod

func (*AccessSpec) Describe

func (a *AccessSpec) Describe(context accspeccpi.Context) string

func (*AccessSpec) GetDigest

func (a *AccessSpec) GetDigest() (string, bool)

func (*AccessSpec) GetOCIReference added in v0.5.0

func (a *AccessSpec) GetOCIReference(cv accspeccpi.ComponentVersionAccess) (string, error)

func (*AccessSpec) GetReferenceHint

func (a *AccessSpec) GetReferenceHint(cv internal.ComponentVersionAccess) string

func (*AccessSpec) GlobalAccessSpec

func (a *AccessSpec) GlobalAccessSpec(context accspeccpi.Context) accspeccpi.AccessSpec

func (*AccessSpec) IsLocal

func (a *AccessSpec) IsLocal(context accspeccpi.Context) bool

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL