projectatomic/buildah

Name: buildah

Owner: Project Atomic

Description: A tool that facilitates building OCI images

Created: 2017-01-26 16:59:13.0

Updated: 2018-05-24 23:57:58.0

Pushed: 2018-05-24 23:15:26.0

Homepage:

Size: 15413

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Buildah - a tool that facilitates building OCI container images

Note: this package is in alpha, but is close to being feature-complete.

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

Changelog

Installation notes

Troubleshooting Guide

Tutorials

Example

From ./examples/lighttpd.sh:

t > lighttpd.sh <<"EOF"
in/bash -x

=`buildah from ${1:-fedora}`

et all updates and install our minimal httpd server
dah run $ctr1 -- dnf update -y
dah run $ctr1 -- dnf install -y lighttpd

nclude some buildtime annotations
dah config --annotation "com.example.build.host=$(uname -n)" $ctr1

un our server and expose the port
dah config --cmd "/usr/sbin/lighttpd -D -f /etc/lighttpd/lighttpd.conf" $ctr1
dah config --port 80 $ctr1

ommit this container to an image name
dah commit $ctr1 ${2:-$USER/lighttpd}


mod +x lighttpd.sh
do ./lighttpd.sh

Commands

| Command | Description | | —————————————————- | —————————————————————————————————- | | buildah-add(1) | Add the contents of a file, URL, or a directory to the container. | | buildah-bud(1) | Build an image using instructions from Dockerfiles. | | buildah-commit(1) | Create an image from a working container. | | buildah-config(1) | Update image configuration settings. | | buildah-containers(1) | List the working containers and their base images. | | buildah-copy(1) | Copies the contents of a file, URL, or directory into a container's working directory. | | buildah-from(1) | Creates a new working container, either from scratch or using a specified image as a starting point. | | buildah-images(1) | List images in local storage. | | buildah-inspect(1) | Inspects the configuration of a container or image. | | buildah-mount(1) | Mount the working container's root filesystem. | | buildah-push(1) | Push an image from local storage to elsewhere. | | buildah-rm(1) | Removes one or more working containers. | | buildah-rmi(1) | Removes one or more images. | | buildah-run(1) | Run a command inside of the container. | | buildah-tag(1) | Add an additional name to a local image. | | buildah-umount(1) | Unmount a working container's root file system. | | buildah-version(1) | Display the Buildah Version Information |

Future goals include:

• more CI tests
• additional CLI commands (?)