[OpenStack-docs] Future of the HA Guide?

Chason chen.xing at 99cloud.net
Tue Dec 6 04:57:42 UTC 2016


I have the same opinion with Alex. It is still worthwhile to keep HA guide in publication. I am looking forward to the spec and willing to get involved in this improving job. : )

Thanks,

Chason
 
From: Alexandra Settle
Date: 2016-12-06 17:47
To: Andrew Beekhof; Lana Brindley
CC: OpenStack Manuals; chen.xing at 99cloud.net; aspiers at suse.com
Subject: Re: Future of the HA Guide?
Hey Andrew, Hey Lana,
 
So, I only have one minor patch left in flight, see here: https://review.openstack.org/#/c/406882/ 
 
After extensively reviewing the guide over the last two weeks I do believe it has some highly beneficial content and, now that Lana has the numbers to justify it, I sincerely believe we should keep this guide in publication.
 
However, it can no longer go ignored as a background guide. There are chapters, such as this one http://docs.openstack.org/ha-guide/networking-ha.html, that literally have next to no information on it. It is a file of publicly visible TODOs. I have filed numerous bugs here: https://bugs.launchpad.net/openstack-manuals/+bugs?field.tag=ha-guide based mostly out of the TODOs I found in the guide. 
 
Thank you, Chen, for filing the blueprint. If someone has the time (and I have CC’d in Adam Spiers who also works on HA ‘stuff’ to hopefully find such a person) to go through the bugs and find what is still relevant to the guide – and then perhaps we can go ahead and write a specification based of the plans from Andrew.
 
TL;DR - If we can get the blueprint (and bugs) reviewed for relevant content, we can create the spec, and then maybe discuss a potential sprint in the near future.
 
Cheers,
 
Alex
 
On 12/6/16, 3:53 AM, "Andrew Beekhof" <abeekhof at redhat.com> wrote:
 
    I have no spec for this, but my plan has been to par back the guide to
    the essentials.
    Most OpenStack services no longer need any hand-holding from a cluster
    manager and don't need to be covered.
    
    Instead I think the guide should:
    1. outline and justify an architecture
    2. show how to configure shared services for HA, such as haproxy,
    galera, rabbitmq
    3. explain in general how to configure openstack services to use the
    shared services (haproxy for galera, node list for rabbit, etc)
    4. explain how to accomodate any active-passive services (ie. cinder-volume)
    
    I (now) have most of this information ready in another context, what
    remains is to shape it into a suitable format for the guide.
    I might be able to find a few days for this before christmas if that
    would help, but it would be good to have Alexandra's efforts completed
    first least we end up with a tonne of merge conflicts.
    
    -- Andrew
    
    
    
    
    On Tue, Dec 6, 2016 at 2:32 PM, Lana Brindley
    <openstack at lanabrindley.com> wrote:
    > Hi everyone,
    >
    > Seems that the HA Guide is rearing its ugly head again at the moment. It's not had a lot of attention in the past year or so, so it's gotten more and more out of date. Under the guidance of Andrew Beekhof, it's slowly improving, and Alexandra Settle has been putting in a lot of effort recently, however it's time we decided whether or not it's worth overhauling the guide. At the moment, we have an unapproved blueprint here: https://blueprints.launchpad.net/openstack-manuals/+spec/implement-ha-guide-todos
    >
    > So, what do you think? We know that a fair few people are looking at it (the HA Guide had 1,621 visitors in the last 30 days. Compare that to the Ubuntu Newton Install Guide which got 3,426 or the Ops Guide at 1,547 in the same period), but it's important that if people are accessing the information that it's accurate, and we already know the HA Guide is not current. Is it better to have it there and possibly incorrect, or to remove it entirely? Can we subsume any good content in the HA Guide into another guide (or guides)?
    >
    > I want to make sure we have a clear direction on this guide before we commit resources to improving it. So, ideas please, before the book gets consigned to the recycling bin!
    >
    > L
    >
    > --
    > Lana Brindley
    > Technical Writer
    > Rackspace Cloud Builders Australia
    > http://lanabrindley.com
    >
    
 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20161206/c8754783/attachment-0001.html>


More information about the OpenStack-docs mailing list