openstack/openstack-manuals
Code Issues Proposed changes

[user-guide] use openstack CLI instead of heat CLI

Browse Source 
The heat CLI is deprecated at now.

Change-Id: Ib4209f70a1441c89bc93ce654c360a3e00537a25
Closes-Bug: #1581726
This commit is contained in:
KATO Tomoyuki 2016-06-08 19:44:43 +09:00
parent 219e8e923e
commit 86099624de
2 changed files with 65 additions and 80 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/user-guide/source/cli_ceilometer.rst
View File

@ -59,7 +59,7 @@ Alarm
The comparison operator compares a selected meter statistic against The comparison operator compares a selected meter statistic against
an evaluation window of configurable length into the recent past. an evaluation window of configurable length into the recent past.
This example uses the :command:`heat` client to create an auto-scaling This example uses the :command:`openstack` client to create an auto-scaling
stack and the :command:`ceilometer` client to measure resources. stack and the :command:`ceilometer` client to measure resources.
#. Create an auto-scaling stack by running the following command. #. Create an auto-scaling stack by running the following command.
@ -69,27 +69,20 @@ stack and the :command:`ceilometer` client to measure resources.
.. code-block:: console .. code-block:: console
$ heat stack-create mystack -f cfn/F17/AutoScalingCeilometer.yaml -P "KeyName=heat_key" $ openstack stack create --template cfn/F17/AutoScalingCeilometer.yaml \
--parameter "KeyName=heat_key" mystack
#. List the heat resources that were created: #. List the heat resources that were created:
.. code-block:: console .. code-block:: console
$ heat resource-list mystack $ openstack stack resource list mystack
+---------------+--------------------------------------+------------------+-----------------+---------------------+
+--------------------------+-----------------------------------------+----------------+----------------------+ | resource_name | physical_resource_id | resource_type | resource_status | updated_time |
| resource_name | resource_type |resource_status | updated_time | +---------------+--------------------------------------+------------------+-----------------+---------------------+
+--------------------------+-----------------------------------------+----------------+----------------------+ | server | 1b3a7c13-42be-4999-a2a1-8fbefd00062b | OS::Nova::Server | CREATE_COMPLETE | 2013-10-02T05:53:41Z |
| CfnUser | AWS::IAM::User |CREATE_COMPLETE | 2013-10-02T05:53:41Z | | ... | ... | ... | ... | ... |
| WebServerKeys | AWS::IAM::AccessKey |CREATE_COMPLETE | 2013-10-02T05:53:42Z | +---------------+--------------------------------------+------------------+-----------------+---------------------+
| LaunchConfig | AWS::AutoScaling::LaunchConfiguration |CREATE_COMPLETE | 2013-10-02T05:53:43Z |
| ElasticLoadBalancer | AWS::ElasticLoadBalancing::LoadBalancer |UPDATE_COMPLETE | 2013-10-02T05:55:58Z |
| WebServerGroup | AWS::AutoScaling::AutoScalingGroup |CREATE_COMPLETE | 2013-10-02T05:55:58Z |
| WebServerScaleDownPolicy | AWS::AutoScaling::ScalingPolicy |CREATE_COMPLETE | 2013-10-02T05:56:00Z |
| WebServerScaleUpPolicy | AWS::AutoScaling::ScalingPolicy |CREATE_COMPLETE | 2013-10-02T05:56:00Z |
| CPUAlarmHigh | OS::Ceilometer::Alarm |CREATE_COMPLETE | 2013-10-02T05:56:02Z |
| CPUAlarmLow | OS::Ceilometer::Alarm |CREATE_COMPLETE | 2013-10-02T05:56:02Z |
+--------------------------+-----------------------------------------+-----------------+---------------------+
#. List the alarms that are set: #. List the alarms that are set:

118
doc/user-guide/source/cli_create_and_manage_stacks.rst
View File

