Installation guide for Qinling on DevStack

Qinling is a Function as a service(FaaS) in OpenStack. This service provides a platform to support serverless functions. Qinling is a very unique name for the world, in Chinese, it means Southern Mountains!

Here is a very brief introduction to start with qinling installation on devstack environment. As a beginner, I would recommend to install Qinling to start with a tested environment, Ubuntu 16.04. I have also tested with Ubuntu 14.04 and it works fine!

1. DevStack should be run as a non-root user. Make sure you are not logged in as a root user.
2. Install git

sudo apt-get install git

3. Clone the DevStack environment by being a non-root user:

git clone https://github.com/openstack-dev/devstack 

If no branch is mentioned then by default the master branch would be cloned. If you want a specific branch to be pulled then use

git clone https://github.com/openstack-dev/devstack -b stable/queens

4. Add the Qinling plugin to the local.conf file and verify the minimum services required are included in the file.

enable_plugin qinling https://github.com/openstack/qinling

LIBS_FROM_GIT=python-qinlingclient
ENABLED_SERVICES=rabbit,mysql,key,tempest

5. Start DevStack

cd devstack/
./stack.sh

At the end of the installation, you must be able to see

This is your host IP address: 10.2.14.46
This is your host IPv6 address: ::1
Keystone is serving at http://10.2.14.46/identity/
The default users are: admin and demo
The password: password
Services are running under systemd unit files.
For more information see: 
https://docs.openstack.org/devstack/latest/systemd.html
DevStack Version: rocky
OS Version: Ubuntu 16.04 xenial

6. Check if the service is installed correctly

$ source openrc admin admin
$ openstack service list
+----------------------------------+----------+-----------------+
| ID                               | Name     | Type            |
+----------------------------------+----------+-----------------+
| a95dd762fc944546890460ef006981ec | keystone | identity        |
| b5b7c96bb62f49199ab643bc32b564a2 | qinling  | function-engine |
+----------------------------------+----------+-----------------+

A complete Qinling deployment guide as a video.

Reference:

1. https://docs.openstack.org/qinling/latest/contributor/development-environment-devstack.html

2. https://aws.amazon.com/lambda/