imgutil

Documentation

Index

• func IsErrHTTPResponseToHTTPSClient(err error) bool
• func ParseRepoTag(imgName string) (string, string)
• func ReadImageConfig(ctx context.Context, img containerd.Image) (ocispec.Image, ocispec.Descriptor, error)
• func ReadIndex(ctx context.Context, img containerd.Image) (*ocispec.Index, *ocispec.Descriptor, error)
• func ReadManifest(ctx context.Context, img containerd.Image) (*ocispec.Manifest, *ocispec.Descriptor, error)
• type EnsuredImage
  • func EnsureImage(ctx context.Context, client *containerd.Client, stdout io.Writer, ...) (*EnsuredImage, error)
• type PullMode

Functions

func IsErrHTTPResponseToHTTPSClient

func IsErrHTTPResponseToHTTPSClient(err error) bool

IsErrHTTPResponseToHTTPSClient returns whether err is "http: server gave HTTP response to HTTPS client"

func ParseRepoTag

func ParseRepoTag(imgName string) (string, string)

func ReadImageConfig

func ReadImageConfig(ctx context.Context, img containerd.Image) (ocispec.Image, ocispec.Descriptor, error)

ReadImageConfig reads the config spec (`application/vnd.oci.image.config.v1+json`) for img.platform from content store.

func ReadIndex

func ReadIndex(ctx context.Context, img containerd.Image) (*ocispec.Index, *ocispec.Descriptor, error)

ReadIndex returns the index . ReadIndex returns nil for non-indexed image.

func ReadManifest

func ReadManifest(ctx context.Context, img containerd.Image) (*ocispec.Manifest, *ocispec.Descriptor, error)

ReadManifest returns the manifest for img.platform. ReadManifest returns nil if no manifest was found.

Types

type EnsuredImage

type EnsuredImage struct {
	Ref         string
	Image       containerd.Image
	ImageConfig ocispec.ImageConfig
	Snapshotter string
	Remote      bool // true for stargz
}

func EnsureImage

func EnsureImage(ctx context.Context, client *containerd.Client, stdout io.Writer, snapshotter, rawRef string, mode PullMode, insecure bool, ocispecPlatforms []ocispec.Platform, unpack *bool) (*EnsuredImage, error)

EnsureImage ensures the image.

When insecure is set, skips verifying certs, and also falls back to HTTP when the registry does not speak HTTPS

type PullMode

type PullMode = string

PullMode is either one of "always", "missing", "never"