diff --git a/website/pages/docs/post-processors/docker-import.mdx b/website/pages/docs/post-processors/docker-import.mdx index f30a2f903..4108bf13b 100644 --- a/website/pages/docs/post-processors/docker-import.mdx +++ b/website/pages/docs/post-processors/docker-import.mdx @@ -20,6 +20,52 @@ other Docker post-processors such as [docker-push](/docs/post-processors/docker-push) to push the image to a registry. +## Basic Example + + + + +```json +{ + "builders": [{ + "type": "docker", + "image": "ubuntu:18.04", + "export_path": "party_parrot.tar" + }], + "post-processors": [ + { + "type": "docker-import", + "repository": "local/ubuntu", + "tag": "latest" + } +] +} + +``` + + + +```hcl +source "docker" "example" { + image = "ubuntu:18.04" + export_path = "party_parrot.tar" +} + +build { + sources = [ + "source.docker.example" + ] + + post-processor "docker-import" { + repository = "local/ubuntu" + tag = "latest" + } +} +``` + + + + ## Configuration The configuration for this post-processor only requires a `repository`, a `tag` @@ -45,6 +91,9 @@ is optional. An example is shown below, showing only the post-processor configuration: + + + ```json { "type": "docker-import", @@ -53,6 +102,19 @@ An example is shown below, showing only the post-processor configuration: } ``` + + + +```hcl +post-processor "docker-import" { + repository = "hashicorp/packer" + tag = "0.7" +} +``` + + + + This example would take the image created by the Docker builder and import it into the local Docker process with a name of `hashicorp/packer:0.7`. @@ -71,6 +133,9 @@ Docker](https://docs.docker.com/engine/reference/commandline/import/). Example uses of all of the options, assuming one is building an NGINX image from ubuntu as an simple example: + + + ```json { "type": "docker-import", @@ -90,6 +155,30 @@ from ubuntu as an simple example: } ``` + + + +```hcl +post-processor "docker-import" { + repository = "local/centos6" + tag = "latest" + changes = [ + "USER www-data", + "WORKDIR /var/www", + "ENV HOSTNAME www.example.com", + "VOLUME /test1 /test2", + "EXPOSE 80 443", + "LABEL version=1.0", + "ONBUILD RUN date", + "CMD [\"nginx\", \"-g\", \"daemon off;\"]", + "ENTRYPOINT /var/www/start.sh", + ] +} +``` + + + + Allowed metadata fields that can be changed are: - CMD