Managing applications¶

From a zip file¶

Perform the following steps to import an application package from a .zip file:

1. In OpenStack dashboard, navigate to Applications > Manage > Packages.

2. Click the Import Package button on the top right of the page.

   

3. From the Package source drop-down list choose File, then click Browse to select a .zip file you want to import, and then click Next.

   

4. At this step, the package is already uploaded. Choose a category from the Application Category menu. You can select multiple categories while holding down the Ctrl key. If necessary, verify and update the information about the package, then click the Create button.

   

From a repository¶

Perform the following steps to import an application package from murano applications repository:

1. In OpenStack dashboard, navigate to Applications > Manage > Packages.

2. Click the Import Package button on the top right of the page.

   

3. From the Package source drop-down list, choose Repository, enter the package name, and then click Next. Note that you may also specify the version of the package.

   

4. At this step, the package is already uploaded. Choose a category from the Application Category menu. You can select multiple categories while holding down the Ctrl key. If necessary, verify and update the information about the package, then click the Create button.

   

From a bundle of applications¶

Perform the following steps to import a bundle of applications:

1. In OpenStack dashboard, navigate to Applications > Manage > Packages.

2. Click the Import Bundle button on the top right of the page.

   

3. From the Package Bundle Source drop-down list, choose Repository, enter the bundle name, and then click Create.

   

From environment details page¶

1. In OpenStack dashboard, navigate to Applications > Catalog > Environments.
2. Find the environment you want to manage and click Manage Components, or simply click on the environment’s name.
3. Procced with the Drop Components here field or the Add Component button.

Use of Drop Components here field

1. On the Environment Components page, drag and drop a desired application into the Drop Components here field under the Application Components section.

   

2. Configure the application. Note that the settings may vary from app to app and are predefined by the application author. When done, click Next, then click Create.

Now the application appears in the Component List section on the Environment Components page.

Use of Add Component button

1. On the Environment Components page, click Add Component.

   

2. Find the application you want to add and click Add to Env.

   

3. Configure the application and click Next. Note that the settings may vary from app to app and are predefined by the application author.

4. To add more applications, check Continue application adding, then click Create and repeat the steps above. Otherwise, just click Create.

   

   Now the application appears in the Component List section on the Environment Components page.

From applications catalog page¶

1. In OpenStack dashboard, navigate to Applications > Catalog > Browse.
2. On the Applications catalog page, use one of the following methods:
   • Quick deploy. Automatically creates an environment, adds the selected application, and redirects you to the page with the environment components.
   • Add to Env. Adds an application to an already existing environment.

Quick Deploy button

1. Find the application you want to add and click Quick Deploy. Let’s add Apache Tomcat, for example.

   

2. Configure the application. Note that the settings may vary from app to app and are predefined by the application author. When done, click Next, then click Create. In the example below we assign a floating IP address.

   

Now the Apache Tomcat application is successfully added to an automatically created quick-env-1 environment.

Add to Env button

1. From the Environment drop-down list, select the required environment.

   

2. Find the application you want to add and click Add to Env. Let’s add Apache Tomcat, for example.

   

3. Configure the application and click Next. Note that the settings may vary from app to app and are predefined by the application author. In the example below we assign a floating IP address.

   

4. To add more applications, check Add more applications to the environment, then click Create and repeat the steps above. Otherwise, just click Create.

   

Browse component details¶

You can browse component details to find the following information about a component:

• Name
• ID
• Type
• Instance name (available only after deployment)
• Heat orchestration stack name (available only after deployment)

To browse a component details, perform the following steps:

1. In OpenStack dashboard, navigate to Applications > Catalog > Environments.

2. Click the name of the required environment.

3. In the Component List section, click the name of the required component.

   

   The links redirect to corresponding horizon pages with the detailed information on instance and heat stack.

Application topology¶

Once you add an application to your environment, the application topology of this environment becomes available in a separate tab. The topology represents an elastic diagram showing the relationship between a component and the infrastructure it runs on. To view the topology:

1. In OpenStack dashboard, navigate to Applications > Catalog > Environments.
2. Click the name of the necessary environment.
3. Click the Topology tab.

The topology is helpful to visually display complex components, for example Kubernetes. The red icons reflect errors during the deployment while the green ones show success.

The following elements of the topology are virtual machine and an instance of dependent MuranoPL class:

Element	Meaning
	Virtual machine
	Instance

Position your mouse pointer over an element to see its name, ID, and other details.

Deployment logs¶

To get detailed information on a deployment, use:

• Deployment history, which contains logs and deployment structure of an environment.
• Latest deployment log, which contains information on the latest deployment of an environment.
• Component logs, which contain logs on a particular component in an environment.

Deployment history

To see the log of a particular deployment, proceed with the steps below:

1. In OpenStack dashboard, navigate to Applications > Catalog > Environments.

2. Click the name of the required environment.

3. Click the Deployment History tab.

4. Find the required deployment and click Show Details.

5. Click the Logs tab to see the logs.

   

Latest deployment log

To see the latest deployment log, proceed with the steps below:

1. In OpenStack dashboard, navigate to Applications > Catalog > Environments.
2. Click the name of the required environment.
3. Click the Latest Deployment Log tab to see the logs.

Component logs

To see the logs of a particular component of an environment, proceed with the steps below:

1. In OpenStack dashboard, navigate to Applications > Catalog > Environments.

2. Click the name of the required environment.

3. In the Component List section, click the required component.

4. Click the Logs tab to see the component logs.