Skip to main content
Version: 2.9

PXB Ansible Collection

Overview​

The PXB Ansible Collection allows seamless automation of PXB operations through Ansible tool. This includes managing backup locations, schedules, cloud credentials, and cluster operations.

By integrating PXB with Ansible, administrators can reduce manual effort, minimize errors, and enhance operational consistency, making it an ideal solution for managing backup workflows in hybrid and multi-cloud environments.

Prerequisites​

  • PXB: 2.8.1 and above
  • Ansible Core: 2.17.6 and above
  • Python: 3.9 and above
  • Python Library: requests

Modules​

PXB currently automates the task associated with the following modules:

  1. Backup location management: create, update, and delete backup locations for PXB.
  2. Backup Management: manually create and manage backups
  3. Schedule management: automate backup scheduling workflows
  4. Restore management: restore backups that were backed up earlier
  5. Resource collector: list all the resources in a cluster which PXB can back up
  6. Cloud credential management: configure and manage credentials for accessing cloud storage and services
  7. Cluster management: perform cluster-level operations directly through Ansible playbooks
  8. Back up only PVCs/PV: back up volume resources (PVC/PV) excluding the volume data with Volume Resource Only Policy (VROP)

Installation​

  1. To install the PX-Backup Ansible collection:

    ansible-galaxy collection install purepx.px_backup

  2. For development and reference:

    git clone https://github.com/portworx/px_backup_module.git
    cd px_backup_module

For more information, refer to the following resources: