1f912ef1fd
* Adds a HowTo instruction into the "Review an environment" section of the End User Guide. Change-Id: I32d1c3fcf9565dbb404caf6c2fc603a823c7a9d6
106 lines
3.7 KiB
ReStructuredText
106 lines
3.7 KiB
ReStructuredText
.. _manage-environments:
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
=====================
|
|
Managing environments
|
|
=====================
|
|
|
|
This section is under development at the moment and
|
|
will be available soon.
|
|
|
|
Create an environment
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
To create an environment, perform the following steps:
|
|
|
|
#. In OpenStack Dashboard, navigate to Murano > Application Catalog > Environments.
|
|
|
|
#. On the :guilabel:`Environments` page, click the :guilabel:`Add New` button.
|
|
|
|
#. In the :guilabel:`Environment Name` field, enter the name for the new
|
|
environment.
|
|
|
|
#. From the :guilabel:`Environment Default Network` drop-down list, choose a
|
|
specific network, if necessary, or leave the default :guilabel:`Create New`
|
|
option to generate a new network.
|
|
|
|
.. image:: figures/env_default_network.png
|
|
:alt: Create an environment: Environment Default Network
|
|
:width: 630 px
|
|
|
|
#. Click the rightmost :guilabel:`Create` button. You will be redirected to
|
|
the page with the environment components.
|
|
|
|
Alternatively, you can create an environment automatically using the
|
|
:guilabel:`Quick Deploy` button below any application in the Application
|
|
Catalog. For more information, see: :ref:`Quick deploy <from_cat>`.
|
|
|
|
Edit an environment
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
You can edit the name of an environment. For this, perform the following steps:
|
|
|
|
#. In OpenStack Dashboard, navigate to Murano > Application Catalog > Environments.
|
|
|
|
#. Position your mouse pointer over the environment name and click the
|
|
appeared pencil icon.
|
|
|
|
#. Edit the name of the environment.
|
|
|
|
#. Click the tick icon to apply the change.
|
|
|
|
Review an environment
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
This section provides a general overview of an environment, its structure,
|
|
possible statuses, and actions. An environment groups applications together.
|
|
An application that is added to an environment is called a component.
|
|
|
|
To see an environment status, navigate to :menuselection:`Murano > Application Catalog > Environments`.
|
|
Environments may have one of the following statuses:
|
|
|
|
* **Ready to configure**. When the environment is new and contains no
|
|
components.
|
|
* **Ready to deploy**. When the environment contains a component or multiple
|
|
components and is ready for deployment.
|
|
* **Ready**. When the environment has been successfully deployed.
|
|
* **Deploying**. When the deploying is in progress.
|
|
* **Deploy FAILURE**. When the deployment finished with errors.
|
|
* **Deleting**. When deleting of an environment is in progress.
|
|
* **Delete FAILURE**. You can abandon the environment in this case.
|
|
|
|
Currently, the component status corresponds to the environment status.
|
|
|
|
To review an environment and its components, or reconfigure the environment,
|
|
click the name of an environment or simply click the rightmost
|
|
:guilabel:`Manage Components` button.
|
|
|
|
* On the :guilabel:`Components` tab you can:
|
|
|
|
* Add or delete a component from an environment
|
|
* Send an environment to deploy
|
|
* Track a component status
|
|
* Call murano actions of a particular application in a deployed environment:
|
|
|
|
.. figure:: figures/murano_actions.png
|
|
:width: 100%
|
|
|
|
For more information on murano actions, see:
|
|
:ref:`Murano actions <actions>`.
|
|
|
|
* On the :guilabel:`Topology`, :guilabel:`Deployment History`, and
|
|
:guilabel:`Latest Deployment Log` tabs of the environment page you can view
|
|
the following:
|
|
|
|
* The application topology of an environment. For more information, see:
|
|
:ref:`Application topology <application-topology>`.
|
|
* The log of a particular deployment. For more information, see:
|
|
:ref:`Deployment history <depl-history>`.
|
|
* The information on the latest deployment of an environment. For more
|
|
information, see: :ref:`Latest deployment log <latest-log>`.
|
|
|
|
Analyze logs
|
|
~~~~~~~~~~~~
|