openstack-manuals/doc/user-guide/source/dashboard-stacks.rst
Maria Zlatkova b94d0b58d4 [user-guide] Changes underscore to hyphen in RST files
Adds the following changes:

- Renames all the RST files in the user-guide folder to use
  hyphens instead of underscores;
- Adds redirects to the renamed files to .htaccess.

Change-Id: Ic5f1a90421add35d001363cd39bada0b56a04d7f
Implements: blueprint consistency-file-rename
2016-08-10 18:00:13 +03:00

7.2 KiB

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 <http://docs.openstack.org/developer/heat/template_guide/index. html> in the Heat developer documentation <http://docs. openstack.org/developer/heat/>.

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.

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.