From f7823aef68b36a5743e5b78b08978632646d1113 Mon Sep 17 00:00:00 2001 From: Peter Wilmott Date: Wed, 15 Jul 2015 00:02:33 +0100 Subject: [PATCH] Update README.md --- README.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 57 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index cd94f44..67180e3 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,58 @@ # Bocker -## Docker implemented in 100 lines of Bash +Docker implemented in 100 lines of bash. + +## Prerequisites + +The following packages are needed to run bocker. + +* util-linux 2.25.2 +* btrfs-progs 3.16.2 + + +Because RHEL/CentOS 7 does not ship a new enough version of util-linux you will need grab the sources from [here](https://www.kernel.org/pub/linux/utils/util-linux/v2.25/) and compile yourself. + +Additionally `/var/bocker` needs to be on a btrfs filesystem. + +For ease of use a Vagrantfile is included which will build the needed environment. + +## Example Usage + +``` +$ ./bocker init base-image/ +img_e6b698c1-513d-4a40-807c-23b0fe54353a + +$ ./bocker images +IMAGE_ID +img_e6b698c1-513d-4a40-807c-23b0fe54353a + +$ ./bocker run img_e6b698c1-513d-4a40-807c-23b0fe54353a uname -sro +Linux 3.10.0-123.20.1.el7.x86_64 GNU/Linux + +$ ./bocker ps +CONTAINER_ID COMMAND +ps_349bf646-06cf-4d98-bcf8-744f59e7e6bb uname -sro + +$ ./bocker rm ps_349bf646-06cf-4d98-bcf8-744f59e7e6bb +ps_349bf646-06cf-4d98-bcf8-744f59e7e6bb + +$ ./bocker rm img_e6b698c1-513d-4a40-807c-23b0fe54353a +img_e6b698c1-513d-4a40-807c-23b0fe54353a +``` + +## Currently Implemented + +* `docker build` † +* `docker images` +* `docker ps` +* `docker run` +* `docker rm` / `docker rmi` + +† `bocker init` provides a very limited implemetation of `docker build` + +## Not Yet Implemented + +* Networking +* Port Forwarding +* Data Volumes +* Data Volume Containers +* `docker commit`