Bug 1322200

Summary:	[Docs] [RFE] [Beta] Document Ansible Tower integration
Product:	Red Hat CloudForms Management Engine	Reporter:	Lucy Bopf <lbopf>
Component:	Documentation	Assignee:	Red Hat CloudForms Documentation <cloudforms-docs>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Dayle Parker <dayleparker>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	5.6.0	CC:	dajohnso, dayleparker, jhardy, mfeifer, obarenbo
Target Milestone:	GA	Keywords:	FutureFeature
Target Release:	5.6.0
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:	doc
Fixed In Version:		Doc Type:	Enhancement
Doc Text:	Cause: Consequence: Fix: Result:	Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-05-26 02:14:51 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

Description Lucy Bopf 2016-03-30 01:53:52 UTC

Document the Ansible Tower integration items that are available ahead of the CFME 5.6 (4.1) Beta 2 release.

The planned use cases are:

1. Ansible Tower as a configuration management provider.
This integration is a prerequisite for the two use cases that follow.
This function is available via Infrastructure -> Configuration Management
See https://github.com/ManageIQ/manageiq/pull/6551 for some screen grabs.

2. Ansible as a Service Type.
This allows for the author of a service to define a service item as an Ansible job within Tower.
https://trello.com/c/M31Km5dZ/215-13-ansible-as-a-service-type

3. Ansible as a Method Type.
This will allow for the author of a state machine to specify state by state either traditional Ruby methods or to use a Tower Job instead, greatly reducing the amount of scripting experience required to deliver a custom use case. This is because the Ansible jobs in Tower can be playbooks from the Galaxy community, a repo of playbooks for almost any automation task.
https://trello.com/c/bzNr3ECx/211-8-ansible-tower-job-as-a-method-type

Comment 1 Lucy Bopf 2016-03-30 02:02:01 UTC

Assigning to Shihka for review.

Shikha, so far it looks like only use case 1. is available in the current downstream build. You should be able to begin by documenting some steps for adding Ansible Tower as a configuration management provider.

Comment 2 Shikha 2016-04-15 14:27:28 UTC

Hi Lucy,
I have created a guide named Integration with Ansible Tower based on the information that I researched on my own. I would like a QA from engineering to verify the content and if possible, provide more context and information.

You can review the guide here:
http://file.bne.redhat.com/snansi/

Regards,
Shikha

Comment 3 Shikha 2016-04-18 03:53:13 UTC

Hi Lucy,
As per our discussion, I have added a new chapter Configuration Management Providers in the Managing Providers guide.
Please review: http://file.bne.redhat.com/snansi/#configuration_management_providers
Regards,
Shikha

Hi Dayle,
Please provide a docs QE for the following merge request:
https://gitlab.cee.redhat.com/rhci-documentation/docs-Red_Hat_CloudForms/merge_requests/145

Regards,
Shikha

Comment 4 Dayle Parker 2016-04-19 06:13:24 UTC

I've reviewed the content; all looks good and has been merged into master now.
Thanks and nice work, Shikha!

Comment 6 Lucy Bopf 2016-05-26 02:14:51 UTC

The content discussed in this bug has now been published, and is available in the following location:

https://access.redhat.com/documentation/en/red-hat-cloudforms/version-4.1-beta/managing-providers/#ansible_tower

Moving to CLOSED.