From f14c617084d03253cd0b49135d872dcf9064b051 Mon Sep 17 00:00:00 2001 From: Paul Freeman Date: Thu, 17 Sep 2015 11:59:32 +0100 Subject: [PATCH 1/2] Documentation for retry_files_enabled and retry_files_save_path --- docsite/rst/intro_configuration.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docsite/rst/intro_configuration.rst b/docsite/rst/intro_configuration.rst index 3527d77c8bb..aa64807613f 100644 --- a/docsite/rst/intro_configuration.rst +++ b/docsite/rst/intro_configuration.rst @@ -544,6 +544,27 @@ Additional paths can be provided separated by colon characters, in the same way Roles will be first searched for in the playbook directory. Should a role not be found, it will indicate all the possible paths that were searched. +.. _retry_files_enabled: + +retry_files_enabled +=================== + +This controls whether a failed Ansible playbook should create a .retry file. The default setting is True:: + + retry_files_enabled = False + +.. _retry_files_save_path: + +retry_files_save_path +===================== + +The retry files save path is where Ansible will save .retry files when a playbook fails and retry_files_enabled is True (the default). +The default location is ~/ and can be changed to any writeable path:: + + retry_files_save_path = ~/.ansible-retry + +The directory will be created if it does not already exist. + .. _sudo_exe: sudo_exe From 87fc5640d4787ca3eba255913410523ef0ae1cf7 Mon Sep 17 00:00:00 2001 From: Paul Freeman Date: Thu, 17 Sep 2015 12:05:46 +0100 Subject: [PATCH 2/2] Comments to explain retry_files_enabled and retry_files_save_path --- examples/ansible.cfg | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/examples/ansible.cfg b/examples/ansible.cfg index a1faa6fa66a..e79fa4ee841 100644 --- a/examples/ansible.cfg +++ b/examples/ansible.cfg @@ -170,6 +170,10 @@ fact_caching = memory # retry files +# When a playbook fails by default a .retry file will be created in ~/ +# You can disable this feature by setting retry_files_enabled to False +# and you can change the location of the files by setting retry_files_save_path + #retry_files_enabled = False #retry_files_save_path = ~/.ansible-retry