blob: 0d1576a9225e18541d141147b076e06274680d68 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
..
Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.
.. _create-a-stack:
Creating your first stack
=========================
Confirming you can access a Heat endpoint
-----------------------------------------
Before any Heat commands can be run, your cloud credentials need to be
sourced::
$ source openrc
You can confirm that Heat is available with this command::
$ openstack stack list
This should return an empty line
Preparing to create a stack
---------------------------
Download and register the image::
$ wget http://cloud.fedoraproject.org/fedora-20.x86_64.qcow2
$ openstack image create \
--disk-format=qcow2 \
--container-format=bare \
--file=fedora-20.x86_64.qcow2 \
fedora-20.x86_64
Your cloud will have different flavors and images available for
launching instances, you can discover what is available by running::
$ openstack flavor list
$ openstack image list
To allow you to SSH into instances launched by Heat, a keypair will be
generated::
$ openstack keypair create heat_key > heat_key.priv
$ chmod 600 heat_key.priv
Launching a stack
-----------------
Now lets launch a stack, using an example template from the heat-templates repository::
$ openstack stack create -t https://opendev.org/openstack/heat-templates/raw/src/branch/master/hot/F20/WordPress_Native.yaml --parameter key_name=heat_key --parameter image_id=my-fedora-image --parameter instance_type=m1.small teststack
Which will respond::
+--------------------------------------+-----------+--------------------+----------------------+
| ID | Name | Status | Created |
+--------------------------------------+-----------+--------------------+----------------------+
| 718a712a-2571-4eac-aa03-426de00ecb43 | teststack | CREATE_IN_PROGRESS | 2017-04-11T03:06:24Z |
+--------------------------------------+-----------+--------------------+----------------------+
.. note::
Link on Heat template presented in command above should reference on RAW
template. In case if it be a "html" page with template, Heat will return
an error.
.. note::
You cannot rename a stack after it has been launched.
List stacks
~~~~~~~~~~~
List the stacks in your tenant::
$ openstack stack list
List stack events
~~~~~~~~~~~~~~~~~
List the events related to a particular stack::
$ openstack stack event list teststack
Describe the wordpress stack
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Show detailed state of a stack::
$ openstack stack show teststack
Note: After a few seconds, the stack_status should change from ``IN_PROGRESS``
to ``CREATE_COMPLETE``.
Verify instance creation
~~~~~~~~~~~~~~~~~~~~~~~~
Because the software takes some time to install from the repository, it may be
a few minutes before the Wordpress instance is in a running state.
Point a web browser at the location given by the ``WebsiteURL`` output as shown
by ``openstack stack output show``::
$ WebsiteURL=$(openstack stack output show teststack WebsiteURL -c output_value -f value)
$ curl $WebsiteURL
Delete the instance when done
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Note: The list operation will show no running stack.::
$ openstack stack delete teststack
$ openstack stack list
You can explore other heat commands by referring to the
:python-heatclient-doc:`Heat command reference <cli/>` for the
:python-openstackclient-doc:`OpenStack Command-Line Interface <>`; then read
the :ref:`template-guide` and start authoring your own templates.
|
