Man page - umoci-raw-unpack(1)

Packages contains this manual

Package: umoci
apt-get install umoci

Manuals in package:

Documentations in package:

umoci

Manual

umoci-raw-unpack(1)

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
SEE ALSO

Aleksa Sarai SEPTEMBER 2018

NAME

umoci raw unpack - Unpacks an OCI image tag into a root filesystem

SYNOPSIS

umoci raw unpack [ umoci-unpack(1) flags ] rootfs

DESCRIPTION

Extracts all of the layers (deterministically) to a root filesystem at path rootfs . This path must not already exist.

OPTIONS

The global options are defined in umoci (1), while the options for this particular subcommand are identical to umoci-unpack (1) with the exception that the rootfs path is provided rather than a bundle path.

EXAMPLE

The following downloads an image from a docker (1) registry using skopeo (1), unpacks said image to a root filesystem, generates an OCI runtime configuration file with umoci-raw-runtime-config (1) and then creates a new container with runc (8).

% skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
# umoci raw unpack --image image rootfs
# umoci raw runtime-config --image image --rootfs rootfs config.json
# runc run ctr
[ container session ]

With --rootless it is also possible to do the above example without root privileges. umoci will generate a configuration that works with rootless containers in runc (8).

% skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
% umoci raw unpack --image image --rootless rootfs
% umoci raw runtime-config --image image --rootfs rootfs --rootless config.json
% runc --root $HOME/runc run ctr
[ rootless container session ]