registry

Documentation

Index

• func GetCertificates(certFile string) (certificates *x509.CertPool, err error)
• func PullBytes(ctx context.Context, sc StorageClient, artifact Artifact) (data []byte, err error)
• type Artifact
  • func NewArtifact(registry, repository, tag, digest string) Artifact
  • func (art *Artifact) SetURI(uri string) error
  • func (art *Artifact) Version() string
  • func (art *Artifact) VersionedImage() string
• type CredentialStore
  • func NewCredentialStore() *CredentialStore
  • func (cs *CredentialStore) Credential(registry string) (auth.Credential, error)
  • func (cs *CredentialStore) Init() (err error)
  • func (cs *CredentialStore) SetDirectory(directory string)
• type OCIRegistryClient
  • func NewOCIRegistry(context StorageContext) *OCIRegistryClient
  • func (or *OCIRegistryClient) CopyGraph(ctx context.Context, srcStorage orasregistry.Repository, ...) error
  • func (or *OCIRegistryClient) Destination(image Artifact) string
  • func (or *OCIRegistryClient) FetchBlob(ctx context.Context, srcStorage orasregistry.Repository, ...) ([]byte, error)
  • func (or *OCIRegistryClient) FetchBytes(ctx context.Context, srcStorage orasregistry.Repository, artifact Artifact) (ocispec.Descriptor, []byte, error)
  • func (or *OCIRegistryClient) GetHost() string
  • func (or *OCIRegistryClient) GetStorage(ctx context.Context, artifact Artifact) (repo orasregistry.Repository, err error)
  • func (or *OCIRegistryClient) Init() error
  • func (or *OCIRegistryClient) Resolve(ctx context.Context, srcStorage orasregistry.Repository, versionedImage string) (desc ocispec.Descriptor, err error)
  • func (or *OCIRegistryClient) SetProject(project string)
• type StorageClient
• type StorageContext
  • func NewStorageContext(host string, credentialStore *CredentialStore, certificates *x509.CertPool, ...) StorageContext

Functions

func GetCertificates

func GetCertificates(certFile string) (certificates *x509.CertPool, err error)

GetCertificates get X509 certificates.

func PullBytes

func PullBytes(ctx context.Context, sc StorageClient, artifact Artifact) (data []byte, err error)

PullBytes a resource from the registry.

Types

type Artifact

type Artifact struct {
	Registry   string
	Repository string
	Tag        string
	Digest     string
}

Artifact to head release dependency.

func NewArtifact

func NewArtifact(registry, repository, tag, digest string) Artifact

NewArtifact creates a new artifact object.

func (*Artifact) SetURI

func (art *Artifact) SetURI(uri string) error

SetURI value for artifact.

func (*Artifact) Version

func (art *Artifact) Version() string

Version returns tag or digest.

func (*Artifact) VersionedImage

func (art *Artifact) VersionedImage() string

VersionedImage returns full URI for image.

type CredentialStore

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

CredentialStore for registry credentials such as ~/.docker/config.json.

func NewCredentialStore

func NewCredentialStore() *CredentialStore

NewCredentialStore create a credential store.

func (*CredentialStore) Credential

func (cs *CredentialStore) Credential(registry string) (auth.Credential, error)

Credential get an authentication credential for a given registry.

func (*CredentialStore) Init

func (cs *CredentialStore) Init() (err error)

Init initialize a credential store.

func (*CredentialStore) SetDirectory

func (cs *CredentialStore) SetDirectory(directory string)

SetDirectory override default directory.

type OCIRegistryClient

type OCIRegistryClient struct {
	StorageContext
	// contains filtered or unexported fields
}

OCIRegistryClient storage client for an OCI registry.

func NewOCIRegistry

func NewOCIRegistry(context StorageContext) *OCIRegistryClient

NewOCIRegistry create an OCI registry client.

func (*OCIRegistryClient) CopyGraph

func (or *OCIRegistryClient) CopyGraph(ctx context.Context, srcStorage orasregistry.Repository, dstStorage orasregistry.Repository, desc ocispec.Descriptor) error

CopyGraph copy manifest and all blobs to destination.

func (*OCIRegistryClient) Destination

func (or *OCIRegistryClient) Destination(image Artifact) string

Destination of this storage registry.

func (*OCIRegistryClient) FetchBlob

func (or *OCIRegistryClient) FetchBlob(ctx context.Context, srcStorage orasregistry.Repository, descriptor ocispec.Descriptor) ([]byte, error)

FetchBlob get named blob.

func (*OCIRegistryClient) FetchBytes

func (or *OCIRegistryClient) FetchBytes(ctx context.Context, srcStorage orasregistry.Repository, artifact Artifact) (ocispec.Descriptor, []byte, error)

FetchBytes a resource from the registry.

func (*OCIRegistryClient) GetHost

func (or *OCIRegistryClient) GetHost() string

GetHost for registry host.

func (*OCIRegistryClient) GetStorage

func (or *OCIRegistryClient) GetStorage(ctx context.Context, artifact Artifact) (repo orasregistry.Repository, err error)

GetStorage object based on repository.

func (*OCIRegistryClient) Init

func (or *OCIRegistryClient) Init() error

Init registry configuration.

func (*OCIRegistryClient) Resolve

func (or *OCIRegistryClient) Resolve(ctx context.Context, srcStorage orasregistry.Repository, versionedImage string) (desc ocispec.Descriptor, err error)

Resolve the location of the source repository given the image.

func (*OCIRegistryClient) SetProject

func (or *OCIRegistryClient) SetProject(project string)

SetProject for registry destination.

type StorageClient

type StorageClient interface {
	Init() error
	Resolve(ctx context.Context, srcStorage orasregistry.Repository, versionedImage string) (desc ocispec.Descriptor, err error)
	GetStorage(ctx context.Context, image Artifact) (repo orasregistry.Repository, err error)
	SetProject(project string)
	Destination(image Artifact) string
	FetchBytes(ctx context.Context, srcStorage orasregistry.Repository, artifact Artifact) (ocispec.Descriptor, []byte, error)
	FetchBlob(ctx context.Context, srcStorage orasregistry.Repository, descriptor ocispec.Descriptor) ([]byte, error)
	CopyGraph(ctx context.Context, srcStorage orasregistry.Repository, dstStorage orasregistry.Repository, desc ocispec.Descriptor) error
}

StorageClient interface for general image storage client.

type StorageContext

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

StorageContext describes aspects of a registry.

func NewStorageContext

func NewStorageContext(host string, credentialStore *CredentialStore, certificates *x509.CertPool, insecure bool) StorageContext

NewStorageContext create registry context.