Merge "Add new restore_extra_items option to restore"

This commit is contained in:
Zuul 2024-10-01 13:43:46 +00:00 committed by Gerrit Code Review
commit 5849fe8527

View File

@ -225,6 +225,27 @@ Below you can find other ``-e`` command line options:
-e restore_mode=optimized \
-e "@/path/to/restore_overrides.yaml"
``-e restore_extra_items``
Enables the restore playbook to extract additional items from the backup
during its execution. This is useful when the user has unmanaged files that
are not included in a normal restore operation.
The following is an example of restoring some files that had been manually
modified on the system pre-backup:
.. code-block::
ansible-playbook /usr/share/ansible/stx-ansible/playbooks/restore_platform.yml \
-e "initial_backup_dir=/home/sysadmin" \
-e "backup_filename=localhost_platform_backup_2024_08_12_22_58_21.tgz"
-e '{"restore_extra_items": ["etc/pam.d/common-auth", "etc/security/group.conf"]}'
.. note::
The ``restore_extra_items`` option will restore files only on
controller-0. The user must restore files on other nodes after they
are reinstalled, if required.
**Legacy**
``-e skip_patching=true``