67 Commits

Author SHA1 Message Date
Sahdev Zala
6931a96a14 Correct misleading template guide Ref example
Currently the template guide example of return value for reference shows an
arbitrary string, this patch repalces it with an appropriate return.

Change-Id: Iacea741456640e3cd6ce72c6a616c87ae79334bb
Closes-bug: #1226798
2013-10-21 10:14:36 -05:00
Jenkins
fa25beb65f Merge "Begin 3 chapters for Orch API Ref Manual" 2013-10-11 01:33:13 +00:00
Mike Asthalter
99f4f1bd9a Begin 3 chapters for Orch API Ref Manual
- The original heat wadl (heat-api-1.0.wadl) and the samples have now
been deleted from this repo. The wadl has been renamed and migrated
to the following location along with the samples:
https://github.com/openstack/api-site/blob/master/api-ref/src/wadls/
orchestration-api/src/v1/orchestration-api.wadl

- Inserted api-ref/src/wadls/heat-api/src/README.rst file in repo
that specifies the new wadl location.

- Updated pom file to latest version of clouddocs-maven-plugin.

- Currently clouddocs-maven-plugin 1.11.0 has a bug which creates
new sections for the request and response examples for each API
call. This will be fixed in an upcoming release of the plugin.

- Several remarks are inserted in the manual text and marked with
security="writeronly" so they do not appear in the output. You
are welcome to provide any answers and feedback you may have for
these remarks.

- Fix title for commit to resolve H803 build exception.

- Fix extra spaces in file /wadls/heat-api/src/README.rst, and
wrap lines in commit message at less than 70 characters.

Change-Id: I478b394268f64b41317ab77fff6d6366ddd7efa1
2013-10-09 10:04:33 -05:00
Angus Salkeld
45f1a3fb51 Add some docs on how to setup Ceilometer to use Alarms
We need to use Ceilometer's mongo backend if we want to use
alarms as the sql backend is missing a feature.

Works around bug #1223710

Change-Id: Ib569cfd650ce14480496530e7bbf1b2f71a24c02
2013-10-03 08:57:11 +10:00
Jenkins
3dbff38ef6 Merge "Fix F17 CFN link in Getting Started" 2013-10-02 22:33:47 +00:00
Jenkins
5f845e064b Merge "Purge ubuntu getting started guide of old info" 2013-10-02 19:35:37 +00:00
Jenkins
6c093a1e90 Merge "Purge Fedora getting started of old info" 2013-10-02 15:42:01 +00:00
Stephen Gordon
e90cebe2d8 Fix F17 CFN link in Getting Started
F17 CFN links in Getting Started material were no longer valid. The
missing path component (F17) has been added.

As other impacted content is slated for removal this resolves the issue
with the CFN links described in bug #1231310.

Change-Id: I21e1c69aadc4d36b7c3e3e277c01bd80345611b9
Closes-Bug: #1231310
2013-10-02 08:25:38 -04:00
Steven Hardy
d5d890a00f Purge ubuntu getting started guide of old info
The ubuntu getting started guide has not been maintained, and
most likely no longer works.  We should point people to Debian/Ubuntu
docs when they exist, or the devstack getting started guide.

Change-Id: I27a12b5366739ffcad459706c0712882b89abd2f
Closes-Bug: #1182428
2013-10-01 08:20:22 +01:00
Steven Hardy
956858a20c Purge Fedora getting started of old info
Remove all of the old tools/openstack related info from
the on_fedora docs - the best source of documentation for
Fedora is now the RDO docs (for Heat RPM package installs),
or the on_devstack guide for development installs.

Change-Id: Id33d94cc063361698eb87315a56ef7f720ecaa73
Partial-Bug: #1182428
2013-10-01 08:20:22 +01:00
Thomas Spatzier
235cbf217a Fix inconsitencies in HOT template guide and spec
Fix description of outputs section in the HOT specification, and thus make it
consistent with the HOT template guide (which is correct).

Also fix incorrect uses of the native server resource's resource name and
attribute names.

