horizon/doc/source/user/stacks.rst

Launch and manage stacks

OpenStack Orchestration is a service that you can use to orchestrate multiple composite cloud applications. This service supports the use of both the Amazon Web Services (AWS) CloudFormation template format through both a Query API that is compatible with CloudFormation and the native OpenStack Heat Orchestration Template (HOT) format through a REST API.

These flexible template languages enable application developers to describe and automate the deployment of infrastructure, services, and applications. The templates enable creation of most OpenStack resource types, such as instances, floating IP addresses, volumes, security groups, and users. Once created, the resources are referred to as stacks.

The template languages are described in the Template Guide.

Launch a stack

1. Log in to the dashboard.

2. Select the appropriate project from the drop down menu at the top left.

3. On the Project tab, open the Orchestration tab and click Stacks category.

4. Click Launch Stack.

5. In the Select Template dialog box, specify the following values:

   Template Source	Choose the source of the template from the list.
   Template URL/File/Data	Depending on the source that you select, enter the URL, browse to the file location, or directly include the template.
   Environment Source	Choose the source of the environment from the list. The environment files contain additional settings for the stack.
   Environment File/Data	Depending on the source that you select, browse to the file location, directly include the environment

6. Click Next.

7. In the Launch Stack dialog box, specify the following values:

   Stack Name	Enter a name to identify the stack.
   Creation Timeout (minutes)	Specify the number of minutes that can elapse before the launch of the stack times out.
   Rollback On Failure	Select this check box if you want the service to roll back changes if the stack fails to launch.
   Password for user "demo"	Specify the password that the default user uses when the stack is created.
   DBUsername	Specify the name of the database user.
   LinuxDistribution	Specify the Linux distribution that is used in the stack.
   DBRootPassword	Specify the root password for the database.
   KeyName	Specify the name of the key pair to use to log in to the stack.
   DBName	Specify the name of the database.
   DBPassword	Specify the password of the database.
   InstanceType	Specify the flavor for the instance.

8. Click Launch to create a stack. The Stacks tab shows the stack.

After the stack is created, click on the stack name to see the following details:

Topology

The topology of the stack.

Overview

The parameters and details of the stack.

Resources

The resources used by the stack.

Events

The events related to the stack.

Template

The template for the stack.

Manage a stack

1. Log in to the dashboard.

2. Select the appropriate project from the drop down menu at the top left.

3. On the Project tab, open the Orchestration tab and click Stacks category.

4. Select the stack that you want to update.

5. Click Change Stack Template.

6. In the Select Template dialog box, select the new template source or environment source.

7. Click Next.

   The Update Stack Parameters window appears.

8. Enter new values for any parameters that you want to update.

9. Click Update.

Delete a stack

When you delete a stack, you cannot undo this action.

1. Log in to the dashboard.
2. Select the appropriate project from the drop down menu at the top left.
3. On the Project tab, open the Orchestration tab and click Stacks category.
4. Select the stack that you want to delete.
5. Click Delete Stack.
6. In the confirmation dialog box, click Delete Stack to confirm the deletion.