Bug 1435481

*** Bug 1444212 has been marked as a duplicate of this bug. ***

Ken:

I'm looking at the 7.5 features to document, and I'm not sure where to take the issue of documenting bundles.  For 7.4, when this feature was in tech. preview, this is all that we said:
-------------

The pcs tool now manages bundle resources in Pacemaker

As a Technology Preview starting with Red Hat Enterprise Linux 7.4, the `pcs` tool supports bundle resources. You can now use the "pcs resource bundle create" and the "pcs resource bundle update" commands to create and modify a bundle. You can add a resource to an existing bundle with the "pcs resource create" command. For information on the parameters you can set for a `bundle` resource, run the "pcs resource bundle --help" command.
----------------

But maybe we should talk about this a little more, with an example?  This seems tied in to managing galera and rabbit so I'm not sure what we can or should document here.  This might perhaps be an article on the Portal?

Any thoughts on whether and what we need to document for 7.5, and whether that could be a chapter in the Reference or an article?

Is there existing documentation I should know about?

Bundles are tied to galera and rabbit only in the context of OpenStack. When we take this out of tech preview (which I believe will be 7.5), bundles can be used with any resource that can be put into a Docker container.

Upstream has this documentation for the equivalent of 7.4:

* http://clusterlabs.org/doc/en-US/Pacemaker/1.1-pcs/html-single/Pacemaker_Explained/index.html#s-resource-bundle

* https://wiki.clusterlabs.org/wiki/Bundle_Walk-Through


The upstream equivalent of 7.5 will have these changes:

* https://github.com/ClusterLabs/pacemaker/commit/3d7b32a586188024301acc7d2ac50649e299fe50

* https://github.com/ClusterLabs/pacemaker/commit/d7735f24316da16e52f3cd07876373d52baa42e2


However we could use a much simplified form of all that for RHEL. RHEL won't support rkt containers, so that can be left out. And of course we would document pcs commands rather than the raw XML.

Looking at the upstream walk-through, we'd have to replace the parts about where to find the docker package and which base image to use.

There's also a chance we could leave this tech preview for 7.5, in which case all this could be deferred.

Adding Mikey Ariel to the CC list for this BZ -- Mikey works on OpenStack HA docs which need to be coordinated with the documentation we'll be providing here.