umoci - Man Page

umoci modifies Open Container images

Aleksa Sarai SEPTEMBER 2018

Synopsis

umoci [--help|-h] [--version|-v] [--log={debug|info|warn|error|fatal}] [--verbose] command [args]

Description

umoci is a tool that allows for high-level modification of an OCI image layout and its tagged images. While umoci attempts to abstract the OCI image specification specifics, it is recommended that users of this tool read through the specification ⟨https://github.com/opencontainers/image-spec⟩ to make sure they understand the rough idea.

umoci is unique in that it is, at the time of writing, the first tool to allow for arbitrary modification of an OCI image in a high-level fashion (where all of the different blobs in an OCI image are all managed by umoci when doing a high-level operation such as umoci-repack(1)).

Global Options

--help,  -h

Print usage statement.

--version,  -v

Print the version.

--cpu-profile=filename

Generate a CPU profile during umoci's execution and save it to filename.
 This file is stored in Go's pprof ⟨https://golang.org/pkg/runtime/pprof/⟩ format and can be analysed using go
 tool pprof or similar tools.

--log={debug|info|warn|error|fatal}

Set the logging level. The default is "warn".

--verbose

Alias for --log=info.

Commands

init
 Create a new OCI layout. See umoci-init(1) for more detailed usage
 information.

new
 Creates a blank tagged OCI image. See umoci-new(1) for more detailed
 usage information.

unpack
 Unpacks a tagged image into an OCI runtime bundle. See umoci-unpack(1)
 for more detailed usage information.

repack
 Repacks an OCI runtime bundle into a tagged image. See umoci-repack(1)
 for more detailed usage information.

config
 Modifies the image configuration of an OCI image. See umoci-config(1) for
 more detailed usage information.

stat
 Displays status information of an image manifest. See umoci-stat(1) for
 more detailed usage information.

tag
 Creates a new tag in an OCI image. See umoci-tag(1) for more detailed
 usage information.

remove, rm
 Removes a tag from an OCI image. See umoci-remove(1) for more detailed
 usage information.

list, ls
 Lists the set of tags in an OCI image. See umoci-list(1) for more
 detailed usage information.

gc
 Garbage collects all unreferenced OCI image blobs. See umoci-gc(1) for
 more detailed usage information.

See Also

umoci-init(1), umoci-new(1), umoci-unpack(1), umoci-repack(1), umoci-config(1), umoci-stat(1), umoci-tag(1), umoci-remove(1), umoci-list(1), umoci-gc(1), skopeo(1)

Referenced By

umoci-config(1), umoci-gc(1), umoci-init(1), umoci-insert(1), umoci-list(1), umoci-new(1), umoci-raw(1), umoci-raw-add-layer(1), umoci-raw-runtime-config(1), umoci-raw-unpack(1), umoci-remove(1), umoci-repack(1), umoci-stat(1), umoci-tag(1), umoci-unpack(1).

-