File: quickstart.rst

package info (click to toggle)
murano 1%3A6.0.0-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 10,644 kB
  • sloc: python: 34,127; sh: 717; pascal: 269; makefile: 83
file content (135 lines) | stat: -rw-r--r-- 4,156 bytes parent folder | download | duplicates (2)
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
125
126
127
128
129
130
131
132
133
134
135
.. _quickstart:

==========
QuickStart
==========

This is a brief walkthrough to quickly get you familiar with the basic
operations you can perform when using the Application catalog directly
from the dashboard.

For the detailed instructions on how to :ref:`manage your environments
<manage-environments>` and :ref:`applications <manage_applications>`,
please proceed with dedicated sections.


Upload an application
~~~~~~~~~~~~~~~~~~~~~

To upload an application to the catalog:

#. Log in to the OpenStack dashboard.

#. Navigate to :menuselection:`Applications > Manage > Packages`.

#. Click on the :guilabel:`Import Package` button:

   .. image:: ../figures/qs_package_import.png
      :alt: Packages page
      :width: 600 px

#. In the :guilabel:`Import Package` dialog:

   * Select ``URL`` from the ``Package Source`` drop-down list;

   * Specify the URL in the :guilabel:`Package URL` field. Lets upload
     the Apache HTTP Server package using
     http://storage.apps.openstack.org/apps/com.example.apache.ApacheHttpServer.zip;

   * Click :guilabel:`Next` to continue:

   .. image:: ../figures/qs_package_url.png
      :width: 600 px
      :alt: Import Package dialog 1

#. View the package details in the new dialog, click :guilabel:`Next`
   to continue:

   .. image:: ../figures/qs_package_details.png
      :width: 600 px
      :alt: Import Package dialog 2

#. Select the :guilabel:`Application Servers` from the application category list,
   click :guilabel:`Create` to import the application package:

   .. image:: ../figures/qs_app_category.png
      :width: 600 px
      :alt: Import Package dialog 3

#. Now your application is available from :menuselection:`Applications >
   Catalog > Browse` page.


Deploy an application
~~~~~~~~~~~~~~~~~~~~~

To add an application to an environment's component list
and deploy the environment:

#. Log in to the OpenStack dashboard.

#. Navigate to :menuselection:`Applications > Catalog > Browse`.

#. Click on the :guilabel:`Quick Deploy` button from the required application
   from the list. Lets deploy Apache HTTP Server, for example:

   .. image:: ../figures/qs_apps.png
      :width: 600 px
      :alt: Applications page

#. Check :guilabel:`Assign Floating IP` and click :guilabel:`Next` to proceed:

   .. image:: ../figures/qs_quick_deploy.png
      :width: 600 px
      :alt: Configure Application dialog 1

#. Select the :guilabel:`Instance Image` from the drop-down list and click
   :guilabel:`Create`:

   .. image:: ../figures/qs_quick_deploy_2.png
      :width: 600 px
      :alt: Configure Application dialog 2

#. Now the Apache HTTP Server application is successfully added to the newly
   created ``quick-env-4`` environment.
   Click the :guilabel:`Deploy This Environment` button
   to start the deployment:

   .. image:: ../figures/qs_quick_env.png
      :width: 600 px
      :alt: Environment "quick-env-1" page

   It may take some time for the environment to deploy. Wait until the status
   is changed from ``Deploying`` to ``Ready``.

#. Navigate to :menuselection:`Applications > Catalog > Environments` to
   view the details.


Delete an application
~~~~~~~~~~~~~~~~~~~~~

To delete an application that belongs to the environment:

#. Log in to the OpenStack dashboard.

#. Navigate to :menuselection:`Applications > Catalog > Environments`.

#. Click on the name of the environment to view its details, which include
   components, topology, and deployment history.

#. In the :guilabel:`Component List` section, click on the
   :guilabel:`Delete Component` button next to the application to be deleted.
   Confirm the deletion.

.. note::
   If an application that you are deleting has already been deployed,
   you should redeploy it to apply the recent changes. If the environment
   has not been deployed with this component, the changes are applied
   immediately on receiving the confirmation.

.. warning::
   Due to a known bug in Murano Kilo, resources allocated by a deleted
   application might not be reclaimed until the deletion of an environment.
   See `LP1417136 <https://bugs.launchpad.net/murano/+bug/1417136>`_
   for the details.