Dell EMC OpenManage Ansible Modules allows data center and IT administrators to use RedHat Ansible to automate and orchestrate the configuration, deployment, and update of Dell EMC PowerEdge Servers and modular infrastructure by leveraging the management automation capabilities in-built into the Integrated Dell Remote Access Controller (iDRAC), OpenManage Enterprise and OpenManage Enterprise Modular.
OpenManage Ansible Modules simplifies and automates provisioning, deployment, and updates of PowerEdge servers and modular infrastructure. It allows system administrators and software developers to introduce the physical infrastructure provisioning into their software provisioning stack, integrate with existing DevOps pipelines and manage their infrastructure using version-controlled playbooks, server configuration profiles, and templates in line with the Infrastructure-as-Code (IaC) principles.
- iDRAC 7 and 8 based Dell EMC PowerEdge Servers with Firmware versions 2.70.70.70 and above.
- iDRAC 9 based Dell EMC PowerEdge Servers with Firmware versions 4.32.10.00 and above.
- Dell EMC OpenManage Enterprise versions 3.4 and above.
- Dell EMC OpenManage Enterprise-Modular versions 1.20.10 and above.
- Ansible >= 2.10.0
- Python >=2.7.17 or >=3.6.5
- To run the iDRAC modules, install OpenManage Python Software Development Kit (OMSDK)
using either
pip install omsdk --upgrade
orpip install -r requirements.txt
. OMSDK can also be installed from Dell EMC OpenManage Python SDK
-
From galaxy:
ansible-galaxy collection install dellemc.openmanage
- For offline installation on the Ansible control machine, download the required tar archive version of the collection from Dell EMC OpenManage collection and run the command given below:
ansible-galaxy collection install dellemc-openmanage-<version>.tar.gz
- For offline installation on the Ansible control machine, download the required tar archive version of the collection from Dell EMC OpenManage collection and run the command given below:
-
From github:
Install the collection from the github repository using the latest commit on the branch 'collections'
ansible-galaxy collection install git+https://github.com/dell/dellemc-openmanage-ansible-modules.git,collections
Latest sample playbooks and examples are available at playbooks.
Use ansible-doc
to view the documentation of each module and plugin.
For example-ansible-doc dellemc.openmanage.<module_name>
This project is licensed under GPL-3.0 License. See the COPYING for more information.
We welcome your contributions to OpenManage Ansible Modules. See Coding Guidelines for more details. You can refer our Code of Conduct here.
See here for further information on testing.
To debug OpenManage Ansible Modules using IDE, see here
- OpenManage Ansible Modules releases follows a monthly release cycle. On the last week of every month, the updated modules are posted to this repository.
- OpenManage Ansible Modules releases follow semantic versioning.
- OpenManage Ansible Modules deprecation cycle is aligned with Ansible.
- This branch corresponds to the release actively under development.
- To report any issue, create an issue here.
- If any requirements have not been addressed, then create an issue here.
- To provide feedback to the development team, send an email to [email protected].
- OpenManageAnsible ([email protected])