Commit a77ee557 authored by Chris Bednarski's avatar Chris Bednarski

Starting rework of atlas post-processor page

parent 1e9459a0
...@@ -11,9 +11,9 @@ page_title: 'Atlas Post-Processor' ...@@ -11,9 +11,9 @@ page_title: 'Atlas Post-Processor'
Type: `atlas` Type: `atlas`
The Atlas post-processor for Packer receives an artifact from a Packer build and The Atlas post-processor uploads artifacts from your packer builds to Atlas for hosting. Artifacts hosted in Atlas are are automatically made available for use with Vagrant and Terraform, and Atlas provides additional features for managing versions and releases. [Learn more about packer in Atlas.](https://atlas.hashicorp.com/help/packer/features)
uploads it to Atlas. [Atlas](https://atlas.hashicorp.com) hosts and serves
artifacts, allowing you to version and distribute them in a simple way. You can also use the push command to [run packer builds in Atlas](/docs/command-line/push.html). The push command and Atlas post-processor can be used together or independently.
## Workflow ## Workflow
...@@ -25,8 +25,7 @@ location in Atlas. ...@@ -25,8 +25,7 @@ location in Atlas.
Here is an example workflow: Here is an example workflow:
1. Packer builds an AMI with the [Amazon AMI 1. Packer builds an AMI with the [Amazon AMI builder](/docs/builders/amazon.html)
builder](/docs/builders/amazon.html)
2. The `atlas` post-processor takes the resulting AMI and uploads it to Atlas. 2. The `atlas` post-processor takes the resulting AMI and uploads it to Atlas.
The `atlas` post-processor is configured with the name of the AMI, for The `atlas` post-processor is configured with the name of the AMI, for
example `hashicorp/foobar`, to create the artifact in Atlas or update the example `hashicorp/foobar`, to create the artifact in Atlas or update the
...@@ -40,24 +39,19 @@ The configuration allows you to specify and access the artifact in Atlas. ...@@ -40,24 +39,19 @@ The configuration allows you to specify and access the artifact in Atlas.
### Required: ### Required:
- `token` (string) - Your access token for the Atlas API. This can be - `token` (string) - Your access token for the Atlas API.
generated on your [tokens
page](https://atlas.hashicorp.com/settings/tokens). Alternatively you can -> Login to Atlas to [generate an Atlas Token](https://atlas.hashicorp.com/settings/tokens). The most convenient way to configure your token is to set it to the `ATLAS_TOKEN` environment variable, but you can also use `token` configuration option.
export your Atlas token as an environmental variable and remove it from
the configuration.
- `artifact` (string) - The shorthand tag for your artifact that maps to - `artifact` (string) - The shorthand tag for your artifact that maps to
Atlas, i.e `hashicorp/foobar` for `atlas.hashicorp.com/hashicorp/foobar`. Atlas, i.e `hashicorp/foobar` for `atlas.hashicorp.com/hashicorp/foobar`.
You must have access to the organization, hashicorp in this example, in You must have access to the organization—hashicorp in this example—in
order to add an artifact to the organization in Atlas. order to add an artifact to the organization in Atlas.
- `artifact_type` (string) - For uploading AMIs to Atlas, `artifact_type` will - `artifact_type` (string) - For uploading AMIs to Atlas, `artifact_type` will
always be `amazon.ami`. This field must be defined because Atlas can host always be `amazon.ami`. This field must be defined because Atlas can host
other artifact types, such as Vagrant boxes. other artifact types, such as Vagrant boxes.
-> **Note:** If you want to upload Vagrant boxes to Atlas, use the [Atlas
post-processor](/docs/post-processors/atlas.html).
### Optional: ### Optional:
- `atlas_url` (string) - Override the base URL for Atlas. This is useful if - `atlas_url` (string) - Override the base URL for Atlas. This is useful if
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment