website: document the new docker post-processors

This commit is contained in:
Mitchell Hashimoto 2014-09-04 21:39:18 -07:00
parent dfae0d26e0
commit d2e24a4ebc
3 changed files with 85 additions and 0 deletions

View File

@ -0,0 +1,35 @@
---
layout: "docs"
page_title: "docker-save Post-Processor"
---
# Docker Save Post-Processor
Type: `docker-save`
The Docker Save post-processor takes an artifact from the
[docker builder](/docs/builders/docker.html) that was committed
and saves it to a file. This is similar to exporting the Docker image
directly from the builder, except that it preserves the hierarchy of
images and metadata.
We understand the terminology can be a bit confusing, but we've
adopted the terminology from Docker, so if you're familiar with that, then
you'll be familiar with this and vice versa.
## Configuration
The configuration for this post-processor is extremely simple.
* `path` (string) - The path to save the image.
## Example
An example is shown below, showing only the post-processor configuration:
<pre class="prettyprint">
{
"type": "docker-save",
"path": "foo.tar"
}
</pre>

View File

@ -0,0 +1,48 @@
---
layout: "docs"
page_title: "docker-tag Post-Processor"
---
# Docker Tag Post-Processor
Type: `docker-tag`
The Docker Tag post-processor takes an artifact from the
[docker builder](/docs/builders/docker.html) that was committed
and tags it into a repository. This allows you to use the other
Docker post-processors such as
[docker-push](/docs/post-processors/docker-push.html) to push the image
to a registry.
This is very similar to the [docker-import](/docs/post-processors/docker-import.html)
post-processor except that this works with committed resources, rather
than exported.
## Configuration
The configuration for this post-processor is extremely simple. At least
a repository is required.
* `repository` (string) - The repository of the image.
* `tag` (string) - The tag for the image. By default this is not
set.
## Example
An example is shown below, showing only the post-processor configuration:
<pre class="prettyprint">
{
"type": "docker-tag",
"repository": "mitchellh/packer",
"tag": "0.7"
}
</pre>
This example would take the image created by the Docker builder
and tag it into the local Docker process with a name of `mitchellh/packer:0.7`.
Following this, you can use the
[docker-push](/docs/post-processors/docker-push.html)
post-processor to push it to a registry, if you want.

View File

@ -60,6 +60,8 @@
<li><h4>Post-Processors</h4></li>
<li><a href="/docs/post-processors/docker-import.html">docker-import</a></li>
<li><a href="/docs/post-processors/docker-push.html">docker-push</a></li>
<li><a href="/docs/post-processors/docker-save.html">docker-save</a></li>
<li><a href="/docs/post-processors/docker-tag.html">docker-tag</a></li>
<li><a href="/docs/post-processors/vagrant.html">Vagrant</a></li>
<li><a href="/docs/post-processors/vagrant-cloud.html">Vagrant Cloud</a></li>
<li><a href="/docs/post-processors/vsphere.html">vSphere</a></li>