A most basic template in OpenStack End User Guide  - current - heat version

Bug #1431217 reported by Marco CONSONNI
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
openstack-manuals
Fix Released
High
Darren Chan

Bug Description

In paragraph "A most basic template" I read "Each HOT template has to include the heat_template_version key with value 2013-05-23".

This is not correct, in general, because I think you should write the heat version you want to use.
In addition, the sentence is in contrast with the example reported in par. "Making your template resource more transparent" (just to mention one) where the version is 2014-10-16.

In this context it would be very useful to have the list of the available versions that can be found here http://docs.openstack.org/developer/heat/template_guide/hot_spec.html#hot-spec or, better, a reference to the URL where one can find the available versions.
In case the developers update the page, the document is implicitly and automatically updated.

-----------------------------------
Built: 2015-03-12T04:34:49 00:00
git SHA: 0bdf3509022646e1bbc95ce6a8257e7deec4ff70
URL: http://docs.openstack.org/user-guide/content/a-most-basic-template.html
source File: file:/home/jenkins/workspace/openstack-manuals-tox-doc-publishdocs/doc/user-guide/hot/section_hello_world.xml
xml:id: a-most-basic-template

Revision history for this message
Marco CONSONNI (marco-consonni) wrote :

Additional comment.

In this context it would be useful to have indications on how to retrieve the HOT version currently supported by the heat service you are using.
According to https://blueprints.launchpad.net/heat/+spec/heat-build-info the engineers have implemented a new feature that corresponds to command "heat build-info" for that purpose.

The funny thing is that, at the time of writing, the command does not retrieve useful information because when I submit that it returns:

api "revision": "unknown"
engine "revision": "unknown"

This behavior is due to the implementation that gets these two pieces of information from a configuration file and currently they are both set to "unknown" https://review.openstack.org/#/c/55434/11/etc/heat/heat.conf.sample

Changed in openstack-manuals:
status: New → Triaged
importance: Undecided → High
Revision history for this message
Darren Chan (dazzachan) wrote :
Darren Chan (dazzachan)
Changed in openstack-manuals:
assignee: nobody → Darren Chan (dazzachan)
milestone: none → liberty
Changed in openstack-manuals:
status: Triaged → In Progress
Changed in openstack-manuals:
assignee: Darren Chan (dazzachan) → Andreas Jaeger (jaegerandi)
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-manuals (master)

Reviewed: https://review.openstack.org/181788
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=2fc412580065bcd57217b7733fd739d1aa4a4c41
Submitter: Jenkins
Branch: master

commit 2fc412580065bcd57217b7733fd739d1aa4a4c41
Author: darrenchan <email address hidden>
Date: Mon May 11 13:11:31 2015 +1000

    Minor edits in the HOT guide

    Reworded hot version configuration and added link to the HOT specification.

    backport: none
    Closes-Bug: #1431217
    Change-Id: I65fc67cb658fe22f4731a8356e05517594802851

Changed in openstack-manuals:
status: In Progress → Fix Released
Changed in openstack-manuals:
assignee: Andreas Jaeger (jaegerandi) → Darren Chan (dazzachan)
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/openstack-manuals 15.0.0

This issue was fixed in the openstack/openstack-manuals 15.0.0 release.

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.