Documentation
¶
Overview ¶
Package image holds pure operations over v1.Image / v1.ImageIndex values that stand on their own (multi-arch resolution, future diff helpers, ...). Side-effecting I/O belongs in registry (remote) or imageio (disk).
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type ResolvedSources ¶
ResolvedSources holds per-reference results of resolving a list of remote sources. For indices that need to stay multi-arch (OCI layout without --platform) we store them in Indices; everything else ends up in Images already resolved to a single manifest.
func Resolve ¶
func Resolve(ctx context.Context, srcList []string, keepMultiArchIndex bool, cachePath string, opts *registry.Options) (*ResolvedSources, error)
Resolve fetches each reference in srcList and classifies the result.
keepMultiArchIndex = true tells the resolver to keep an OCI index as an index when no --platform is pinned (pull-to-OCI layout wants full indices). Otherwise every source resolves to a single v1.Image for the current or pinned platform.
cachePath, when non-empty, wraps each returned image with a filesystem cache so layers re-used across pulls are kept on disk.
Duplicate srcList entries return an error rather than collapsing into a single map slot - otherwise downstream tarballs/layouts would silently drop one copy and surprise the user (`cr pull foo:1 foo:1 dst.tar` would yield a single-image tar, not two).