images

package

v0.1.0 Latest Latest Go to latest Published: Aug 13, 2026 License: Apache-2.0 Imports: 11 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/podmin-dev/podmin

Links

Open Source Insights

Documentation ¶

Overview ¶

Package images transfers CLI-managed OCI images between registries, local storage, and object storage.

Index ¶

func CacheRoot() (string, error)
func Mirror(ctx context.Context, source, cacheRoot string, objects ObjectStore) (string, error)
func NormalizeDestination(source name.Tag, destination string) (name.Tag, string, error)
func ParseSource(source string) (name.Tag, error)
func Pull(ctx context.Context, source string, cacheRoot string) error
func Push(ctx context.Context, source, destination, cacheRoot string, refresh bool, ...) (string, error)
type ObjectStore

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func CacheRoot ¶

func CacheRoot() (string, error)

CacheRoot returns Podmin's XDG-compatible OCI cache root.

func Mirror ¶

func Mirror(ctx context.Context, source, cacheRoot string, objects ObjectStore) (string, error)

Mirror publishes an upstream image beneath the setup-managed mirror namespace.

func NormalizeDestination ¶

func NormalizeDestination(source name.Tag, destination string) (name.Tag, string, error)

NormalizeDestination returns the cluster reference and repository object prefix.

func ParseSource ¶

func ParseSource(source string) (name.Tag, error)

ParseSource parses a tagged source reference.

func Pull ¶

func Pull(ctx context.Context, source string, cacheRoot string) error

Pull imports the complete source image or multi-platform index into cacheRoot.

func Push ¶

func Push(ctx context.Context, source, destination, cacheRoot string, refresh bool, objects ObjectStore) (string, error)

Push uploads a cached OCI repository with immutable objects first and returns the normalized cluster image reference.

Types ¶

type ObjectStore ¶

type ObjectStore interface {
	Get(context.Context, string) ([]byte, string, error)
	Put(context.Context, string, []byte) error
	PutIfMatch(context.Context, string, []byte, string) error
}

ObjectStore is the object-storage contract required by image publication. Get returns an opaque version used to replace mutable index.json objects.

Source Files ¶

View all Source files

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