From 6da6ea74de37e1be37fd3ef99424ef6c79c41d92 Mon Sep 17 00:00:00 2001 From: Megan Marsh Date: Thu, 5 Apr 2018 16:12:20 -0700 Subject: [PATCH] add warning to generated feature in file provisioner --- website/source/docs/provisioners/file.html.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/website/source/docs/provisioners/file.html.md b/website/source/docs/provisioners/file.html.md index 0dc2e1d01..d2baa868b 100644 --- a/website/source/docs/provisioners/file.html.md +++ b/website/source/docs/provisioners/file.html.md @@ -48,8 +48,13 @@ The available configuration options are listed below. All elements are required. "upload". If it is set to "download" then the file "source" in the machine will be downloaded locally to "destination" -- `generated` (boolean) - If true, check the file existence only before uploading. - This allows to upload files created on-the-fly. This defaults to false. +- `generated` (boolean) - For advanced users only. If true, check the file + existence only before uploading, rather than upon pre-build validation. + This allows to upload files created on-the-fly. This defaults to false. We + don't recommend using this feature, since it can cause Packer to become + dependent on system state. We would prefer you generate your files before + the Packer run, but realize that there are situations where this may be + unavoidable. ## Directory Uploads