images

package
v2.2.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 7, 2020 License: Apache-2.0 Imports: 27 Imported by: 5

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func BatchRemove

func BatchRemove(ctx context.Context, images []string, opts entities.ImageRemoveOptions) (*entities.ImageRemoveReport, []error)

BachtRemove removes a batch of images from the local storage.

func Build

func Build(ctx context.Context, containerFiles []string, options entities.BuildOptions) (*entities.BuildReport, error)

Build creates an image using a containerfile reference

func Diff

func Diff(ctx context.Context, nameOrID string) ([]archive.Change, error)

Diff provides the changes between two container layers

func Exists

func Exists(ctx context.Context, nameOrID string) (bool, error)

Exists a lightweight way to determine if an image exists in local storage. It returns a boolean response.

func Export

func Export(ctx context.Context, nameOrID string, w io.Writer, format *string, compress *bool) error

Export saves an image from local storage as a tarball or image archive. The optional format parameter is used to change the format of the output.

func GetImage

func GetImage(ctx context.Context, nameOrID string, size *bool) (*entities.ImageInspectReport, error)

Get performs an image inspect. To have the on-disk size of the image calculated, you can use the optional size parameter.

func History

func History(ctx context.Context, nameOrID string) ([]*handlers.HistoryResponse, error)

History returns the parent layers of an image.

func Import

func Import(ctx context.Context, changes []string, message, reference, u *string, r io.Reader) (*entities.ImageImportReport, error)

Imports adds the given image to the local image store. This can be done by file and the given reader or via the url parameter. Additional metadata can be associated with the image by using the changes and message parameters. The image can also be tagged given a reference. One of url OR r must be provided.

func List

func List(ctx context.Context, all *bool, filters map[string][]string) ([]*entities.ImageSummary, error)

List returns a list of images in local storage. The all boolean and filters parameters are optional ways to alter the image query.

func Load

func Load(ctx context.Context, r io.Reader, name *string) (*entities.ImageLoadReport, error)

func MultiExport

func MultiExport(ctx context.Context, namesOrIds []string, w io.Writer, format *string, compress *bool) error

func Prune

func Prune(ctx context.Context, all *bool, filters map[string][]string) ([]string, error)

Prune removes unused images from local storage. The optional filters can be used to further define which images should be pruned.

func Pull

func Pull(ctx context.Context, rawImage string, options entities.ImagePullOptions) ([]string, error)

Pull is the binding for libpod's v2 endpoints for pulling images. Note that `rawImage` must be a reference to a registry (i.e., of docker transport or be normalized to one). Other transports are rejected as they do not make sense in a remote context. Progress reported on stderr

func Push

func Push(ctx context.Context, source string, destination string, options entities.ImagePushOptions) error

Push is the binding for libpod's v2 endpoints for push images. Note that `source` must be a referring to an image in the remote's container storage. The destination must be a reference to a registry (i.e., of docker transport or be normalized to one). Other transports are rejected as they do not make sense in a remote context.

func Remove

func Remove(ctx context.Context, nameOrID string, force bool) (*entities.ImageRemoveReport, error)

Remove removes an image from the local storage. Use force to remove an image, even if it's used by containers.

Search is the binding for libpod's v2 endpoints for Search images.

func Tag

func Tag(ctx context.Context, nameOrID, tag, repo string) error

Tag adds an additional name to locally-stored image. Both the tag and repo parameters are required.

func Tree

func Tree(ctx context.Context, nameOrID string, whatRequires *bool) (*entities.ImageTreeReport, error)

Tree retrieves a "tree" based representation of the given image

func Untag

func Untag(ctx context.Context, nameOrID, tag, repo string) error

Untag removes a name from locally-stored image. Both the tag and repo parameters are required.

Types

This section is empty.

Jump to

Keyboard shortcuts

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