diff --git a/README.md b/README.md index 89570ca..7934cd6 100644 --- a/README.md +++ b/README.md @@ -4,14 +4,14 @@ Docker has become wildly successful for implementing all manner of fast-boot/fast-destroy emphemeral computing. Normally, you configure a container to do one important thing - run a web server, -host a Jenkins instance ... - and the just fire-and-forget afterwards. +host a Jenkins instance ... Then just fire-and-forget afterwards. But you can also use docker to build general purpose sandboxes. To do this, you need to make it easy to log into a running container just like a "real" VM or server. This repo provides a fast track to doing -just that - starting sandboxes you can log into. +just that. -# Things You Can Learn From This +## Things You Can Learn From This * How to build a docker image from a dockerfile * How to tag docker images @@ -27,7 +27,7 @@ computing ideas, and doing custom builds in a sanitized environment. -# Prep Work: What You Need To Do First +## Prep Work: What You Need To Do First The content of this repo assumes you have done several things: @@ -37,7 +37,7 @@ * `/shared` exists on your host machine with permissions `1777` -# Quickstart For The Impatient +## Quickstart For The Impatient Here's the 10,000 foot view of what you'll have to do once the Prep Work above is done: @@ -48,7 +48,7 @@ * Login to your running sandboxes -# Configuring Sandbox Hostname Resolution +## Configuring Sandbox Hostname Resolution Various parts of this repo assume that there are (up to) 10 running sandboxes whose names are `dockersand1` through `dockersand10`. For this @@ -61,15 +61,15 @@ file. -# Building The docker Images +## Building The docker Images Getting a docker container running requires it to be built from an -"image". Images are built from something called a "dockerfile". -It is this file the specifies on which Linux distro your containers -will be based. It also specifies any special configuration or software +"image". Images are built from something called a "dockerfile". It +is this file that specifies which Linux distro on which to base the +image. The file also specifies any special configuration or software installation you want in your containers. By setting up the image -with this stuff in it ahead of time, it will be present every time -you start a new container. +with this stuff in it ahead of time, it will be present every time you +start a new container. There are two dockerfiles in this repo. To build the corresponding images, do this: @@ -79,7 +79,7 @@ ./build-img.sh dockersand-ubuntu -# Start The docker Network And Sandboxes +## Start The docker Network And Sandboxes The creation and destruction of the sandboxes is automated using ansible "playbooks". @@ -109,7 +109,7 @@ --extra-vars "dockersand_image=dockersand-ubuntu" -# Logging In +## Logging In These sandboxes are setup so you can login from your host machine into the running sandboxes using `ssh` keys. You will find the keys under @@ -128,7 +128,7 @@ Once you are logged in, you can promote yourself to `root` using the `sudo` command without any further password required. -# Sharing Files +## Sharing Files The sandboxes are created to share the `/shared` directory with the host machine. Any file you put there is visible from any of the @@ -136,11 +136,12 @@ move data between the host and any of the sandboxes or between the sandboxes themselves. -# Homework +## Homework Not only is this tooling useful for building and using sandboxes, it's -a good way to learn how docker and ansible work. There are comments -throughout to help explain what's going on and why. +a good way to learn how docker and ansible work. Take the time to +explore the various ansible files and dockerfile specifications. There +are comments throughout to help explain what's going on and why. Here are a few ideas of how to expand on what you see here: diff --git a/dockerfiles/dockersand-centos7/dockersand-centos7.dockerfile b/dockerfiles/dockersand-centos7/dockersand-centos7.dockerfile index b6492fa..3148beb 100644 --- a/dockerfiles/dockersand-centos7/dockersand-centos7.dockerfile +++ b/dockerfiles/dockersand-centos7/dockersand-centos7.dockerfile @@ -1,7 +1,7 @@ # Dockerfile For CentOS7 Docker Sandbox FROM centos:7 -MAINTAINER tundra@tundraware.com +MAINTAINER info@tundraware.com # Update OS and install software diff --git a/dockerfiles/dockersand-ubuntu/dockersand-ubuntu.dockerfile b/dockerfiles/dockersand-ubuntu/dockersand-ubuntu.dockerfile index 020de41..8c95aa4 100644 --- a/dockerfiles/dockersand-ubuntu/dockersand-ubuntu.dockerfile +++ b/dockerfiles/dockersand-ubuntu/dockersand-ubuntu.dockerfile @@ -1,7 +1,7 @@ # Dockerfile For Docker Sandbox Ubuntu Image FROM ubuntu -MAINTAINER tundra@tundraware.com +MAINTAINER info@tundraware.com # Suppress interactive installation dialogs ENV DEBIAN_FRONTEND=noninteractive