cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add docs clarifying behavior of retry files (#65153)

Browse source
This commit is contained in:
Sam Doran 2019-11-25 14:26:46 -05:00 committed by Sandra McCann
parent c1f280ba6e
commit 0471ed3731
2 changed files with 7 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
docs/docsite/rst/user_guide/intro_patterns.rst
View file

@ -153,6 +153,10 @@ Finally, you can use ``--limit`` to read the list of hosts from a file by prefix
ansible-playbook site.yml --limit @retry_hosts.txt ansible-playbook site.yml --limit @retry_hosts.txt
If :ref:`RETRY_FILES_ENABLED` is set to ``True``, a ``.retry`` file will be created after the ``ansible-playbook`` run containing a list of failed hosts from all plays. This file is overwritten each time ``ansible-playook`` finishes running.
ansible-playbook site.yml --limit @site.retry
To apply your knowledge of patterns with Ansible commands and playbooks, read :ref:`intro_adhoc` and :ref:`playbooks_intro`. To apply your knowledge of patterns with Ansible commands and playbooks, read :ref:`intro_adhoc` and :ref:`playbooks_intro`.
.. seealso:: .. seealso::

4
lib/ansible/config/base.yml
View file

@ -1754,7 +1754,9 @@ RETRY_FILES_ENABLED:
RETRY_FILES_SAVE_PATH: RETRY_FILES_SAVE_PATH:
name: Retry files path name: Retry files path
default: ~ default: ~
description: This sets the path in which Ansible will save .retry files when a playbook fails and retry files are enabled. description:
- This sets the path in which Ansible will save .retry files when a playbook fails and retry files are enabled.
- This file will be overwritten after each run with the list of failed hosts from all plays.
env: [{name: ANSIBLE_RETRY_FILES_SAVE_PATH}] env: [{name: ANSIBLE_RETRY_FILES_SAVE_PATH}]
ini: ini:
- {key: retry_files_save_path, section: defaults} - {key: retry_files_save_path, section: defaults}