@ -29,46 +29,35 @@ Create a stack from an example template file
.. code-block:: console .. code-block:: console
$ heat stack-create mystack --template-file /PATH_TO_HEAT_TEMPLATES/WordPress_Single_Instance.template \ $ openstack stack create --template server_console.yaml \
--parameters "InstanceType=m1.large;DBUsername=USERNAME;DBPassword=PASSWORD;KeyName=HEAT_KEY;LinuxDistribution=F17" --parameter "image=cirros" MYSTACK
The :option:`--parameters` values that you specify depend on the parameters The :option:`--parameter` values that you specify depend on the parameters
that are defined in the template. If a website hosts the template that are defined in the template. If a website hosts the template
file, you can specify the URL with the :option:`--template-url` parameter file, you can also specify the URL with the :option:`--template` parameter.
instead of the :option:`--template-file` parameter.
The command returns the following output: The command returns the following output:
.. code-block:: console .. code-block:: console
+------------------+---------------+--------------------+----------------------+ +---------------------+----------------------------------------------------------------+
| id | stack_name | stack_status | creation_time | | Field | Value |
+------------------+---------------+--------------------+----------------------+ +---------------------+----------------------------------------------------------------+
| 4c712026-dcd5... | mystack | CREATE_IN_PROGRESS | 2013-04-03T23:22:08Z | | id | 70b9feca-8f99-418e-b2f1-cc38d61b3ffb |
+------------------+---------------+--------------------+----------------------+ | stack_name | MYSTACK |
| description | The heat template is used to demo the 'console_urls' attribute |
| | of OS::Nova::Server. |
| | |
| creation_time | 2016-06-08T09:54:15 |
| updated_time | None |
| stack_status | CREATE_IN_PROGRESS |
| stack_status_reason | |
+---------------------+----------------------------------------------------------------+
.. note:: - You can also use the :option:`--dry-run` option with the
:command:`openstack stack create` command to validate a
When you run the :command:`heat stack-create` command with the
:option:`--poll` option, it prints the :command:`heat stack-show`
output first, and then continuously prints the events in log format
until the stack completes its action with success or failure.
- You can also use the :command:`template-validate` command to validate a
template file without creating a stack from it. template file without creating a stack from it.
.. note::
Previous versions of the heat client used :command:`validate` instead of
:command:`template-validate`, but it has been deprecated in favor of
:command:`template-validate`.
To do so, run the following command:
.. code-block:: console
$ heat template-validate --template-file /PATH_TO_HEAT_TEMPLATES/WordPress_Single_Instance.template
If validation fails, the response returns an error message. If validation fails, the response returns an error message.
Get information about stacks Get information about stacks
@ -82,38 +71,37 @@ number of commands.
.. code-block:: console .. code-block:: console
$ heat stack-list $ openstack stack list
+------------------+---------------+-----------------+----------------------+ +--------------------------------------+------------+-----------------+---------------------+--------------+
| id | stack_name | stack_status | creation_time | | ID | Stack Name | Stack Status | Creation Time | Updated Time |
+------------------+---------------+-----------------+----------------------+ +--------------------------------------+------------+-----------------+---------------------+--------------+
| 4c712026-dcd5... | mystack | CREATE_COMPLETE | 2013-04-03T23:22:08Z | | 70b9feca-8f99-418e-b2f1-cc38d61b3ffb | MYSTACK | CREATE_COMPLETE | 2016-06-08T09:54:15 | None |
| 7edc7480-bda5... | my-otherstack | CREATE_FAILED | 2013-04-03T23:28:20Z | +--------------------------------------+------------+-----------------+---------------------+--------------+
+------------------+---------------+-----------------+----------------------+
- To show the details of a stack, run the following command: - To show the details of a stack, run the following command:
.. code-block:: console .. code-block:: console
$ heat stack-show mystack $ openstack stack show MYSTACK
- A stack consists of a collection of resources. To list the resources - A stack consists of a collection of resources. To list the resources
and their status, run the following command: and their status, run the following command:
.. code-block:: console .. code-block:: console
$ heat resource-list mystack $ openstack stack resource list MYSTACK
+---------------------+--------------------+-----------------+----------------------+ +---------------+--------------------------------------+------------------+-----------------+---------------------+
| logical_resource_id | resource_type | resource_status | updated_time | | resource_name | physical_resource_id | resource_type | resource_status | updated_time |
+---------------------+--------------------+-----------------+----------------------+ +---------------+--------------------------------------+------------------+-----------------+---------------------+
| WikiDatabase | AWS::EC2::Instance | CREATE_COMPLETE | 2013-04-03T23:25:56Z | | server | 1b3a7c13-42be-4999-a2a1-8fbefd00062b | OS::Nova::Server | CREATE_COMPLETE | 2016-06-08T09:54:15 |
+---------------------+--------------------+-----------------+----------------------+ +---------------+--------------------------------------+------------------+-----------------+---------------------+
- To show the details for a specific resource in a stack, run the - To show the details for a specific resource in a stack, run the
following command: following command:
.. code-block:: console .. code-block:: console
$ heat resource-show mystack WikiDatabase $ openstack stack resource show MYSTACK server
- Some resources have associated metadata which can change throughout - Some resources have associated metadata which can change throughout
the lifecycle of a resource. Show the metadata by running the the lifecycle of a resource. Show the metadata by running the
@ -121,27 +109,25 @@ number of commands.
.. code-block:: console .. code-block:: console
$ heat resource-metadata mystack WikiDatabase $ openstack stack resource metadata MYSTACK server
- A series of events is generated during the lifecycle of a stack. To - A series of events is generated during the lifecycle of a stack. To
display lifecycle events, run the following command: display lifecycle events, run the following command:
.. code-block:: console .. code-block:: console
$ heat event-list mystack $ openstack stack event list MYSTACK
+---------------------+----+------------------------+-----------------+----------------------+ 2016-06-08 09:54:15 [MYSTACK]: CREATE_IN_PROGRESS Stack CREATE started
| logical_resource_id | id | resource_status_reason | resource_status | event_time | 2016-06-08 09:54:15 [server]: CREATE_IN_PROGRESS state changed
+---------------------+----+------------------------+-----------------+----------------------+ 2016-06-08 09:54:41 [server]: CREATE_COMPLETE state changed
| WikiDatabase | 1 | state changed | IN_PROGRESS | 2013-04-03T23:22:09Z | 2016-06-08 09:54:41 [MYSTACK]: CREATE_COMPLETE Stack CREATE completed successfully
| WikiDatabase | 2 | state changed | CREATE_COMPLETE | 2013-04-03T23:25:56Z |
+---------------------+----+------------------------+-----------------+----------------------+
- To show the details for a particular event, run the following - To show the details for a particular event, run the following
command: command:
.. code-block:: console .. code-block:: console
$ heat event-show WikiDatabase 1 $ openstack stack event show MYSTACK server EVENT
Update a stack Update a stack
~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~
@ -151,15 +137,21 @@ like the following command:
.. code-block:: console .. code-block:: console
$ heat stack-update mystack --template-file \ $ openstack stack update --template server_console.yaml \
/path/to/heat/templates/WordPress_Single_Instance_v2.template \ --parameter "image=ubuntu" MYSTACK
--parameters "InstanceType=m1.large;DBUsername=wp;DBPassword=verybadpassword;KeyName=heat_key;LinuxDistribution=F17" +---------------------+----------------------------------------------------------------+
+--------------------------------------+---------------+-----------------+----------------------+ | Field | Value |
| id | stack_name | stack_status | creation_time | +---------------------+----------------------------------------------------------------+
+--------------------------------------+---------------+-----------------+----------------------+ | id | 267a459a-a8cd-4d3e-b5a1-8c08e945764f |
| 4c712026-dcd5-4664-90b8-0915494c1332 | mystack | UPDATE_COMPLETE | 2013-04-03T23:22:08Z | | stack_name | mystack |
| 7edc7480-bda5-4e1c-9d5d-f567d3b6a050 | my-otherstack | CREATE_FAILED | 2013-04-03T23:28:20Z | | description | The heat template is used to demo the 'console_urls' attribute |
+--------------------------------------+---------------+-----------------+----------------------+ | | of OS::Nova::Server. |
| | |
| creation_time | 2016-06-08T09:54:15 |
| updated_time | 2016-06-08T10:41:18 |
| stack_status | UPDATE_IN_PROGRESS |
| stack_status_reason | Stack UPDATE started |
+---------------------+----------------------------------------------------------------+
Some resources are updated in-place, while others are replaced with new Some resources are updated in-place, while others are replaced with new
resources. resources.