Change-Id: I98643873c370d03619ee7df9c7e09b2cdf3cf08c
Closes-Bug: #1233318
2013-09-30 20:49:52 +02:00
Steve Baker
f424d6f6c3 HOT str_replace to use string.replace, not string.Template
str_replace uses python templates, whereas Fn::Replace uses python
string.replace.

During the original review for Fn::Replace, python templates were
decided against because $ would often need double-escaping in shell scripts.
https://review.openstack.org/#/c/31736/

Having different behaviours between Fn::Replace and str_replace will
add complication for users migrating existing templates to HOT.

Another advantage of using straight string replacement is seen when
the template generates a executable script. In this case it is generally
possible to write a template that can also be executed directly in a
dev/test environment. This would often not be possible if the template
format required placeholders to be prefixed with a $.

Whatever behaviour exists when Havana is release will have to be
supported indefinitely so now is the time to decide if this is going
to be fixed.

Closes-Bug: #1228640
Change-Id: I72879b374a3c61dfe0e4004251ab709d914f2e25
2013-09-24 09:00:27 +12:00
ZhiQiang Fan
82b7aa6c6c Replace OpenStack LLC with OpenStack Foundation
Change-Id: Ia3489a1cff5070b000098e278c772cb823ae688c
Fixes-Bug: #1214176
2013-09-20 02:43:12 +08:00
Jenkins
4ac9d247d2 Merge "Remove broken tripleo links from on_devstack doc" 2013-09-18 16:59:34 +00:00
Steven Hardy
86ee53f18c Remove broken tripleo links from on_devstack doc
The links referenced in the doc no longer work

Change-Id: I0cd5f4580998457d00231a513e9328ca2e5b314c
2013-09-17 19:07:56 +01:00
Steve Baker
a5807e4271 Docs for building heat-cfntools images with diskimage-builder
Change-Id: I5ec805f8800a48b798700532551f0414fc6f6be0
2013-09-15 13:19:57 +10:00
Steve Baker
8282ab4ddb Fix H233 in sphinx config
This is being flagged in local flake8 runs.

Change-Id: I99f05996711b3851811940ad5741e96d5ae61ed6
2013-09-06 11:42:36 +12:00
Angus Salkeld
ae28bf4c89 Remove references to the multiple config files
Only refer to heat.conf in the docs and scripts.
For install.sh copy the iniset() function from devstack
to assist in setting some semi-sane defaults.

Change-Id: I933891e35103c003f1272bc89c7b42d2ad76697b
2013-09-02 10:43:21 +10:00
Angus Salkeld
83737d253d Add auto code api doc generation
This will document the python api to:
heat.api
heat.engine (not the resources as we have docs for those)
heat.rpc

(copied from ceilometer)

Change-Id: I5a400f72d4ec115fb700ab8b24dbccf0b5cd3200
2013-08-28 09:56:43 +10:00
Jenkins
b6f4bea473 Merge "Use oslo.sphinx for the doc templates" 2013-08-26 22:09:48 +00:00
Jenkins
ef54dc48dd Merge "Fix the main docs index page" 2013-08-23 06:33:39 +00:00
Jenkins
f00bc02bef Merge "Add some basic evironment docs" 2013-08-23 06:29:46 +00:00
Angus Salkeld
223671658f Use oslo.sphinx for the doc templates
This is to make the look of the developer docs consistent
with the other projects.

Change-Id: If538b5fcc974606c1628ca4a510cd1f34cb631a2
2013-08-23 12:59:54 +10:00
Angus Salkeld
76281f4fa5 Implement Fn::MemberListToMap
This is to allow the CloudWatch::Alarm to be implemented as
a resource template. The Dimensions need to be converted
from [{Name: bla, Value: foo}] into a normal dict.

So we define the Dimensions as a CommaDelimitedList in the template,
then in TemplateResource we see that the property is a list of dicts
and convert it into the aws style memberlist
 '.member.0.Name=bla,.member.0.Value=green'
then in the CW template we can do the following:

matching_metadata:
  "Fn::MemberListToMap": [Name, Value, {"Fn::   Split": [",",
{Ref: Dimensions}]}]

Note: this in not a single case usage as we can use this for the Tags
property that is in a lot of other resources.

