Murano Helloworld

Introduction

Hello world for OpenStack Murano. For those who just started to get Murano set up for prototype or testing, it is common to run into dependencies issue of various python packages managed via native package management system and pip. The goal of this exercise is to set up Murano quickly in a docker container so that developers can focus on exploring Murano features instead of spending valable time on setting up dev environment.

This was based on the steps from http://docs.openstack.org/developer/murano/install/manual.html and http://egonzalez.org/murano-in-rdo-openstack-manual-installation/

Prerequisites

1. Install docker (e.g., on Ubuntu: https://docs.docker.com/engine/installation/linux/ubuntulinux/)
2. In existing OpenStack, create a network/subnet connected to external network and configure DNS servers by editing the subnet so that the VMs can pull packages from internet during Murano deployment.
3. User must have heat_stack_owner role in order to deploy Murano catalogy.

Start Murano Services

git clone https://github.com/hldnova/murano-helloworld

Edit start-murano.sh to set parameters to your OpenStack deployments. At a minimum, you will need to adjust the following parameters.

MURANO_CONTAINER_IP=192.168.100.70
OS_KEYSTONE_HOST=192.168.100.60
OS_USERNAME=admin
OS_PASSWORD=password
OS_PROJECT_NAME=admin

Optionally, if you want Murano to use rabbitmq on your existing OpenStack and keep the one on the container for VMs, set the following parameters.

OS_RABBIT_HOST=${MURANO_CONTAINER_IP}
OS_RABBIT_PORT=5672
OS_RABBIT_USERNAME=guest
OS_RABBIT_PASSWORD=guest

To start

# sudo ./start-murano.sh

To access Murano dashboard, point your browser to http://192.168.100.70:8000. Adjust the URL to your container host hostname/IP address.

The following services are running inside the container:

• Murano API service
• Murano Engine
• Horizon with Murano dashboard
• rabbitmq and mysql

Upon container start, Murano service and endpoints are created in keystone.

Deploy application catalog

To deploy application catalog, follow the steps in http://docs.openstack.org/developer/murano/enduser-guide/quickstart.html

You can also attach to the docker container to run murano cli client. By default, the container name is "murano" as set in the script.

# docker exec -it murano bash

~/murano# export OS_USERNAME=admin
~/murano# export OS_PASSWORD=password
~/murano# export OS_AUTH_URL=http://192.168.100.60:5000/v2.0
~/murano# export OS_TENANT_NAME=admin

Sample commands:
~/murano# murano package-list
~/murano# murano environment-list

Troubleshooting

By default, the script places logs files at /tmp/murano/logs on the docker host.

• murano-dashboard.log
• murano-init.log
• mysqld.log
• murano-api.log
• murano-engine.log
• murano-rabbitmq.log

Useful information on the VMs deployed by Murano.

• /var/log/murano-agent.log
• /etc/murano/agent.conf
• /etc/resolve.conf. Make sure your DNS servers show up there.

Common issues:

• OpenStack username/password are wrong. Check murano-init.log.
• OpenStack rabbitmq username/password are wrong or firewall blocks rabbitmq port. Check murano-engine.log and murano-api.log
• DNS servers not configured for the subnet. This will cause the VM not being able to pull packages from internet.
• Time skew between your docker host and OpenStack. This may show up as SSL error or 403 Proxy unacknowledged in /var/log/murano-agent.log on the VM.