README.md

Ansible playbooks and roles for iDRACs using Redfish APIs

This repository contains the Ansible playbook samples and Ansible roles for automating the PowerEdge server lifecycle management using iDRACs and OpenManage Enterprise. The examples highlight the capabilities of the modules and their ability to be integrated into more complex playbooks, workflows, and applications.

These playbooks should give you a very good idea of how to create your own playbooks for your own needs.

Here is a sample inventory file.

Example playbooks and roles use the following collection and modules:

• dellemc.openmanage collection: This collection is officially supported by DellEMC. For more information, please visit the GitHub repository
• community.general collection - Following is the list of the modules that are being used from this collection:
  • redfish_info
  • redfish_command
  • redfish_config
  • idrac_redfish_info
  • idrac_redfish_command
  • idrac_redfish_config

Requirements

Ansible

• These example playbooks and roles have been developed and tested with maintained version of Ansible core (>= 2.11)
• When using ansible-core, you will also need to install the following collections:

  ---
  collections:
    - name: community.general
      version: 3.7.0
    - name: dellemc.openmanage
      version: 4.1.0

  Note: You can alternatively install the Ansible community distribution (pip install ansible) if you don't want to manage individual collections.
• Instructions on how to install Ansible can be found in the Ansible website

Jinja2

• This role uses Jinja2 templates. Ansible core installs Jinja2 by default, but depending on your install and/or upgrade path, you might be running an outdated version of Jinja2. The minimum version of Jinja2 required for the role to properly function is 2.11.
• Instructions on how to install Jinja2 can be found in the Jinja2 website.

Installation

Git

Use git clone https://github.com/dell/redfish-ansible-module.git to pull the latest commit of the playbooks and role from GitHub

Documentation

Each Ansible role contains a README with instructions on prerequisites, installation, and usage. Be sure to also review supported resource versions and follow installation instructions for the underlying modules used in the examples per their documentation.

Support

The examples are provided as is with no warranties. Some basic knowledge of the Red Hat Ansible Automation Platform and additional technology integration is expected.

If you run into any problems or would like to provide feedback, please open an issue here