Change-Id: I68910c51eaeb0857531028e87b89b9192db4c8ba
2013-08-23 10:40:10 +10:00
Angus Salkeld
ffc55433d4 Fix the main docs index page
This magic new line makes the main index look a lot better.
It wasn't showing the "HOT templates" level.

Change-Id: I3f7fb65911a4b0f3ad57ddf22c00ec8236261c7e
2013-08-23 09:56:13 +10:00
Angus Salkeld
898c14f822 Add some basic evironment docs
Change-Id: I6edbb7da0d333bd86eabba73631d5df3d4dc8328
2013-08-23 09:49:39 +10:00
Angus Salkeld
4b578db8fb Fix all the sphinx-build warnings
except this one:
 WARNING: toctree contains reference to nonexisting document u'api/autoindex'

Change-Id: I176a75c1c3fc9603304f11f867df54d7a7b3610a
2013-08-22 12:41:31 +10:00
Angus Salkeld
ca0bea47e5 Fix some flake8 warnings in doc/resources.py
remove doc from the ignore and just fix the issues in conf.py

Change-Id: I30833dd24409087c3482d2034a797fea3f90aa85
2013-08-22 12:41:14 +10:00
Jenkins
99b15f4eec Merge "Adding HOT str_replace and get_resource functions" 2013-08-18 14:27:03 +00:00
Thomas Spatzier
315aa5754a Fix syntax description of HOT get_attr function
Fix syntax description of get_attr function in HOT specification.
Colon instead of comma was used in array.

Contributes to blueprint hot-specification

Change-Id: I8007d476093ecd5be41020025b486147a5ac038b
2013-08-13 15:58:53 +02:00
Thomas Spatzier
9ad94efb3a Adding HOT str_replace and get_resource functions
This patch adds support for two functions, get_resource and str_replace to HOT
to enable the definition of new HOT samples. Especially str_replace aims to
simplify the definition of scripts in HOT templates.

Change-Id: Ic14fee36bdc0b9c5d79ade7ece5fa1b5331c864a
2013-08-13 08:41:10 +02:00
Steve Baker
34e47b64d9 Move heat-cfn, heat-boto, heat-watch to new repo
The new home for these tools is
https://github.com/openstack-dev/heat-cfnclient

These tools are now aimed at heat developers only
and they will not be released or packaged.

Change-Id: I1ea62ef17e81ab53cacb5e4940f0c4e2516ed383
2013-08-13 12:26:43 +12:00
Thomas Spatzier
514e9b746c Initial input for HOT template guide and spec
This patch adds initial input for the HOT template guide and the HOT
specification.
Note that content so far is based on features implemented so far and
not forward-looking in any way. Whenever new features get implemented,
the guide and spec will be extended appropriately.

Contributes to blueprint hot-specification

Change-Id: I63d29ab0a1db6703b39f981161063d4fd9f97126
2013-08-09 11:07:34 +02:00
Steven Dake
ed0fb7e823 Rename Quantum to Neutron
quantumclient is gone upstream and has been replaced by neutronclient.

This patch retains the OS::Quantum::XX namespace

Fixes: bug #1197208

Change-Id: Id48f9598ea1884132d411ad533770ae49494102b
2013-08-06 22:08:27 -07:00
Steve Baker
c1be1264b9 Functions documentation cleanup.
- Switched to definition lists for parameters to be consistent
  with generated resource docs
- Make consistent the layout of literal blocks and returns
- Other minor grammatical and layout fixes

Change-Id: I62eb179ce2a20024d2195cc7eb88e2e79bd4ae68
2013-07-27 11:37:32 +12:00
Steve Baker
4af4c719a8 Auto-document all resource types.
There are separate pages for OpenStack, AWS and Rackspace resources.

Currently the following sources are used for resource type documentation:
- the docstring for the resource class
- properties_schema
- attributes_schema

Change-Id: I901d227e8bc2a7209f216b57653da77a4f500e47
2013-07-26 09:04:12 +12:00
Steve Baker
ad945070a2 Sphinx extension to generate resource documentation.
Implements a resourcepages directive which generates resource type
documentation for any type that matches the specified type prefix.

