.TH "OCI" "1" " OCI-IMAGE-TOOL User Manuals" "OCI Community" "JULY 2016" 
.nh
.ad l


.SH NAME
.PP
oci\-image\-tool\-create\-runtime\-bundle \- Create an OCI runtime bundle


.SH SYNOPSIS
.PP
\fBoci\-image\-tool create\-runtime\-bundle\fP [src] [dest] [flags]


.SH DESCRIPTION
.PP
\fB\fCoci\-image\-tool create\-runtime\-bundle\fR validates an application/vnd.oci.image.manifest.v1+json and unpacks its layered filesystem to \fB\fCdest/rootfs\fR, although the target directory is configurable with \fB\fC\-\-rootfs\fR\&. See \fBoci\-image\-tool\-unpack\fP(1) for more details on this process.

.PP
Also translates the referenced config from application/vnd.oci.image.config.v1+json to a
runtime\-spec\-compatible \fB\fCdest/config.json\fR\&.


.SH OPTIONS
.PP
\fB\-\-help\fP
  Print usage statement

.PP
\fB\-\-ref\fP
  The ref pointing to the manifest of the OCI image. This must be present in the "refs" subdirectory of the image. (default "v1.0")

.PP
\fB\-\-rootfs\fP
  A directory representing the root filesystem of the container in the OCI runtime bundle. It is strongly recommended to keep the default value. (default "rootfs")

.PP
\fB\-\-type\fP
  Type of the file to unpack. If unset, oci\-image\-tool will try to auto\-detect the type. One of "imageLayout,image"


.SH EXAMPLES
.PP
.RS

.nf
$ skopeo copy docker://busybox oci:busybox\-oci
$ mkdir busybox\-bundle
$ oci\-image\-tool create\-runtime\-bundle \-\-ref latest busybox\-oci busybox\-bundle
$ cd busybox\-bundle \&\& sudo runc run busybox
[...]

.fi
.RE


.SH SEE ALSO
.PP
\fBoci\-image\-tool\fP(1), \fBrunc\fP(1), \fBskopeo\fP(1)


.SH HISTORY
.PP
July 2016, Originally compiled by Antonio Murdaca (runcom at redhat dot com)