diff --git a/website/source/docs/builders/docker.html.markdown b/website/source/docs/builders/docker.html.markdown new file mode 100644 index 000000000..a38691f76 --- /dev/null +++ b/website/source/docs/builders/docker.html.markdown @@ -0,0 +1,41 @@ +--- +layout: "docs" +--- + +# Docker Builder + +Type: `docker` + +The Docker builder builds [Docker](http://www.docker.io) images using +Docker. The builder starts a Docker container, runs provisioners within +this container, then exports the container for re-use. + +The Docker builder must run on a machine that supports Docker. + +## Basic Example + +Below is a fully functioning example. It doesn't do anything useful, since +no provisioners are defined, but it will effectively repackage an image. + +
+{ + "type": "docker", + "image": "ubuntu", + "export_path": "image.tar" +} ++ +## Configuration Reference + +All configuration options are currently required. + +* `export_path` (string) - The path where the final container will be exported + as a tar file. + +* `image` (string) - The base image for the Docker container that will + be started. This image will be pulled from the Docker registry if it + doesn't already exist. + +## Dockerfiles + +TODO diff --git a/website/source/layouts/docs.erb b/website/source/layouts/docs.erb index f400ec930..d340b6edc 100644 --- a/website/source/layouts/docs.erb +++ b/website/source/layouts/docs.erb @@ -32,6 +32,7 @@