For example:
.. resourcepages:: OS::

Implements blueprint generate-resource-docs

Change-Id: I3b2c94a766686e17e2bdbe8be27657decd65bb3e
2013-07-26 08:59:16 +12:00
Angus Salkeld
08e04e6733 Add some docs for intrinsic functions.
And start the template guide.

DocImpact
Change-Id: I4dc32dfc20b464e09b78f192b6f4931ce812fd4b
2013-07-25 14:54:15 +10:00
Jeff Sloyer
6bfd774df8 add docs from the heat wiki
updated index.rst to mimic the layout of the keystone docs
updated the structure for troubleshooting
ported howto guides from the heat wiki
ported the troubleshooting page from the heat wiki
updated the nav for the man pages and getting started
added docs for a cfn template and hot template

Change-Id: I14c1b0b6aa6ea3529c4de994851f7a798a3061bf
2013-07-17 18:35:18 -04:00
Monty Taylor
c7f313551e Fix version and location of heat doc build
pbr injects version information as part of the build_sphinx command,
so having it here is overkill.

Change-Id: I1f89e068da3e47b94434cb71db87704f9665dea2
2013-07-16 14:29:30 -04:00
Angus Salkeld
3bac114e8f Suggest the use of tripelO images
Change-Id: I8dfb18fe3f52baea99ed34cc271241b8e24c8104
2013-07-08 13:03:45 +10:00
Angus Salkeld
95ac80a0d5 API support for Environments
Support "Environment" section in the create/update body.
We the roll up the parameters and the environment and send
that as json using the rpc "params" argument. So no changes
to the rpc layer are needed. The engine knows how to deal
with both formats in the Environments class.

blueprint envirnonments
Change-Id: I6d6085d5c052a5f9115ecd46891b00d2fad4d1db
2013-06-17 20:26:28 +10:00
Dirk Mueller
f4df0b186a Fix various Sphinx errors/warnings
Change-Id: If34202291b5605302baf47c210b07ffc4ffad094
2013-06-10 23:49:40 +02:00
Shengjie Min
65e0706874 update on_devstack doc
udpate the prebuilt-jeos-image from F16 to F17

Change-Id: Iae1456e4811c029494a8c2878c9bf0c3221bc43a
Fixes: bug #1180416
2013-05-21 11:09:21 +01:00
Steven Hardy
b7c5e698e2 docs : update local template references to heat-templates url
Update references to the to-be-removed in-tree templates, so
we use raw URLs to the heat-templates repo instead

Change-Id: I2121cedc2bffe1760d845dd2d87d97dd2265f1e9
2013-05-07 16:56:41 +01:00
Steven Hardy
459fb9472c heat docs : Update jeos building documentation
Replace references to heat-jeos with documentation describing the
use of the new heat-templates/tools/heat-jeos.sh example script

fixes bug #1171602

Change-Id: I88fd2a5667cccd79a77c4a663c782fb537279fac
2013-04-30 14:51:43 +01:00
Steve Baker
c0c1768e4a Consolidated api-paste.ini file
Load a single api-paste.ini file, specified by config
Delete unused paste.ini files
Update docs for new paste.ini and config arrangement

There will be a corresponding devstack change, and once this is in
I will email the packagers on the packaging implications

Change-Id: Ic10b1a486094d15bfd832f0f934e6268ec323085
2013-04-24 09:18:15 +12:00
Steven Hardy
092222de42 heat : Getting started updates for grizzly
Update GettingStarted to drop references to F16/essex and add the
password sed which is required when running grizzly installed via
tools/openstack on Fedora

Change-Id: I08d265e2e2388b54a6aa9f47c4930c32f71f3e93
2013-04-09 10:32:13 +01:00
Jenkins
4128aeed62 Merge "ReST API: Translate the documentation to WADL" 2013-04-08 09:43:34 +00:00
Steve Baker
fc90b85bf8 Replace deprecated commands with current equivalents
Change-Id: I871d7f0e5cd0a22a284a6e6733607feafbbb52a2
2013-04-05 11:35:28 +13:00