Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1615694

Summary:	[Docs][EPIC] Document Ansible integration with director
Product:	Red Hat OpenStack	Reporter:	Lucy Bopf <lbopf>
Component:	documentation	Assignee:	Dan Macpherson <dmacpher>
Status:	CLOSED NOTABUG	QA Contact:	Alex McLeod <amcleod>
Severity:	high	Docs Contact:
Priority:	high
Version:	14.0 (Rocky)	CC:	dcadzow, sclewis, srevivo
Target Milestone:	beta	Keywords:	Documentation, FutureFeature
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Enhancement
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2019-01-22 12:47:05 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:
Embargoed:
Bug Depends On:	1343233, 1369270, 1430545, 1523328, 1624091, 1665485
Bug Blocks:

Description Lucy Bopf 2018-08-14 03:57:12 UTC

Name of function:
Ansible integration with director

User story:
As an administrator/installer, I want to be able to use Ansible to make the use of director, as a tool both for deployment and managing my OpenStack, less complex and easier to learn, more reliable and able to debug installations for me.

Purpose of function:
Heat is still used in the typical fashion to create the stack and all of the descendant resources. Heat creates all the deployment data necessary to perform the Overcloud installation and configuration, but it does not apply any of the deployments.  A config-download workflow is triggered after the Heat stack is completed that downloads all of the deployment data from Heat, which generates Ansible playbooks and tasks that are then used by the undercloud to complete the configuration of the Overcloud.

Work required (from detail plan):
Procedural 
------
- dry run of Ansible before deployment?
(OSP 13 TP) - How to enable ansible integration
(OSP 14 FS) - default installation - remove enablement steps
Test deployment: 
- Re-run and skip deployment steps?
How to check for deployment failures - updating commands to allow the operator to get the status/ query logs

------

Conceptual 
------
Install and enablement is by default in OSP 14
------

Reference
------
N/A
------


Note: This functionality was enabled as a Technology Preview in RHOSP 13, and was documented as part of bug 1558145.

Comment 2 Lucy Bopf 2018-08-14 04:02:32 UTC

Accepting in RHOSP 14 program.

Comment 3 Lucy Bopf 2018-08-14 04:48:45 UTC

Assigning to Dan for review.

Dan, I'm setting GA as the ultimate milestone for the EPIC, but your first drafts and set of BZs that track testing for QE should be aimed at Beta.

Comment 4 Dan Macpherson 2018-09-03 23:05:21 UTC

New upstream config-download docs patch:
https://review.openstack.org/#/c/599053/

Comment 6 Dan Macpherson 2019-01-22 12:47:05 UTC

Peer review completed and guide republished.