One of the goals of the RDO Packstack Quickstart is to give people a
successful and easy first-time experience deploying OpenStack, even if
what they're left with (an --allinone deployment) might not be, strictly
speaking, *useful* for much.
Today on IRC I asked if we might possibly work towards a similar
quickstart for RDO-Manager, where we make a bunch of assumptions and
automate whatever parts of it we can, and end up with a "do these three
steps" kind of thing, like the Packstack quickstart.
I've included the transcript of the conversation below, but since IRC
transcripts can be confusing after the fact, to summarize, slagle opined
that it might be feasible to have two paths - the full-featured path
that we currently have, but also something as I described above for your
first time.
I wanted to toss this out here for a larger audience to see whether this
seems like a reasonable goal to pursue?
<rbowen> Is it feasible that we might get the RDO-Manager instructions
down to a Quickstart-like page?
<rbowen> I don't even necessarily mean NOW, I mean, as a short/medium
term goal. The instructions are very intimidating.
<morazi> rbowen, I suspect we might be able to do that if we make a fair
number of assumptions and possibly try to leverage some amount of the
upstream CI work slagle is presently hacking on. slagle may violently
disagree in which case, ignore what I just said. ;-)
<slagle> morazi: rbowen : sure, we can trim whatever. just keep in mind
i might not be the best docs writer. we originally started small, but
that just caused a lot of mistakes/issues. so we made a conscious
decision to be explicit
<slagle> hence the current nature of the docs
<rbowen> Yeah, I think there's room for both types of docs, much like
there's room for the Packstack quickstart and the full-blown
do-it-by-hand OpenStack installation docs.
<morazi> slagle, oh, I was thinking about -- can we lift the ci script
and say -- your quickstart is to configure this script. The full blown
install is <link to docs>
<slagle> well, we're documenting the same tool
<slagle> and...are stated goal is not to be packstack
<slagle> i'm all for making it easy
<slagle> but we're still bound by how complex openstack is to install in
*real* world configurations
<morazi> rbowen, basically with a highly specific/opinionated virtual
environment I think we could make it really easy. If you want to inject
choice back into it, things get complex quickly. That's the crux to me
if that makes sense.
<rbowen> I think perhaps what I'm looking for isn't entirely realistic,
but it's kind of the "success first time" goal that was part of the
original Quickstart page.
<morazi> rbowen, what might be interesting is -- what are the
assumptions that the packstack quickstart makes for you? Can we easily
figure that out?
<rbowen> And then once you have a successful first time, you can learn
more about various steps.
<rbowen> The quickstart does kind of assume that you'll be left with
something that's ... well, not very useful.
<rbowen> But it gives you a flavor of it.
<slagle> rbowen: yea, agreed. it's about finding the right balance there
<rbowen> Much like the "how fast can you install OpenStack from scratch"
contests they had at OpenStack Summit.
<ibravo> for what it's worth, I followed the guides and they are already
simple. There is an appendix for more complex stuff
<slagle> the feedback swings from "this is too hard", then the more we
hide away behind scripts we start hearing "i don't know what this is
doing, too much is hidden"
<morazi> ibravo, cool, thx for that feedback!
<slagle> rbowen: so, 2 paths probably makes sense
<apevec> dmsimard, how come is enforcing, when it has -permissive- in
the name??
<morazi> ibravo, I tend to agree. They are pretty simple but there is a
lot there in terms of number of steps. nothing in particular is super
hard but you have to do many things.
<rbowen> ibravo: Ok, that's good to hear. I obviously need to block off
a half day at some point to work through it. I mostly skimmed through
and it was intimidating, but I was in a hurry.
--
Rich Bowen - rbowen(a)redhat.com
OpenStack Community Liaison
http://rdoproject.org/