diff --git a/website/source/docs/commands/index.html.md b/website/source/docs/commands/index.html.md index 63543c134..36cee1383 100644 --- a/website/source/docs/commands/index.html.md +++ b/website/source/docs/commands/index.html.md @@ -78,14 +78,14 @@ Each component is explained below: - `timestamp` is a Unix timestamp in UTC of when the message was printed. -- `target` is the target of the following output. This is empty if the message - is related to Packer globally. Otherwise, this is generally a build name so - you can relate output to a specific build while parallel builds are running. -- `type` is the type of machine-readable message being outputted. There are a - set of standard types which are covered later, but each component of Packer - (builders, provisioners, etc.) may output their own custom types as well, - allowing the machine-readable output to be infinitely flexible. +- `target` When you call `packer build` this can be either empty or individual + build names, e.g. `amazon-ebs`. It is normally empty when builds are in + progress, and the build name when artifacts of particular builds are being + referred to. + +- `type` is the type of machine-readable message being outputted. The two most + common `type`s are `ui` and `artifact` - `data` is zero or more comma-separated values associated with the prior type. The exact amount and meaning of this data is type-dependent, so you must read @@ -101,11 +101,58 @@ become a literal `\r`. ### Machine-Readable Message Types -The set of machine-readable message types can be found in the -[machine-readable format](/docs/commands/index.html) complete -documentation section. This section contains documentation on all the message -types exposed by Packer core as well as all the components that ship with -Packer by default. +Here's an incomplete list of types you may see in the machine-readable output: + +You'll see these data types when you run `packer build`: + +- `ui`: this means that the information being provided is a human-readable string + that would be sent to stdout even if we aren't in machine-readable mode. There + are three "data" subtypes associated with this type: + + - `say`: in a non-machine-readable format, this would be bolded. Normally it is + used for anouncements about beginning new steps in the build process + + - `message`: the most commonly used message type, used for basic updates during + the build process. + + - `error`: reserved for errors + +- `artifact-count`: This data type tells you how many artifacts a particular + build produced. + +- `artifact`: This data type tells you information about what Packer created + during its build. An example of output follows the pattern + `timestamp, buildname, artifact, artifact_number, key, value` where `key` and + `value` contain information about the artifact. + + For example: + + ``` + 1539967803,,ui,say,\n==> Builds finished. The artifacts of successful builds are: + 1539967803,amazon-ebs,artifact-count,2 + 1539967803,amazon-ebs,artifact,0,builder-id,mitchellh.amazonebs + 1539967803,amazon-ebs,artifact,0,id,eu-west-1:ami-04d23aca8bdd36e30 + 1539967803,amazon-ebs,artifact,0,string,AMIs were created:\neu-west-1: ami-04d23aca8bdd36e30\n + 1539967803,amazon-ebs,artifact,0,files-count,0 + 1539967803,amazon-ebs,artifact,0,end + 1539967803,,ui,say,--> amazon-ebs: AMIs were created:\neu-west-1: ami-04d23aca8bdd36e30\n + 1539967803,amazon-ebs,artifact,1,builder-id, + 1539967803,amazon-ebs,artifact,1,id, + 1539967803,amazon-ebs,artifact,1,string, + 1539967803,amazon-ebs,artifact,1,files-count,0 + 2018/10/19 09:50:03 waiting for all plugin processes to complete... + 1539967803,amazon-ebs,artifact,1,end + ``` + +You'll see these data types when you run `packer version`: + +- `version`: what version of Packer is running + +- `version-prerelease`: Data will contain `dev` if version is prerelease, and + otherwise will be blank. + +- `version-commit`: The git hash for the commit that the branch of Packer is + currently on; most useful for Packer developers. ## Autocompletion