Skip to content

dell/ansible-powerflex

Ansible Modules for Dell Technologies PowerFlex

Contributor Covenant License Python version Ansible version PyPowerFlex GitHub release (latest by date including pre-releases) codecov

The Ansible Modules for Dell Technologies (Dell) PowerFlex allow Data Center and IT administrators to use RedHat Ansible to automate and orchestrate the provisioning and management of Dell PowerFlex storage systems.

The capabilities of the Ansible modules are managing SDCs, volumes, snapshots, snapshot policy, storage pools, replication consistency groups, replication pairs, SDSs, SDTs, NVMe hosts, devices, protection domains, MDM cluster, Fault Set and to gather high level facts from the storage system. The options available are list, show, create, modify and delete. These tasks can be executed by running simple playbooks written in yaml syntax. The modules are written so that all the operations are idempotent, so making multiple identical requests has the same effect as making a single request.

Table of contents

Requirements

Ansible Modules PowerFlex/VxFlex OS Version SDK version Python version Ansible
v2.6.0 3.6
4.0
4.5
APEX Block Storage for Mircrosoft Azure
APEX Block Storage for AWS
1.14.0 3.9.x
3.10.x
3.11.x
3.12.x
2.15
2.16
2.17

Installation and execution of Ansible modules for Dell PowerFlex

The installation and execution steps of Ansible modules for Dell PowerFlex can be found here.

Use Cases

Refer the example playbooks on how the collection can be used for modules and roles.

Testing

The following tests are done on ansible-powerflex collection

  • Unit tests
  • Integration tests.

Support

Refer Support documenetation for more information on the support from Dell Technologies.

Release Notes, Maintenance and Deprecation

Ansible Modules for Dell Technologies PowerFlex follows Semantic Versioning.

New version will be release regularly if significant changes (bug fix or new feature) are made in the collection.

Released code versions are located on "release" branches with names of the form "release-x.y.z" where x.y.z corresponds to the version number. More information on branching strategy followed can be found here.

Ansible Modules for Dell Technologies PowerFlex deprecation cycle is aligned with that of Ansible.

See change logs for more information on what is new in the releases.

Related Information

Idempotency

The modules are written in such a way that all requests are idempotent and hence fault-tolerant. It essentially means that the result of a successfully performed request is independent of the number of times it is executed.

List of Ansible modules for Dell PowerFlex

License

The Ansible collection for PowerFlex is released and licensed under the GPL-3.0 license. See LICENSE for the full terms.