Merge pull request #992 from oxyc/ansible-args-cli

Followup #820: Pass ansible arguments via environment variable if provided.

Vagrantfile

@@ -129,6 +129,7 @@ Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
         config_dir: host_config_dir,
         drupalvm_env: drupalvm_env
       }
+      ansible.raw_arguments = ENV['DRUPALVM_ANSIBLE_ARGS']
     end
   else
     config.vm.provision 'ansible_local' do |ansible|
@@ -137,6 +138,7 @@ Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
         config_dir: guest_config_dir,
         drupalvm_env: drupalvm_env
       }
+      ansible.raw_arguments = ENV['DRUPALVM_ANSIBLE_ARGS']
     end
   end
 

docs/other/overriding-configurations.md

@@ -106,3 +106,27 @@ end
 ```
 
 _For additional configuration options read [Vagrant Proxyconf's README](https://github.com/tmatilai/vagrant-proxyconf#readme)._
+
+## Passing arguments to ansible during a provision
+
+You can specify an additional argument to the `ansible-playbook` command by using the `DRUPALVM_ANSIBLE_ARGS` environment variable. This can be useful when debugging a task failure.
+
+_Currently this feature has two quirks. It's only possible to pass on a single argument. You should not quote a flag's value as you would normally do in the shell._
+
+Display verbose ansible output:
+
+```sh
+DRUPALVM_ANSIBLE_ARGS='--verbose' vagrant provision
+```
+
+Begin the provisioning at a particular task:
+
+```sh
+DRUPALVM_ANSIBLE_ARGS='--start-at-task=*post-provision shell*' vagrant provision
+```
+
+Override a config variable:
+
+```sh
+DRUPALVM_ANSIBLE_ARGS='--extra-vars=drupalvm_database=pgsql' vagrant provision
+```