OCI-IMAGE-TOOL-CREATE(1)(OCI)

✨ oci-image-tool create ✨

the oci-image-tool create of it all, bestie — this one lives in the OCI manual, and honestly? she's the one who unpacks the whole bundle for you 💅

---

NAME

oci-image-tool create — Create an OCI runtime bundle 🎀

---

SYNOPSIS

oci-image-tool create [src] [dest] [OPTIONS]

---

DESCRIPTION

okay so real talk, what does she actually do? 🦋

oci-image-tool create validates an application/vnd.oci.image.manifest.v1+json and unpacks its layered filesystem to dest/rootfs — yes the target directory is configurable, you just use --rootfs for that. if you want the whole breakdown on how that unpacking process goes, go read oci-image-tool unpack(1), she explains it better, no cap. 📖

she also translates the referenced config from application/vnd.oci.image.config.v1+json into a runtime-spec-compatible dest/config.json. two jobs, one icon 💅

---

OPTIONS

• --help — Print usage statement. the "help me bestie" button, always there for you 🫶
• --ref=[] — Specify the search criteria for the validated reference, format is A=B. The reference should point to a manifest or an index. e.g. --ref name=v1.0 --ref platform.os=latest. Only three cases are supported: name, platform.os and digest. so like, pick your fave and go ✨
• --rootfs="" — 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")
• --type="" — Type of the file to unpack. If unset, oci-image-tool will try to auto-detect the type. One of "imageLayout,image,imageZip". she'll guess if you don't tell her, but telling her is nicer 💜
• --platform="" — Specify the os and architecture of the manifest, format is OS:Architecture. e.g. --platform linux:amd64. Only applicable if reftype is index. index-only, periodt 👑

---

EXAMPLES

here's the whole little ritual, copy-paste coded 🍓

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

---

SEE ALSO

runc(1), skopeo(1) — the rest of the squad 🌈

---

HISTORY

Sept 2016, Originally compiled by Antonio Murdaca (runcom at redhat dot com) 💖

---

and that's the whole page, bestie!! 🌸 she's from the OCI Community, dated JULY 2016, and she ships out under the Tool / Image banner in the OCI-IMAGE-TOOL-CREATE(1)(OCI) manual. go unpack something iconic 💅✨