DEPRECATION NOTICE

The Pure Storage Fusion Ansible Collection is no longer being developed and is being deprecated.

No further development work will be performed on this repo and the repo will be archived.

Pure Storage Fusion Collection

The Pure Storage Fusion collection consists of the latest versions of the Fusion v1 modules.

Requirements

• ansible-core >= 2.14.0
• Python >= 3.9
• Authorized API Application ID for Pure Storage Pure1 and associated Private Key
  • Refer to Pure Storage documentation on how to create these.
• purefusion >= 1.0.4
• time

Available Modules

• fusion_api_client: Manage API clients in Pure Storage Fusion
• fusion_array: Manage arrays in Pure Storage Fusion
• fusion_az: Create Availability Zones in Pure Storage Fusion
• fusion_hap: Manage host access policies in Pure Storage Fusion
• fusion_hw: Create hardware types in Pure Storage Fusion
• fusion_info: Collect information from Pure Fusion
• fusion_ni: Manage Network Interfaces in Pure Storage Fusion
• fusion_nig: Manage Network Interface Groups in Pure Storage Fusion
• fusion_pg: Manage placement groups in Pure Storage Fusion
• fusion_pp: Manage protection policies in Pure Storage Fusion
• fusion_ra: Manage role assignments in Pure Storage Fusion
• fusion_region: Manage regions in Pure Storage Fusion
• fusion_sc: Manage storage classes in Pure Storage Fusion
• fusion_se: Manage storage endpoints in Pure Storage Fusion
• fusion_ss: Manage storage services in Pure Storage Fusion
• fusion_tenant: Manage tenants in Pure Storage Fusion
• fusion_tn: Manage tenant networks in Pure Storage Fusion
• fusion_ts: Manage tenant spaces in Pure Storage Fusion
• fusion_volume: Manage volumes in Pure Storage Fusion

Instructions

Ansible must be installed Install guide

sudo pip install ansible

Python PureFusion SDK must be installed

sudo pip install purefusion

Install the Pure Storage Fusion collection on your Ansible management host - Galaxy link

ansible-galaxy collection install purestorage.fusion

Example Playbook

- hosts: localhost
  tasks:
  - name: Collect information for Pure Storage fleet in Pure1
    purestorage.fusion.fusion_info:
      gather_subset: all
      issuer_id: <Pure1 API Application ID>
      private_key_file: <private key file name>

You can find more examples in our example-playbooks repository.

Contributing to this collection

Ongoing development efforts and contributions to this collection are tracked as issues in this repository.

We welcome community contributions to this collection. If you find problems, need an enhancement or need a new module, please open an issue or create a PR against the Pure Storage Fusion Ansible collection repository.

Code of Conduct

This collection follows the Ansible project's Code of Conduct. Please read and familiarize yourself with this document.

Releasing, Versioning and Deprecation

This collection follows Semantic Versioning. More details on versioning can be found in the Ansible docs.

New minor and major releases as well as deprecations will follow new releases and deprecations of the Pure Storage Fusion product, its REST API and the corresponding Python SDK, which this project relies on.

License

BSD-2-Clause GPL-3.0-or-later

Author

This collection was created in 2022 by Simon Dodsley for, and on behalf of, the Pure Storage Ansible Team