2016-05-18 20:31:16 -04:00
|
|
|
---
|
2017-06-14 21:04:16 -04:00
|
|
|
description: |
|
|
|
|
The checksum post-processor computes specified checksum for the artifact list
|
|
|
|
from an upstream builder or post-processor. All downstream post-processors
|
|
|
|
will see the new artifacts. The primary use-case is compute checksum for
|
|
|
|
artifacts allows to verify it later. So firstly this post-processor get
|
|
|
|
artifact, compute it checksum and pass to next post-processor original
|
|
|
|
artifacts and checksum files.
|
2016-05-18 20:31:16 -04:00
|
|
|
layout: docs
|
2017-06-14 21:04:16 -04:00
|
|
|
page_title: 'Checksum - Post-Processors'
|
|
|
|
sidebar_current: 'docs-post-processors-checksum'
|
2017-03-25 18:13:52 -04:00
|
|
|
---
|
2016-05-18 20:31:16 -04:00
|
|
|
|
|
|
|
# Checksum Post-Processor
|
|
|
|
|
|
|
|
Type: `checksum`
|
|
|
|
|
|
|
|
The checksum post-processor computes specified checksum for the artifact list
|
|
|
|
from an upstream builder or post-processor. All downstream post-processors will
|
|
|
|
see the new artifacts. The primary use-case is compute checksum for artifact to
|
|
|
|
verify it later.
|
|
|
|
|
|
|
|
After computes checksum for artifacts, you can use new artifacts with other
|
|
|
|
post-processors like
|
|
|
|
[artifice](https://www.packer.io/docs/post-processors/artifice.html),
|
|
|
|
[compress](https://www.packer.io/docs/post-processors/compress.html),
|
|
|
|
[docker-push](https://www.packer.io/docs/post-processors/docker-push.html),
|
|
|
|
[atlas](https://www.packer.io/docs/post-processors/atlas.html), or a third-party
|
|
|
|
post-processor.
|
|
|
|
|
|
|
|
## Basic example
|
|
|
|
|
|
|
|
The example below is fully functional.
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
``` json
|
2016-05-18 20:31:16 -04:00
|
|
|
{
|
2017-03-25 18:13:52 -04:00
|
|
|
"type": "checksum"
|
2016-05-18 20:31:16 -04:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
## Configuration Reference
|
|
|
|
|
|
|
|
Optional parameters:
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `checksum_types` (array of strings) - An array of strings of checksum types
|
|
|
|
to compute. Allowed values are md5, sha1, sha224, sha256, sha384, sha512.
|
|
|
|
- `output` (string) - Specify filename to store checksums. This defaults to
|
2017-04-20 02:26:49 -04:00
|
|
|
`packer_{{.BuildName}}_{{.BuilderType}}_{{.ChecksumType}}.checksum`. For
|
|
|
|
example, if you had a builder named `database`, you might see the file
|
|
|
|
written as `packer_database_docker_md5.checksum`. The following variables are
|
|
|
|
available to use in the output template:
|
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `BuildName`: The name of the builder that produced the artifact.
|
|
|
|
- `BuilderType`: The type of builder used to produce the artifact.
|
|
|
|
- `ChecksumType`: The type of checksums the file contains. This should be
|
2017-04-20 02:26:49 -04:00
|
|
|
used if you have more than one value in `checksum_types`.
|