<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Sep 2, 2016 at 3:59 PM, Sterrett, Craig <span dir="ltr"><<a href="mailto:craig.sterrett@intel.com" target="_blank">craig.sterrett@intel.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div lang="EN-US" link="blue" vlink="purple">
<div>
<p class="MsoNormal"><a name="m_8854018987318846173__MailEndCompose"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">Hi Anne<u></u><u></u></span></a></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">I agree that our users are more likely using puppet or ansible, but from other projects I have received feedback to not include non-OpenStack projects in my samples.
Yes cloud-init is not really OpenStack either, but it is packaged into all of the “cloud images” that people utilize. That’s the reason for my selecting cloud-init. If others feel that including puppet or ansible would be acceptable, the I could certainly
add that as an example later.</span></p></div></div></blockquote><div><br></div><div>Sorry, I'm afraid I'm sidetracking you and I don't mean to. Your content focus areas are fine.</div><div><br></div><div>You need somewhere to write a heat example for the fractals app. I'm saying either add a new "deployment" chapter to the First App guide with no conditionals in that chapter, and output it with every SDK, or avoid a guide with conditionals completely and add a "deployment" chapter to that. For example, the user-guide could use such a chapter.</div><div><br></div><div>What do you think of those ideas?</div><div>Thanks,</div><div>Anne</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div lang="EN-US" link="blue" vlink="purple"><div><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d"><u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Arial",sans-serif;color:#1f497d">Craig Sterrett</span><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">
<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><a name="m_8854018987318846173______replyseparator"></a><b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif">From:</span></b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif"> Anne Gentle [mailto:<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@<wbr>justwriteclick.com</a>]
<br>
<b>Sent:</b> Tuesday, August 30, 2016 4:36 PM<br>
<b>To:</b> Sterrett, Craig <<a href="mailto:craig.sterrett@intel.com" target="_blank">craig.sterrett@intel.com</a>><br>
<b>Cc:</b> Lana Brindley <<a href="mailto:openstack@lanabrindley.com" target="_blank">openstack@lanabrindley.com</a>>; <a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.<wbr>openstack.org</a></span></p><div><div class="h5"><br>
<b>Subject:</b> Re: [OpenStack-docs] Need help with FirstApp Doc for heat<u></u><u></u></div></div><p></p><div><div class="h5">
<p class="MsoNormal"><u></u> <u></u></p>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
<div>
<p class="MsoNormal">On Tue, Aug 30, 2016 at 5:59 PM, Sterrett, Craig <<a href="mailto:craig.sterrett@intel.com" target="_blank">craig.sterrett@intel.com</a>> wrote:<u></u><u></u></p>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<div>
<div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">The orchestration chapter is very basic, really just covering how to create a stack once you download
a template, and does not cover the details of the template. What I am proposing is, to duplicate the entire FirstApp using heat, reproducing what is being done by the SDK function calls using heat. </span><u></u><u></u></p>
</div>
</div>
</blockquote>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">Okay, but if the FirstApp guide is meant for SDKs, and heat/orchestration/ceilometer/<wbr>autoscaling is for deployment, let's talk about a new chapter or a different guide.<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">Beyond user-data, consider the use of ansible, or puppet, or chef. To me this sounds more scalable to the types of info and deployment scenarios our users are interested in. What do you think?<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<div>
<div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">The getting started chapter will show you how to create a heat template that launches an instance
defining the image, flavor, key, security group and network, and then pass in the commands to install the Fractals application into user_data, and lastly associate a floating IP, with each section of the template explained. The end result will be the fractal
application running and accessible by the floating IP</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">The introduction will add in creating security groups, and splitting the application services across
two instances. </span><u></u><u></u></p>
</div>
</div>
</blockquote>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">Scaling out in that SDK guide is here: <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><a href="http://developer.openstack.org/firstapp-libcloud/scaling_out.html" target="_blank">http://developer.openstack.<wbr>org/firstapp-libcloud/scaling_<wbr>out.html</a><u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">To me, this is a bit of a square peg in a round hole. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<div>
<div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">Scaling out discusses how to further split out the fractal app into 3 groups of services, and how to
use heat ResourceGroup to kick off multiple instances for each of the services. It also shows how you can pass IP addresses of created instances back and use str_replace to modify configuration files for the Fractal app as needed when you split up the app
into 3 separate pieces.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">Block storage adds in how to create cinder block storage using heat and how to prepare the disk and
mount the disk, and install the MySQL db on it.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">I was going to change the Orchestration to Autoscaling, and add in how to setup ceilometer to monitor
and automatically scale the different components up and down, adding in how to use metadata to define groups of instances the ceilometer alarms are looking at, allowing for multiple scaling groups.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">Networking covers how to create 3 separate networks for the 3 different groups of services in the Fractal
app , with routers and load balancers and floating IP’s.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d"> </span><u></u><u></u></p>
</div>
</div>
</blockquote>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">All this sounds great, but for simplicity's sake and for accelerating the writing and reviewing, I'd suggest a new chapter on deployment, and in any chapters that have a heat approach, a pointer to that new chapter. Or, write a "deploying
apps" chapter in the user-guide in openstack-manuals. That definitely provides less complexity since it uses no conditional text. There are more reviewers there too. Unless you actually prefer fewer reviews, I could argue either way. :)<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">Also consider there's an effort going on for a content sprint with the working title of "Moving apps to OpenStack" and an outline here: <a href="https://docs.google.com/document/d/1mR-M2ufn0lviyGughNdm0zFz9O6AlYFUSr3JKqoaiv4/edit" target="_blank">https://docs.google.com/<wbr>document/d/1mR-<wbr>M2ufn0lviyGughNdm0zFz9O6AlYFUS<wbr>r3JKqoaiv4/edit</a>
That's happening next month, in September. See the thread at <a href="http://lists.openstack.org/pipermail/user-committee/2016-August/001203.html" target="_blank">http://lists.openstack.org/<wbr>pipermail/user-committee/2016-<wbr>August/001203.html</a><u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">I'm only connecting the dots here, not trying to sway you one way or another. My sense is that you have a good idea of what to write, and trying to fit in the FirstApp conditional text boxes will be slower than "just write it in an existing
non-conditional guide."<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">Anne<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<div>
<div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Arial",sans-serif;color:#1f497d">Craig Sterrett</span><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d">
</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1f497d"> </span><u></u><u></u></p>
<p class="MsoNormal"><a name="m_8854018987318846173_m_2281222312091391237_m_-629794433277065"></a><b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif">From:</span></b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif">
Anne Gentle [mailto:<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@<wbr>justwriteclick.com</a>]
<br>
<b>Sent:</b> Tuesday, August 30, 2016 2:14 PM<br>
<b>To:</b> Lana Brindley <<a href="mailto:openstack@lanabrindley.com" target="_blank">openstack@lanabrindley.com</a>><br>
<b>Cc:</b> <a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.<wbr>openstack.org</a><br>
<b>Subject:</b> Re: [OpenStack-docs] Need help with FirstApp Doc for heat</span><u></u><u></u></p>
<p class="MsoNormal"> <u></u><u></u></p>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
<div>
<p class="MsoNormal">On Tue, Aug 30, 2016 at 3:53 PM, Lana Brindley <<a href="mailto:openstack@lanabrindley.com" target="_blank">openstack@lanabrindley.com</a>> wrote:<u></u><u></u></p>
<div>
<div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<p class="MsoNormal">Hi Craig,<br>
<br>
FirstApp docs aren't part of the openstack-manuals project. I think Tom (cc'd) can probably help you out with contribution information.<u></u><u></u></p>
</blockquote>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">It is: <a href="https://github.com/openstack/governance/blob/master/reference/projects.yaml#L430" target="_blank">https://github.com/<wbr>openstack/governance/blob/<wbr>master/reference/projects.<wbr>yaml#L430</a><u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">I'd like to hear ideas for where this exact content belongs really -- it's the firstapp, deployed with Orchestration (heat), right? Seems like this content could be in its own chapter,
ignoring any conditionals, or making the entire chapter conditional for its own output. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">Say more about the outline you're proposing, and when/where/why this chapter <a href="http://developer.openstack.org/firstapp-libcloud/orchestration.html" target="_blank">http://developer.<wbr>openstack.org/firstapp-<wbr>libcloud/orchestration.html</a>
is opposite of your thinking for inserting heat templates in the guide? <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">Anne<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<p class="MsoNormal"><br>
Thanks,<br>
Lana<u></u><u></u></p>
<div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt"><br>
On 31/08/16 01:19, Sterrett, Craig wrote:<br>
> Hello<br>
><br>
> I have been asked to create a FirstApp for heat. It looks like the FirstApp documents get generated with lots of static text, and modifying the code blocks for the different SDKs. My problem is that I would like to modify a lot of the static text, since
it is fairly specific to SDKs and not really accurate for heat. I would also like to rename a section, changing the Orchestration section to Autoscaling since all of my document is Orchestration.<br>
><br>
> Any suggestions about the best way to go about this?<br>
><br>
> Thanks, Craig Sterrett<br>
><br>
><br>
> ______________________________<wbr>_________________<br>
> OpenStack-docs mailing list<br>
> <a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.<wbr>openstack.org</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">
http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
><u></u><u></u></p>
</div>
</div>
<p class="MsoNormal" style="margin-bottom:12.0pt"><span style="color:#888888">--<br>
Lana Brindley<br>
Technical Writer<br>
Rackspace Cloud Builders Australia<br>
<a href="http://lanabrindley.com" target="_blank">http://lanabrindley.com</a><br>
<br>
</span><br>
______________________________<wbr>_________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.<wbr>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><u></u><u></u></p>
</blockquote>
</div>
</div>
</div>
<p class="MsoNormal"><br>
<br clear="all">
<u></u><u></u></p>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<p class="MsoNormal">--
<u></u><u></u></p>
<div>
<div>
<div>
<div>
<div>
<p class="MsoNormal">Anne Gentle<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><a href="http://www.justwriteclick.com" target="_blank"><span style="font-size:9.5pt">www.justwriteclick.com</span></a><u></u><u></u></p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</blockquote>
</div>
<p class="MsoNormal"><br>
<br clear="all">
<u></u><u></u></p>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<p class="MsoNormal">-- <u></u><u></u></p>
<div>
<div>
<div>
<div>
<div>
<p class="MsoNormal">Anne Gentle<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><a href="http://www.justwriteclick.com" target="_blank"><span style="font-size:9.5pt">www.justwriteclick.com</span></a><u></u><u></u></p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div></div></div>
</div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a href="http://www.justwriteclick.com" style="font-size:12.8px" target="_blank">www.justwriteclick.com</a><br></div></div></div></div></div>
</div></div>