<div dir="ltr"><div><div><div>Hello,<br><br>I would like to suggest an idea for "heat-templates target audiences" for today heat meeting.<br><br>When I discovered AWS CloudFormation last yeat, creating my first templates, I had difficulties searching information about how to implement ressources. The main reason was the different places of documentation :<br>
<br>- AWS CloudFormation documentation(1) : with some example templates, template snippets, and template references.<br>- The documentation of the ressource itself (EC2, EBS, etc), when you don't know what is a specific parameter, not well described in CloudFormation doc.<br>
- CloudFormation template page (2) : with some templates showing how to deploy with different tools, and some opensource application.<br><br>Most of the time the information I was looking for was in one ot these 3 sources, but hard to find.<br>
Template references shows a description of each ressource's property. It does not show how to use linked ressources, like an EC2 instance and an EBS volume together (or sometime, in the snippets, but it's really not comprehensive for complicated ressources).<br>
When you don't have the information in this doc, you have to find a template doing what you want and copy.<br><br>I think Heat could be better than that. Here is my idea.<br>We should only have 2 sources of information when someone wants to know how to use a ressource in a template :<br>
<br>- First in the documentation, with all paremeters explained, refering each time to a snippet.<br>- Then heat-repository, a collection of application template like « Open Source Applications » in AWS template page (2).<br>
<br>When a user wants to know how to use a ressource, he can first use the documentation, and then see an example of a real template with an app close to his app (same language, same architecture).<br><br>My point is, we should not mix documentation example and template like AWS does. Heat-template should only have production ready template, with app like Drupal, Mediawiki, Redmine, etc, with 1 or 2 version : Multi-AZ or not.<br>
<br><br>1 - <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html">http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html</a><br>2 - <a href="http://aws.amazon.com/fr/cloudformation/aws-cloudformation-templates/">http://aws.amazon.com/fr/cloudformation/aws-cloudformation-templates/</a><br>
<br></div><br></div>I try to explain my idea in english, not my native language, so If something means nothing, please tell me :)<br><br></div>Pierre FREUND<br><div><div><div><br></div></div></div></div><div class="gmail_extra">
<br><br><div class="gmail_quote">2013/5/14 Randall Burt <span dir="ltr"><<a href="mailto:randall.burt@rackspace.com" target="_blank">randall.burt@rackspace.com</a>></span><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On May 14, 2013, at 9:59 AM, Steven Hardy <<a href="mailto:shardy@redhat.com">shardy@redhat.com</a>><br>
<div class="im"> wrote:<br>
<br>
> Hi!<br>
><br>
> I wanted to communicate a recent change we've made on the Heat project,<br>
> which has moved our example/demo templates and associated tools into a new<br>
> repository:<br>
><br>
> <a href="https://github.com/openstack/heat-templates" target="_blank">https://github.com/openstack/heat-templates</a><br>
><br>
> Contributions and fixes can be provided via gerrit, using the same workflow<br>
> as we do for code:<br>
><br>
> <a href="https://wiki.openstack.org/wiki/Gerrit_Workflow" target="_blank">https://wiki.openstack.org/wiki/Gerrit_Workflow</a><br>
><br>
> We've also created a new project in Launchpad, so we can track<br>
> template-related issues and features separately from the main codebase:<br>
><br>
> <a href="https://launchpad.net/heat-templates" target="_blank">https://launchpad.net/heat-templates</a><br>
><br>
> All of our documentation and wiki pages *should* now point to the new repo,<br>
> but if you do find any stale references to the old in-tree templates, please<br>
> do let us know :)<br>
><br>
> The initial aim of this repository is to provide working examples, which<br>
> demonstrate core Heat features, and also to provide a platform for easier<br>
> collaboration while we work through the design process for the proposed new<br>
> DSL/HOT template format.<br>
><br>
> I'd also be keen to see some discussion about what the scope should be for the<br>
> target audience, ie if this could be an appropriate place to grow a community<br>
> of testers and template-authors and promote collaboration and reuse beyond<br>
> developers writing test/demo templates - some discussion in #heat recently<br>
> indicates this may be a topic people are interested in debating :)<br>
<br>
</div>+1 to this, though I think we'd want to separate "supported" examples used for testing/validation from contributed templates. Should these contributed templates be limited to using resources provided in the core distribution or can they include optional resource plug-ins (from Stackforge for example)? Personally I think it would be fine as long as the all resources used are publicly available.<br>

<div class="HOEnZb"><div class="h5"><br>
><br>
> Thanks!<br>
><br>
> Steve<br>
><br>
> _______________________________________________<br>
> OpenStack-dev mailing list<br>
> <a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br>
<br>
_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</div></div></blockquote></div><br></div>