haskal
/
vagrant
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
vagrant/plugins
History
Gilles Cornu 8834afbd8e
provisioners/ansible(both): Add compatibility mode 
With this change, it is now possible to get rid of many deprecation
messages successively introduced in Ansible 1.9, and 2.0. More
interesting, the generated inventory will contain the recommended
variable names (e.g. `ansible_host` instead of `ansible_ssh_host`)
when the compatibility mode is set to '2.0'.

Details:

- Add `compatibility_mode` option to control the Ansible parameters
  format to be used. The value corresponds to the minimal version
  supported. For the moment, possible values are '1.8' (corresponding to
  Vagrant's former behaviour) or '2.0'.
  Note that a dynamic inventory generated in compatibility mode '2.0'
  is not supported by Ansible 1.x. On the other hand, Ansible 2.x so far
  supports inventory format generated by the compatibility mode '1.8'.

- Add compatibility mode auto-detection, based on the available Ansible
  version. This is the default behaviour in order to bring a maximum of
  user friendliness. The drawback of this approach is to let potential
  compatibility breaking risks, for `ansible` provisioner setups that
  already integrate Ansible 2.x **AND** rely on the existence of
  the generated `_ssh` variable names. Thanks to the vagrant warnings
  (and its release notes), I argue that it is worth to offer
  auto-detection by default, which offers a sweet transition to most
  users.

- Add `become`, `become_user` and `ask_become_pass` options and their
  backwards compatible aliases. The legacy options are now deprecated.

Note that we intentionally didn't provide a '1.9' compatibility mode,
as it would add extra-complexity for practically no added-value.
To my knowledge, the Ansible 2.x series haven't introduced yet any major
changes or deprecations that would motivate to introduce a higher
version compatibility mode (to be confirmed/verified).

Resolve GH-6570

Still Pending:

- Optimization: Reduce the number of `ansible` command executions.
  Currently two exec calls will be performed when the compatibility
  mode auto-detection is enabled (i.e. by default). We could make the
  provisioner a little bit smarter to only execute `ansible` only once
  in any situation (by combining "presence" and "version" checks).

- User-friendliness: Add better validator on `compatibility_mode`
  option, and shows a warning or an error instead of the silent
  fallback on the auto-detection modus.

- Test coverage: All the added behaviours are not fully covered yet.
 		2017-09-06 17:12:22 +02:00
..
commands command/login: Fix typo in server_error 2017-08-30 10:39:58 -04:00
communicators (#8933) Align file provisioner functionality on all platforms 2017-08-31 15:57:53 -07:00
guests (#8917) Fix shell_expand_guest_path capability 2017-08-25 10:02:36 -07:00
hosts Invoke tee from specific path 2017-06-29 16:11:18 -07:00
kernel_v1 Support environment variable forwarding, fixes #4131 2015-11-19 16:25:54 -08:00
kernel_v2 (#8697) Introduce extra_args setting for ssh configs 2017-08-17 09:02:20 -07:00
providers Error when compose and force_host_vm are enabled together 2017-08-22 11:36:26 -07:00
provisioners provisioners/ansible(both): Add compatibility mode 2017-09-06 17:12:22 +02:00
pushes Isolate push deprecation to atlas strategy only 2017-03-21 15:08:17 -07:00
synced_folders Format host address for rsync when IPv6 2017-07-31 15:44:37 -07:00
README.md Add README to plugin directory 2012-04-18 17:48:06 -07:00

README.md

Vagrant Core Plugins

These are plugins that ship with Vagrant. Vagrant core uses its own plugin system to power a lot of the core pieces that ship with Vagrant. Each plugin will have its own README which explains its specific role.