[OpenStack-docs] Need help with FirstApp Doc for heat

Sterrett, Craig craig.sterrett at intel.com
Tue Aug 30 22:59:45 UTC 2016


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.
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
The introduction will add in creating security groups, and splitting the application services across two instances.
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.
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.
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.
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.

Craig Sterrett

From: Anne Gentle [mailto:annegentle at justwriteclick.com]
Sent: Tuesday, August 30, 2016 2:14 PM
To: Lana Brindley <openstack at lanabrindley.com>
Cc: openstack-docs at lists.openstack.org
Subject: Re: [OpenStack-docs] Need help with FirstApp Doc for heat



On Tue, Aug 30, 2016 at 3:53 PM, Lana Brindley <openstack at lanabrindley.com<mailto:openstack at lanabrindley.com>> wrote:
Hi Craig,

FirstApp docs aren't part of the openstack-manuals project. I think Tom (cc'd) can probably help you out with contribution information.

It is: https://github.com/openstack/governance/blob/master/reference/projects.yaml#L430

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.

Say more about the outline you're proposing, and when/where/why this chapter http://developer.openstack.org/firstapp-libcloud/orchestration.html is opposite of your thinking for inserting heat templates in the guide?

Anne



Thanks,
Lana

On 31/08/16 01:19, Sterrett, Craig wrote:
> Hello
>
> 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.
>
> Any suggestions about the best way to go about this?
>
> Thanks, Craig Sterrett
>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org<mailto:OpenStack-docs at lists.openstack.org>
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
--
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com


_______________________________________________
OpenStack-docs mailing list
OpenStack-docs at lists.openstack.org<mailto:OpenStack-docs at lists.openstack.org>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs



--
Anne Gentle
www.justwriteclick.com<http://www.justwriteclick.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20160830/6413f88c/attachment-0001.html>


More information about the OpenStack-docs mailing list