Commit Graph

425 Commits

Author SHA1 Message Date
Richard Nienaber 2cfbb83b70 fix typo 2018-04-24 10:36:54 +01:00
Richard Nienaber db65c99bf4 update code based on master and update docs 2018-04-24 10:35:27 +01:00
Megan Marsh 6da6ea74de add warning to generated feature in file provisioner 2018-04-05 16:12:20 -07:00
M. Marsh 56dd8cdb63
Merge pull request #3891 from nouney/f-generated-files
Add "generated" file tag to allow users to upload files created on the fly.
2018-04-05 16:08:38 -07:00
Megan Marsh bb53d5f6cc update docs to include Azure. 2018-04-05 15:26:19 -07:00
Omer Katz c0719a3590
Allow using a custom inventory file. 2018-04-05 12:56:07 +03:00
vkatsikaros 8fdd20ec2d
Add simpler example for chef client in local mode
The existing documentation example looks intimidating as it includes:
* variable interpolation
* configuration of the chef provisioner
* and it misses the `config_template` file
In the issue comments, [simpler and complete example](https://github.com/hashicorp/packer/issues/3355#issuecomment-198134727) exists already and works out of the box.

This change adds the simpler and complete example, while leaving the more complicated example intact.
2018-04-03 16:29:51 +03:00
Megan Marsh 072cd6b745
Merge pull request #5998 from hashicorp/do_5895
allow users of AWS to use the dynamically-generated admin password wh…
2018-03-22 16:01:22 -07:00
Petr Ruzicka 7112212b2f Adding details to PACKER_BUILD_NAME to have it clear in the documentation how the variable is created 2018-03-21 07:58:53 +01:00
Megan Marsh f3dc7546d4 even clearer example in winrmpassword docs 2018-03-16 14:28:20 -07:00
Megan Marsh de7d1430bd update powershell docs to include reference to the new winrmpassword template variable 2018-03-16 14:25:09 -07:00
Megan Marsh 414dd80e61
Merge pull request #6013 from jsoref/spelling
Spelling
2018-03-14 09:50:27 -07:00
Megan Marsh e2f55a50b5
Merge pull request #5702 from brokenbot/salt-masterless-windows
Windows Support for salt-masterless provisioner #5432
2018-03-13 14:26:40 -07:00
Josh Soref c38cdd0439 spelling: administrator 2018-03-13 07:06:52 +00:00
SwampDragons 1cca06e5bf
Merge branch 'master' into website-docs-windows-restart 2018-02-15 14:33:49 -08:00
DanHam 49f9d31837
Update docs to explain new auto escape of chars special to PowerShell 2018-02-08 23:15:15 +00:00
DanHam e982bc4ea5
Fix copy/paste of description from shell provisioner 2018-02-08 12:03:18 +00:00
DanHam 2b1aa04583
Update docs to reflect new upload and dot source of env var for std ps cmd 2018-02-08 12:03:18 +00:00
Megan Marsh addedbb680 Revert "Merge pull request #5515 from DanHam/dot-source-env-vars"
revert so we can use a branch that's had more recent work done
This reverts commit e56849c605, reversing
changes made to 6d14eb6ea4.
2018-02-02 09:58:39 -08:00
SwampDragons e56849c605
Merge pull request #5515 from DanHam/dot-source-env-vars
Extend upload and subsequent dot sourcing of env vars to non-elevated Powershell cmd
2018-02-01 13:06:01 -08:00
Matthew Hooker 9f87213ba4
tests and docs for #5831 2018-01-31 13:08:25 -08:00
Gennady Lipenkov 53aaf84100 Support 'trusted_certs_dir' chef-client configuration option 2018-01-13 01:53:49 +03:00
Dave Sanderson 666796e8eb Add ability to stat a remote path 2017-12-12 14:39:13 -07:00
SwampDragons 753d3cf216
Merge pull request #5618 from kwilczynski/ansible-local-clean-staging-directory
ansible-local: Add ability to clean staging directory.
2017-11-30 14:27:59 -08:00
Matthew Hooker ff3efb4641
remove trailing spaces 2017-11-27 17:26:03 -08:00
Matthew Hooker be3fe340c8
add a section about uploading files that don't exist. 2017-11-27 17:23:31 -08:00
SwampDragons e990e49711
Merge pull request #5638 from hashicorp/docs_5623
Docs 5623
2017-11-27 16:58:24 -08:00
Megan Marsh a325780aa5 make description match 2017-11-27 15:18:58 -08:00
Megan Marsh df492d35bf remove confusing use of local. dang. 2017-11-27 15:17:54 -08:00
Megan Marsh 150bf1f6da clarify shell-local location 2017-11-27 15:15:52 -08:00
Megan Marsh 52f5f2b895 clarify where ansible-local runs 2017-11-27 15:10:29 -08:00
Ilon Sjögren 0dae5bc8bd Should state that file provisioner requires source at execution time 2017-11-22 09:13:47 +01:00
Krzysztof Wilczynski 10370adbab
ansible-local: Add ability to clean staging directory.
Signed-off-by: Krzysztof Wilczynski <kw@linux.com>
2017-11-21 21:09:01 +01:00
Matthew Hooker 97ef340423
fix type 2017-11-14 16:43:57 -08:00
Brett Richardson 9eacd3d618
Update chef provisioner documentation
The URL has changed, see chef documentation https://docs.chef.io/install_omnibus.html
2017-11-14 13:54:13 +00:00
Megan Marsh b52ba4557e add some example json to windows restart_check_command 2017-11-07 16:00:40 -08:00
DanHam 3cdc79de6a
Update docs to reflect new upload and dot source of env var for std ps cmd 2017-10-30 21:08:14 +00:00
Marcel Prince 8244d8bfb9 Arguments sorting for Puppet provisioners docs 2017-10-17 08:25:40 -07:00
Matthew Aynalem 3716effa75 docs: correct datatype inconsistencies bool => boolean (issue #5468) 2017-10-16 09:19:59 -07:00
Matthew Hooker 0608fe4823
mention that winrm can transfer files slowly. 2017-10-11 23:12:31 -07:00
Matthew Aynalem 1fac839b79 docs fix minor spelling typos throughout docs 2017-10-04 14:25:31 -07:00
Matthew Hooker e26df7ebb3
remove outdated comment about docker behavior 2017-10-03 16:47:30 -07:00
Matthew Hooker bafcf7dfb1
test, document, cleanup puppet guest codde 2017-10-03 11:39:33 -07:00
Megan Marsh ae6dae2726 add quoteless option to sudo example 2017-09-27 16:02:18 -07:00
DanHam b7bb6b54b4 Update docs with new defaults for Powershell commands 2017-09-26 11:07:38 +01:00
Megan Marsh f71a25c7a7 Merge pull request #5345 from hashicorp/elevated_vars_4994
Elevated vars 4994
2017-09-15 09:12:58 -07:00
Megan Marsh 5d63f01fed Update docs for elevated_execute_command with new default command 2017-09-15 08:14:12 -07:00
Matthew Hooker e8c54cb496
docs: update default value for `expect_disconnect` 2017-09-14 17:49:34 -07:00
Megan Marsh f86d45eaf6 fix docs for execute_command and elevated_execute_command 2017-09-14 10:50:38 -07:00
Daniel Compton b754862fd8 Add troubleshooting steps to Ansible provisioner docs
- Explain how to enable verbose Ansible output
- Add docs about the perils of having loaded too many SSH keys to ssh-agent
2017-09-10 21:03:06 +12:00
Matthew Hooker 2a0a8cb8fa Merge pull request #5104 from lfarnell/bug-5100
Added ansible-galaxy command to docs
2017-09-02 14:31:17 -07:00
c22 bc2e3de06d Resolve merge conflicts and update documentation. 2017-08-22 14:10:37 +10:00
c22 80ba99c04f Update documentation + small fixes
Updated the puppet-masterless documentation
Removed extraneous ConfigTemplate code
2017-08-22 14:10:37 +10:00
c22 1c592f291e Better Windows support in puppet-server
Reworking the puppet-server provisioner based on chef-client.
2017-08-22 14:10:37 +10:00
Matthew Hooker c2f142eea3 Merge pull request #5133 from mayn/fix-docs-provisioners-salt-masterless
docs salt-masterless provisioner - move required element out of optional elements section
2017-07-28 13:09:02 -07:00
Matthew Aynalem d08e47a853 docs salt-masterless provisioner - move required element out of optional elements section 2017-07-16 16:26:31 -07:00
Matthew Aynalem eaccfce29e move period outside of quotation marks designating an attribute value. 2017-07-12 15:03:06 -07:00
localghost 1bd32d3876 Add documentation about playbook_files option of ansible-local provisioner. 2017-07-09 20:04:01 +02:00
Luke Farnell bc2c60021e Added ansible-galaxy command to docs 2017-07-06 21:09:23 -04:00
Matthew Hooker 56979a1974
Revert "Universally provide POSIX semantics for the `shell` provisioner."
This reverts commit 1ba7f9cc20.
2017-06-21 16:11:47 -07:00
Matthew Hooker bcc0d24bf4
run docs through pandoc 2017-06-14 18:13:46 -07:00
Matthew Hooker 11379dea70 Merge pull request #5009 from sjlamerton/salt_bin_dir
Add support for salt_bin_dir
2017-06-13 10:21:53 -07:00
Matthew Hooker 8f685b3bcd
ansible: add skip_version_check flag 2017-06-07 13:31:56 -07:00
Matthew Hooker 70b3d05fb3 Merge pull request #4760 from fajpunk/ansible-inventory-dir
inventory_directory option for ansible provisioner
2017-06-07 11:22:23 -07:00
Steven Lamerton e953898890 Add support for salt_bin_dir
Allows specifying the path to salt-call, useful if it isn't on the
path.
2017-06-07 08:16:23 +01:00
Matthew Hooker bc16c13b50 Merge pull request #4961 from magicalbob/grains
Grains
2017-06-06 12:37:18 -07:00
Matthew Hooker c4ec705791 fix markdown 2017-06-06 12:35:48 -07:00
Ian Ellis d156c41e3a Added docs for grains_file config item of salt-masterless provisioner 2017-06-06 07:12:44 +01:00
Matthew Hooker 74bf0b636b Merge pull request #4791 from optix2000/master
Add version selection for chef-solo provisioner
2017-06-05 15:30:48 -07:00
Sean Chittenden 1ba7f9cc20
Universally provide POSIX semantics for the `shell` provisioner.
All platforms everywhere have `env(1)` available, leverage it
accordingly.

Improves on: #2343
2017-05-20 09:28:02 -07:00
Dan Fuchs 8401057ed5 Merge branch 'master' into ansible-inventory-dir 2017-04-26 13:20:00 -05:00
Rickard von Essen 7b5c56bff4
ansible-local/ansible: Clearify docs regarding `extra_arguments`
Closes: #4822
2017-04-23 12:56:31 +02:00
Rickard von Essen 999f2da499
ansible-local/ansible: Add extra-vars packer_*
Added:
- `packer_build_name`
- `packer_builder_type`
- `packer_http_addr` - `ansible-local` only

Closes: #4820
2017-04-23 12:55:01 +02:00
Dan Fuchs 97c819dc15 Merge branch 'master' of https://github.com/mitchellh/packer into ansible-inventory-dir 2017-04-20 10:34:03 -05:00
Weilu Jia 943563e957 Update chef-solo documentation to match latest changes 2017-04-12 16:30:07 -07:00
Weilu Jia 05d46c61f7 Add documentation for chef-solo version pinning 2017-04-12 16:27:59 -07:00
Dan Fuchs 50637a68bf Clarify `inventory_directory` in ansible provisioner docs 2017-04-04 22:58:46 -05:00
Dan Fuchs 609e70face inventory_directory option for ansible provisioner
Add an `inventory_directory` setting to the Ansible provisioner that
allows a user to specify a directory in which the Packer Ansible
provisioner would write the generated inventory file.  If a value is
specified for this setting, then have the Packer Ansible provisioner
pass this directory as the -i arg when it calls ansible.

This would allow an Ansible playbook used by the Packer Ansible
provisioner to use variables specified in `host_vars` and `group_vars`
in this inventory directory.
2017-04-04 16:43:46 -05:00
Matthew Hooker 589f8b72dc
provisioner/ansible-local: document staging dir
We made the staging directory random earlier, so let's document it properly.
2017-04-04 12:01:32 -07:00
Anton Kvashenkin fe3cdf5fe4 Merge branch 'master' into website-docs-windows-restart 2017-04-03 22:06:26 +03:00
Seth Vargo 38e0ba8bd3
Fix broken links 2017-03-28 18:28:34 -04:00
Seth Vargo 6b80c21043
Revamp pages and docs to fit HashiCorp brand 2017-03-28 16:05:19 -04:00
Anton Kvashenkin d189676ff0 Website/docs: make windows-restart provisioner description more accurate
As per https://github.com/mitchellh/packer/blob/master/provisioner/windows-restart/provisioner.go#L16
windows-restart doesn't stop winrm prior to restart host.
2017-03-12 12:48:08 +03:00
Matthew Hooker f8a8952231
website/docs: fix file upload tar script 2017-03-09 17:39:46 -08:00
Matthew Hooker 322eeeb4ac
website/docs: make file provisioner reqs clearer
Make extra clear the file provisioner needs destination directory to exist.
2017-03-09 17:30:09 -08:00
Matthew Hooker e63a646afe
website/docs: note docker behavior in file provisioner 2017-03-09 16:32:01 -08:00
Matthew Hooker 26f9c61137
spellfix 2017-03-01 15:45:29 -08:00
Matthew Hooker 3c290f7c7e
docs/ansible-local: playbook_paths clarification 2017-02-10 00:01:09 -08:00
Matthew Hooker df440f7877 Merge pull request #4477 from mitchellh/ansibleremoteuserno
docs/ansible: clarify that we ignore remote_user
2017-02-01 22:02:29 -08:00
Matthew Hooker 9ab148e56d Merge pull request #4476 from mitchellh/ansicolor
ansible does its own coloring.
2017-02-01 22:02:08 -08:00
Matthew Hooker eec93dfca7 Merge pull request #4473 from mitchellh/symboldoc
document how we upload symbolic links
2017-02-01 22:01:49 -08:00
Rickard von Essen 4ffbfde09b
s/communicator/connection plugin/ to align with Ansible nomenclature 2017-01-30 12:11:48 +01:00
Rickard von Essen a5171fef4d
provisioner/ansible: Add documentation howto use with chroot
Closes #3583
2017-01-30 12:09:55 +01:00
Matthew Hooker d46d5ea2fb
docs/ansible: clarify that we ignore remote_user 2017-01-28 19:05:42 -08:00
Matthew Hooker df247a99a1
ansible does its own coloring. 2017-01-28 18:41:11 -08:00
Matthew Hooker b3db88109d
document how we upload symbolic links 2017-01-27 18:32:08 -08:00
Matthew Hooker 4dcab2fb9c
docs/provisioners/shell: safety first
make it harder to forget -e when overriding shebang. Closes #2873
2017-01-25 16:06:43 -08:00
Matthew Hooker 6563eb213c
Document. add to windows-shell and powershell 2017-01-17 17:07:36 -08:00
Matthew Hooker 5fc6a2ee70 Merge pull request #4326 from asteris-llc/feature/converge-provisioner
New Provisioner: Converge
2017-01-04 10:46:18 -08:00
Brian Hicks d9683c0817
website: add default note on converge bootstrap parameter 2017-01-04 12:12:35 -05:00
Sean Malloy bd0985cde8 Do not escape quotes 2016-12-29 23:25:34 -06:00
Sean Malloy 01b5a824f3 Clean up puppet provisioner documentation
Clarify that the puppet_bin_dir options is the
path to the directory that contains the puppet
binary. Update default execute command. Clarify
that the client_cert_path and the client_private_key_path
options are paths to directories not regular files.
2016-12-28 22:33:44 -06:00
Rickard von Essen cda83dc93a
provisioner/puppet-server: Fixed formatting for execute_command 2016-12-28 21:43:57 +01:00
Brian Hicks feab6f096e
provisioner(converge): add prevent_bootstrap_sudo 2016-12-28 12:53:22 -06:00
Brian Hicks fb6a5c5bbc
provisioner(converge): change skip_bootstrap back to bootstrap 2016-12-28 12:49:40 -06:00
Brian Hicks 18425c45d0
provisioner(converge): change bootstrap to skip_bootstrap 2016-12-28 08:48:02 -06:00
Brian Hicks 5d935767f0
provisioner(converge): add bootstrap_command 2016-12-28 08:45:19 -06:00
Brian Hicks 843731d98d
provisioner(converge): add prevent_sudo 2016-12-28 08:19:03 -06:00
Brian Hicks 30a393d4c2
provisioner(converge): update documentation with new schema 2016-12-27 16:50:44 -06:00
Brian Hicks 6365e40126
provisioners(converge): document 2016-12-27 15:57:11 -06:00
Sean Malloy 7feb8b993c Add default facts for puppet-server provisioner 2016-12-22 15:53:59 -06:00
Rickard von Essen d3c2239b9e
builder/amazon: Change shutdown_behaviour to shutdown_behavior 2016-12-14 21:59:16 +01:00
Matthew Hooker c510988cbf Merge pull request #4209 from bhcleek/ansible-winrm
provisioner/ansible: assume scp target is file (resolves winrm incompatibility)
2016-12-08 22:37:41 -08:00
Yorgos Saslis 069592f489 Fix typo
chef-cilent => chef-client
2016-12-05 16:31:36 +02:00
Billie Cleek f5ca0de225 provisioner/ansible: assume scp target is file
Assume the scp target is a file instead of a directory. Assuming the scp
target is a file instead of a directory allows uploading files to a node
being provisioned with the ssh communciator using sftp and with the
winrm communicator. It is fully compatible with ansible; ansible
communicators only allow for files (never directories) to be uploaded
(when the copy module is used to upload a directory, ansible walks the
directory and uploads files one at a time).

Update documentation to explain how to provision a Windows image.

Extend tests that use ssh to communicate with the node to include single
files, recursive copies, and content-only recursive copies.

Add test to verify support for the winrm communicator.

Remove the err argument from adapter.scpExec, because it was unused.

Fixes #3911
2016-11-26 14:40:39 -08:00
Jasper Siepkes 200aa74e78 Added support for passing arguments to salt-call. 2016-11-11 15:15:16 +01:00
Rickard von Essen 233913bc38 Fixed misspelling of semantics 2016-11-05 13:57:57 +01:00
Maxim Fedchyshyn 77efbe572d Fixed typo at chef-solo.html.md 2016-10-26 16:41:53 -07:00
Rickard von Essen 3b42d28cce Merge pull request #4014 from mexisme/feature/puppet-bin-dir
privisioner/puppet: Add `puppet_bin_dir` option.
2016-10-22 14:48:45 +02:00
Matthew Hooker 892d5e82c9 expect_disconnect option
provisioner/shell: Adds option to fail if the remote server disconnects
us.
2016-10-21 11:39:03 -07:00
7heo 4a4d529b33 Get rid of unnecessary `-E` flag for `sudo`
In the "Execute Command Example - Sudo Example", the used command is
defining environment variables prematurely, hence requiring the sudo
invocation to be made with the `-E` flag. However, this is not only
necessary but might have indesirable side effects, as the `-E` flag
forwards the whole environment to the subshell.
2016-10-19 16:47:16 +02:00
mexisme 050306b9d0 Update docs for puppet-masterless and puppet-server provisioners 2016-10-17 09:24:56 +13:00
Matthew Hooker 09bbd0e1cd fix tense 2016-10-07 18:00:21 -07:00
Matthew Hooker 83131db4b8 Merge pull request #3776 from curiositycasualty/master
Add custom_state config to salt provisioner
2016-10-07 17:59:52 -07:00
evanstucker-hates-2fa a515c35338 Update shell.html.md
Changing to ".javascript".
2016-10-04 09:41:56 -07:00
evanstucker-hates-2fa cd10cef218 Update shell.html.md
Putting sleep after the reboot didn't work for me. It would just hang indefinitely. There's a better way, and it's "pause_before".
2016-10-04 09:19:26 -07:00
nouney ed32b6e3c6 provisioner/file: document "generated" key. 2016-09-15 22:51:27 +02:00
Billie H. Cleek 9cf476289f document ansible provisioner's option. 2016-09-13 08:18:21 -07:00
Billie H. Cleek f760ab2fd8 Make SCP the default for provisioner/ansible
Add a new option, `use_sftp` to the ansible provisioner. It's default
value is false; ansible provisioner will use SCP by default.

Refactor to consistently set all configure options for ansible
provisioner in the Prepare step.

Remove incorrect information about `ANSIBLE_HOST_KEY_CHECKING=False`
being set when `ansible_env_vars` is not set in the packer template.

Update BATS tests for the ansible provisioner to actually check that the
fetched directory contains the contents expected. This revealed a
problem with the all_options template that required adding a host to the
hosts list in the test playbook.
2016-09-11 23:58:31 -07:00
Billie H. Cleek da223b9539 add scp support to ansible provisioner
Handle running `scp -t` and `scp -f` exec requests in the
ansible-provisioner's SSH
server to allow Ansible to use SCP so that SFTP doesn't have to be
installed on the node.

Update the BATS tests to test the ansible provisioner.
2016-09-11 23:58:31 -07:00
Andy Feller 71e43abef6 Updated ansible provisioner documentation to cite situation encountered by Redhat family around sftp_command 2016-09-02 07:45:16 -04:00
Rickard von Essen d1e38052f7 Merge pull request #3350 from JoakimLofgren/add-support-for-ansible-galaxy
Add support for ansible-galaxy
2016-09-01 20:51:17 +02:00
Joakim Löfgren eee54d48f3 Add documentation for galaxy_file 2016-09-01 13:51:14 +02:00
Hal Deadman 6f8ec8bd63 fix docs to match code for puppet-server provisioner staging_dir (#3604) 2016-08-24 00:04:00 +02:00
Isa bb2dd6e2b2 add custom_state config to salt provisioner 2016-08-03 12:56:51 -07:00
Renat Zaripov b4ac9d0033 Clarifying defaults remote_path for powershell and windows-shell provisioners 2016-06-22 09:29:13 +03:00
Jamie Snell d43fa85e7b update docs to reflect knife_command change 2016-06-14 17:18:08 -05:00
Tom Asquith 40aa2b9973 added support for specifying an execute command to the puppet-server provisioner. 2016-06-13 14:12:28 +01:00
Hidekazu Tanaka 3728e076fe Fix SSH Agent Forwarding exmaple 2016-05-18 16:04:56 -07:00
Ian Duffy 7e653370b7 Seperate remote_path into remote_folder and remote_script. (#3462)
Commonly /tmp is set as noexec, as a result packer scripts
fail to run. In order to get around this one can set a
remote_path, whoever, remote path requires full filename
and path.

By making remote_path a combination of
remote_folder/remote_script we can change remote_folder
and keep the default script_nnn.sh

Signed-off-by: Ian Duffy <ian@ianduffy.ie>
2016-04-26 16:04:29 -07:00
mansunkuo 864be9d991 Modify documents of extra_arguments for both ansible(remote) and ansible-local. (#3423) 2016-04-20 20:49:46 -07:00
Chris Bednarski 90a12f7043 Clarified that windows must be fully booted in order for the restart provisioner to succeed 2016-04-20 12:34:53 -07:00
Shaun Haber efa642fe04 Add documentation for ssl_verify_mode 2016-04-01 12:35:05 -07:00
Keyan Pishdadian aee8490f68 Add docs for ignore_exit_codes param 2016-03-13 23:39:29 -04:00
Chris Bednarski 1256babce3 Change .markdown to .md because it's shorter 2016-03-11 17:06:36 -08:00
Mansun Kuo 5134faf0cc Add example of extra_arguments 2016-03-10 21:49:04 +08:00
Chris Bednarski 39ca3c292e Merge pull request #3299 from tylert/shell-doc-order
Put shell provisioner doc in 'packer fix' order
2016-03-07 18:30:29 -08:00
Rickard von Essen 7369841e63 Ansible: add the support for specifying ansible_user
Closes #3273
2016-03-07 13:35:24 +01:00
Tyler Tidman b6eaf60fda Put shell provisioner doc in 'packer fix' order 2016-03-02 14:37:30 -05:00
Vespian 4750da3457 Add empty_groups param to ansible provisioner 2016-02-19 23:46:50 +01:00