Go to file
Nalin Dahyabhai 58e56e3efc Import container.{Config,HealthCheck},nat.PortSet
Import the container.Config and container.HealthCheck API types, and the
nat.Port and nat.PortSet types from go-connections.  Use the strslice
package from containers/image instead of rolling or importing our own.

Signed-off-by: Nalin Dahyabhai <nalin@redhat.com>

Closes: #102
Approved by: rhatdan
2017-05-18 18:28:44 +00:00
cmd/buildah Vendor in containers/storage and containers/image 2017-05-17 21:19:24 +00:00
contrib Report pull/commit progress by default 2017-05-10 12:53:25 +00:00
docker Import container.{Config,HealthCheck},nat.PortSet 2017-05-18 18:28:44 +00:00
docs Report pull/commit progress by default 2017-05-10 12:53:25 +00:00
examples Accept commit targets which are just store refs 2017-03-28 19:33:07 +00:00
imagebuildah Vendor in containers/storage and containers/image 2017-05-17 21:19:24 +00:00
tests imagebuildah: add AdditionalTags 2017-05-08 18:05:31 +00:00
vendor Vendor in containers/storage and containers/image 2017-05-17 21:19:24 +00:00
.redhat-ci.sh Add a "validate" target 2017-04-12 21:25:35 +00:00
.redhat-ci.yml hook up to redhat-ci 2017-03-24 18:42:00 +00:00
.travis.yml Add a "validate" target 2017-04-12 21:25:35 +00:00
LICENSE Initial commit 2017-01-26 17:59:13 +01:00
Makefile Add a "go vet" validation step 2017-05-08 17:50:38 +00:00
README.md Few install touchups to README.md 2017-05-12 21:59:36 +00:00
add.go Fixup metalinter errors 2017-04-12 21:25:35 +00:00
btrfs_tag.sh Suss out build tags, add a missing Travis dep 2017-01-28 06:20:22 +01:00
buildah.go Vendor in containers/storage and containers/image 2017-05-17 21:19:24 +00:00
commit.go Report pull/commit progress by default 2017-05-10 12:53:25 +00:00
common.go Report pull/commit progress by default 2017-05-10 12:53:25 +00:00
config.go Internalize some Docker types 2017-04-19 19:05:06 +00:00
delete.go Clarify a comment 2017-03-24 13:48:39 -04:00
image.go Vendor in containers/storage and containers/image 2017-05-17 21:19:24 +00:00
import.go Vendor in containers/storage and containers/image 2017-05-17 21:19:24 +00:00
libdm_tag.sh Refine the libdm_no_deferred_remove tag check 2017-02-02 15:24:02 -05:00
mount.go Fix a number of issues flagged by golint 2017-02-10 14:46:09 -05:00
new.go Vendor in containers/storage and containers/image 2017-05-17 21:19:24 +00:00
pull.go Vendor in containers/storage and containers/image 2017-05-17 21:19:24 +00:00
run.go Fixup metalinter errors 2017-04-12 21:25:35 +00:00
unmount.go Remove link from CLI 2017-03-23 14:59:20 -04:00
user.go Fixup metalinter errors 2017-04-12 21:25:35 +00:00
user_basic.go Teach "Run" to dig user IDs out of containers 2017-04-11 18:41:54 +00:00
user_unix_cgo.go Fixup metalinter errors 2017-04-12 21:25:35 +00:00
util.go imagebuildah: Reexport some things 2017-04-24 14:33:43 +00:00
vendor.conf Vendor in containers/storage and containers/image 2017-05-17 21:19:24 +00:00

README.md

buildah - a tool for building OCI images

Go Report Card Travis

Note: this package is in alpha.

The buildah package provides a command line tool which can be used to

  • create a working container, either from scratch or using an image as a starting point
  • 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

Installation notes

Prior to installing buildah, install the following packages on your linux distro:

  • make
  • golang
  • bats
  • btrfs-progs-devel
  • device-mapper-devel
  • gpgme-devel
  • libassuan-devel
  • git
  • bzip2
  • go-md2man
  • skopeo-containers

In Fedora, you can use this command:

 dnf -y install \ 
    make \ 
    golang \ 
    bats \ 
    btrfs-progs-devel \ 
    device-mapper-devel \ 
    gpgme-devel \ 
    libassuan-devel \ 
    git \ 
    bzip2 \
    go-md2man \
    skopeo-containers

Then to install buildah follow the steps in this example:

  mkdir ~/buildah
  cd ~/buildah
  export GOPATH=`pwd` 
  git clone https://github.com/projectatomic/buildah ./src/github.com/projectatomic/buildah 
  cd ./src/github.com/projectatomic/buildah 
  make 
  make install
  buildah --help

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-mount(1) Mount the working container's root filesystem.
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-umount(1) Unmount a working container's root file system.

Future goals include:

  • more CI tests
  • additional CLI commands (?)