Ansible Role Restore

This role is designed to help you restore objects on your system.

GitHub	Version	Issues	Pull Requests	Downloads

Example Playbook

Here's an example from molecule/default/converge.yml, tested with each update.

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  roles:
    - role: buluma.restore

Before running this, you need to prepare the machine. In CI, this is done with molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  gather_facts: false
  become: true

  roles:
    - role: buluma.bootstrap
    - role: buluma.core_dependencies
    - role: buluma.mysql
    - role: buluma.buildtools
    - role: buluma.epel
    - role: buluma.python_pip
    - role: buluma.postgres

For more details and examples, see this explanation.

Role Variables

Default variable values are in defaults/main.yml:

---
# Defaults for restore

# Directory where the objects to be restored are saved.
restore_directory: backups

# Temporary location for the objects on the managed node.
restore_remote_directory: /tmp

# MySQL login credentials, required only if restoring MySQL objects.
# restore_mysql_username: "my_user"
# restore_mysql_password: "my_pass"

# List of objects to restore, with the following structure:
# - name: local name of the object
#   type: either "directory" or "mysql"
#   destination: where to place the unpacked object
#
# Note: The [backup role](http://galaxy.ansible.com/buluma/backup) can create restore-friendly objects.
# The objects created include the parent directory, so the destination may miss the last part.

restore_objects:
  - name: varspool
    type: directory
    destination: /var
#  - name: drupal
#    type: mysql
#    destination: drupal

Requirements

• Python packages listed in requirements.txt.

State of Used Roles

These roles help prepare the system. You can use other methods too.

Requirement	GitHub	Version
buluma.backup
buluma.bootstrap
buluma.core_dependencies
buluma.mysql
buluma.buildtools
buluma.epel
buluma.python_pip
buluma.postgres

Context

This role works with many other compatible roles. Check this documentation for more details.

Here’s an overview of related roles:

Compatibility

This role has been tested with these container images:

You need at least Ansible version 2.12. Tests have been conducted on:

• The previous version.
• The current version.
• The development version.

If you encounter problems, please report them on GitHub.

Changelog

You can view Role History for updates.

License

This role is licensed under Apache-2.0.

Author Information

Created by Shadow Walker.