diff options
Diffstat (limited to 'system/buildah/README')
| -rw-r--r-- | system/buildah/README | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/system/buildah/README b/system/buildah/README new file mode 100644 index 0000000000..75d3214ce2 --- /dev/null +++ b/system/buildah/README @@ -0,0 +1,35 @@ +buildah is a (daemon-free) container build utility + +The Buildah package provides a command line tool that can be used to + +* create a working container, either from scratch or using an image as a + starting point +* create an image, either from a working container or via the instructions in a + Dockerfile +* images can be built in either the OCI image format or the traditional + upstream docker image format +* mount a working container's root filesystem for manipulation +* unmount a working container's root filesystem +* use the updated contents of a container's root filesystem as a filesystem + layer to create a new image +* delete a working container or an image +* rename a local container + +For examples, see: +* https://github.com/containers/buildah or /usr/doc/buildah-*/README.md +* man pages + +non-root usage: + +plenty of kernel recent kernel's support the user-namespace sub uid/gid +mapping. Only recent versions of shadow-utils will append a new mapping for +users when they are created. You may have to add a mapping for your user like +so: + +```shell +echo "$YOURUSER:100000:65536" > /etc/subuid +echo "$YOURGROUP:100000:65536" > /etc/subgid +``` + +if you have more than one non-root user to add a mapping for, then their start +number (like `100000` above) would begin after 100000+65536. |