Chapter 1. Getting Started
1.1. Introduction
Red Hat Insights has the ability to integrate Ansible Playbooks into Insights maintenance plans. This document will help Red Hat Insights users to create maintenance plans and playbooks using the Insights UI in the Red Hat Customer Portal. Ansible Playbook integration with Insights can help system administrators save time, be more productive, eliminate repetitive tasks, and reduce or eliminate errors.
Limitations
The following limitations or restrictions apply to Ansible integration with Red Hat Insights:
- Currently, Ansible Playbook capability is available exclusively through the Customer Portal and, as such, is unavailable via Satellite and CloudForms integrations. Satellite users can use it via the Customer Portal UI.
- If you change a system’s hostname when registering that system in Insights, the same name must be used in the Ansible inventory or the generated playbook will not run.
- There may not be a playbook for every rule. We’re currently expanding our offering; however, only those rules showing an Ansible icon have a playbook currently available.
Prerequisites
These instructions assume that system administrators have met the following prerequisites:
- Set up Red Hat Insights. Refer to the instructions for your environment on the Insights Get Started page.
- Install Ansible 2.2.0 or later.
Set up Ansible.
- Enable logging in the Ansible configuration file.
-
Set up an Inventory file in the
/etc/ansible/hostsdirectory. - Ensure that all standard Ansible settings are enabled.
- Verify connectivity to all inventory hosts.

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.