summaryrefslogtreecommitdiff
path: root/doc/source/user/stacks.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/source/user/stacks.rst')
-rw-r--r--doc/source/user/stacks.rst149
1 files changed, 0 insertions, 149 deletions
diff --git a/doc/source/user/stacks.rst b/doc/source/user/stacks.rst
deleted file mode 100644
index 7767976..0000000
--- a/doc/source/user/stacks.rst
+++ /dev/null
@@ -1,149 +0,0 @@
1========================
2Launch and manage stacks
3========================
4
5OpenStack Orchestration is a service that you can use to
6orchestrate multiple composite cloud applications. This
7service supports the use of both the Amazon Web Services (AWS)
8CloudFormation template format through both a Query API that
9is compatible with CloudFormation and the native OpenStack
10Heat Orchestration Template (HOT) format through a REST API.
11
12These flexible template languages enable application
13developers to describe and automate the deployment of
14infrastructure, services, and applications. The templates
15enable creation of most OpenStack resource types, such as
16instances, floating IP addresses, volumes, security groups,
17and users. Once created, the resources are referred to as
18stacks.
19
20The template languages are described in the `Template Guide
21<https://docs.openstack.org/heat/latest/template_guide/>`_.
22
23Launch a stack
24~~~~~~~~~~~~~~
25
26#. Log in to the dashboard.
27#. Select the appropriate project from the drop down menu at the top left.
28#. On the :guilabel:`Project` tab, open the :guilabel:`Orchestration` tab and
29 click :guilabel:`Stacks` category.
30#. Click :guilabel:`Launch Stack`.
31#. In the :guilabel:`Select Template` dialog box, specify the
32 following values:
33
34 +---------------------------------------+-------------------------------+
35 | :guilabel:`Template Source` | Choose the source of the |
36 | | template from the list. |
37 +---------------------------------------+-------------------------------+
38 | :guilabel:`Template URL/File/Data` | Depending on the source that |
39 | | you select, enter the URL, |
40 | | browse to the file location, |
41 | | or directly include the |
42 | | template. |
43 +---------------------------------------+-------------------------------+
44 | :guilabel:`Environment Source` | Choose the source of the |
45 | | environment from the list. |
46 | | The environment files contain |
47 | | additional settings for the |
48 | | stack. |
49 +---------------------------------------+-------------------------------+
50 | :guilabel:`Environment File/Data` | Depending on the source that |
51 | | you select, browse to the |
52 | | file location, directly |
53 | | include the environment |
54 +---------------------------------------+-------------------------------+
55
56#. Click :guilabel:`Next`.
57#. In the :guilabel:`Launch Stack` dialog box, specify the
58 following values:
59
60 +---------------------------------+---------------------------------+
61 | :guilabel:`Stack Name` | Enter a name to identify |
62 | | the stack. |
63 +---------------------------------+---------------------------------+
64 | :guilabel:`Creation Timeout` | Specify the number of minutes |
65 | :guilabel:`(minutes)` | that can elapse before the |
66 | | launch of the stack times out. |
67 +---------------------------------+---------------------------------+
68 | :guilabel:`Rollback On Failure` | Select this check box if you |
69 | | want the service to roll back |
70 | | changes if the stack fails to |
71 | | launch. |
72 +---------------------------------+---------------------------------+
73 | :guilabel:`Password for user` | Specify the password that |
74 | :guilabel:`"demo"` | the default user uses when the |
75 | | stack is created. |
76 +---------------------------------+---------------------------------+
77 | :guilabel:`DBUsername` | Specify the name of the |
78 | | database user. |
79 +---------------------------------+---------------------------------+
80 | :guilabel:`LinuxDistribution` | Specify the Linux distribution |
81 | | that is used in the stack. |
82 +---------------------------------+---------------------------------+
83 | :guilabel:`DBRootPassword` | Specify the root password for |
84 | | the database. |
85 +---------------------------------+---------------------------------+
86 | :guilabel:`KeyName` | Specify the name of the key pair|
87 | | to use to log in to the stack. |
88 +---------------------------------+---------------------------------+
89 | :guilabel:`DBName` | Specify the name of the |
90 | | database. |
91 +---------------------------------+---------------------------------+
92 | :guilabel:`DBPassword` | Specify the password of the |
93 | | database. |
94 +---------------------------------+---------------------------------+
95 | :guilabel:`InstanceType` | Specify the flavor for the |
96 | | instance. |
97 +---------------------------------+---------------------------------+
98
99#. Click :guilabel:`Launch` to create a stack. The :guilabel:`Stacks`
100 tab shows the stack.
101
102After the stack is created, click on the stack name to see the
103following details:
104
105Topology
106 The topology of the stack.
107
108Overview
109 The parameters and details of the stack.
110
111Resources
112 The resources used by the stack.
113
114Events
115 The events related to the stack.
116
117Template
118 The template for the stack.
119
120Manage a stack
121~~~~~~~~~~~~~~
122
123#. Log in to the dashboard.
124#. Select the appropriate project from the drop down menu at the top left.
125#. On the :guilabel:`Project` tab, open the :guilabel:`Orchestration` tab and
126 click :guilabel:`Stacks` category.
127#. Select the stack that you want to update.
128#. Click :guilabel:`Change Stack Template`.
129#. In the :guilabel:`Select Template` dialog box, select the
130 new template source or environment source.
131#. Click :guilabel:`Next`.
132
133 The :guilabel:`Update Stack Parameters` window appears.
134#. Enter new values for any parameters that you want to update.
135#. Click :guilabel:`Update`.
136
137Delete a stack
138~~~~~~~~~~~~~~
139
140When you delete a stack, you cannot undo this action.
141
142#. Log in to the dashboard.
143#. Select the appropriate project from the drop down menu at the top left.
144#. On the :guilabel:`Project` tab, open the :guilabel:`Orchestration` tab and
145 click :guilabel:`Stacks` category.
146#. Select the stack that you want to delete.
147#. Click :guilabel:`Delete Stack`.
148#. In the confirmation dialog box, click :guilabel:`Delete Stack`
149 to confirm the deletion.