From 6b80075db0a2846572264623d7d85cc35b42abf4 Mon Sep 17 00:00:00 2001 From: DanHam Date: Thu, 29 Aug 2019 17:53:06 +0100 Subject: [PATCH] Docs: Add `run_volume_tags` option to the ebsvolume docs * Add note explaining temp override of `ebs_volumes` tags when the instance is initially created --- .../builders/amazon-ebsvolume.html.md.erb | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/website/source/docs/builders/amazon-ebsvolume.html.md.erb b/website/source/docs/builders/amazon-ebsvolume.html.md.erb index e11321e4d..30e52cfab 100644 --- a/website/source/docs/builders/amazon-ebsvolume.html.md.erb +++ b/website/source/docs/builders/amazon-ebsvolume.html.md.erb @@ -108,6 +108,12 @@ builder. engine](/docs/templates/engine.html), see [Build template data](#build-template-data) for more information. + Note: The tags specified here may be *temporarily* overridden by + those specified in `run_volume_tags` - but only while the instance + is being created. Packer will replace all tags on the volume with + those configured here as soon as the instance is reported as + 'ready'. + - `associate_public_ip_address` (boolean) - If using a non-default VPC, public IP addresses are not provided by default. If this is `true`, your new instance will get a Public IP. Default: `false`. @@ -210,6 +216,19 @@ builder. engine](/docs/templates/engine.html), see [Build template data](#build-template-data) for more information. +- `run_volume_tags` (object of key/value strings) - Tags to apply to the + volumes of the instance that is *launched* to create EBS Volumes. These + tags will *not* appear in the tags of the resulting EBS volumes unless + they're duplicated under `tags` in the `ebs_volumes` setting. This is a + [template engine](/docs/templates/engine.html), see [Build template + data](#build-template-data) for more information. + + Note: The tags specified here will be *temporarily* applied to volumes + specified in `ebs_volumes` - but only while the instance is being + created. Packer will replace all tags on the volume with the tags + configured in the `ebs_volumes` section as soon as the instance is + reported as 'ready'. + - `security_group_id` (string) - The ID (*not* the name) of the security group to assign to the instance. By default this is not set and Packer will automatically create a new temporary security group to allow SSH access.