containerimagehandler

README

containerimagehandler

Handle container images without a runnig daemon like Docker. This makes the handling fast and available in buildsystems where no Docker or other container runtime is available.

Examples:

• Add and delete files in a container image archive file
• Download a container image as archive file

Documentation

Index

• func AddFileToArchive(ctx context.Context, archivePath string, ...) error
• func AddFileToImage(ctx context.Context, image v1.Image, ...) (v1.Image, error)
• func CreateSingleFileArchive(ctx context.Context, outputPath string, ...) error
• func DeleteFileInArchive(ctx context.Context, archivePath string, ...) error
• func DownloadImage(ctx context.Context, imageNameAndTag string) (v1.Image, name.Reference, error)
• func DownloadImageAsArchive(ctx context.Context, imageNameAndTag string, outputPath string) error
• func DownloadImageAsTeporaryArchive(ctx context.Context, imageNameAndTag string) (string, error)
• func FileInArchiveExists(ctx context.Context, archivePath string, pathToCheck string) (bool, error)
• func ListFilesInArchive(ctx context.Context, archivePath string) ([]string, error)
• func ListImageNamesAndTagsInArchive(ctx context.Context, archivePath string) ([]string, error)
• func LoadImageFromArchive(ctx context.Context, archivePath string, imageNameAndTag string) (v1.Image, *name.Tag, error)
• func OverwriteArchive(ctx context.Context, archivePath string, tag *name.Tag, image v1.Image) error
• func PushImage(ctx context.Context, image v1.Image, nameAndTag string) error
• func ReadFileFromArchiveAsBytes(ctx context.Context, archivePath string, toReadPath string) ([]byte, error)
• func ReadFileFromArchiveAsString(ctx context.Context, archivePath string, toReadPath string) (string, error)

Functions

func AddFileToArchive

func AddFileToArchive(ctx context.Context, archivePath string, options *containeroptions.AddFileToImageArchiveOptions) error

func AddFileToImage

func AddFileToImage(ctx context.Context, image v1.Image, options *containeroptions.AddFileToImageOptions) (v1.Image, error)

func CreateSingleFileArchive

func CreateSingleFileArchive(ctx context.Context, outputPath string, options *containeroptions.CreateSingleFileArchiveOptions) error

func DeleteFileInArchive

func DeleteFileInArchive(ctx context.Context, archivePath string, options *containeroptions.DeleteFileFromImageOptions) error

func DownloadImage

func DownloadImage(ctx context.Context, imageNameAndTag string) (v1.Image, name.Reference, error)

func DownloadImageAsArchive

func DownloadImageAsArchive(ctx context.Context, imageNameAndTag string, outputPath string) error

func DownloadImageAsTeporaryArchive

func DownloadImageAsTeporaryArchive(ctx context.Context, imageNameAndTag string) (string, error)

func FileInArchiveExists

func FileInArchiveExists(ctx context.Context, archivePath string, pathToCheck string) (bool, error)

func ListFilesInArchive

func ListFilesInArchive(ctx context.Context, archivePath string) ([]string, error)

func ListImageNamesAndTagsInArchive

func ListImageNamesAndTagsInArchive(ctx context.Context, archivePath string) ([]string, error)

func LoadImageFromArchive

func LoadImageFromArchive(ctx context.Context, archivePath string, imageNameAndTag string) (v1.Image, *name.Tag, error)

Load the image tagged as "imageNameAndTag" from a container image archive.

If imageNammeAndTag is empty the tag is evaluated based on the archive content. This will fail when multiple tags are defined in one archive. In the case of multiple tags the tag has to be explicitly defined as imageNameAndTag

func OverwriteArchive

func OverwriteArchive(ctx context.Context, archivePath string, tag *name.Tag, image v1.Image) error

func PushImage

func PushImage(ctx context.Context, image v1.Image, nameAndTag string) error

func ReadFileFromArchiveAsBytes

func ReadFileFromArchiveAsBytes(ctx context.Context, archivePath string, toReadPath string) ([]byte, error)

func ReadFileFromArchiveAsString

func ReadFileFromArchiveAsString(ctx context.Context, archivePath string, toReadPath string) (string, error)