bewiwi/demoinstance repository overview

⁠Project DemoInstance

DemoInstance provides an interface to deploy instance of your project on an Openstack cloud. With this project your futur client can deploy an isolated instance for a defined time.

⁠Interface example

⁠Pre requisites

• Python & Python devel & Python PIP
• GCC
• MySQL server / MySQL devel

⁠Installation

# npm install -g bower
# npm install -g grunt-cli
$ git clone [email protected]:bewiwi/DemoInstance.git
$ cd DemoInstance
$ pip install -r requirement.txt
$ cd web/
$ npm install
$ bower install
$ grunt
$ cd -
$ cp config-dist.ini config.ini
$ vim config.ini

⁠Configuration

DemoInstance have a single ini config file : config.ini In this file you have many section.

⁠DEFAULT

[DEFAULT]
log_level=DEBUG
security_type=open

⁠MAIL

[MAIL]
host=smtp.gmail.com
port=587
user=user
password=password
[email protected]
tls=yes

⁠AUTH_LDAP

If you use security_type = auth_ldap

[AUTH_LDAP]
host=ldap://ldapOrActiveDirectoyHostname
bind_user=cn=read,OU=Users,dc=mydomain,dc=local
bind_password=readpassword
search_base=OU=Users,dc=abc-objectif,dc=local
login_attribute=sAMAccountName
email_attribute=mail

⁠PROV_OPENSTACK

If you use provider = openstack

[PROV_OPENSTACK]
user=user
password=password
tenant=project
url=http://srv-openstack:5000/v2.0
region=regionOne

⁠HTTP

[HTTP]
port=8080

⁠DATABASE

[DATABASE]
connection:mysql://root@localhost:3306/demo

Only tested with MySQL and SQLite

⁠IMAGE

[IMAGE] section is the template of any [IMAGE_].
You can define in this section variable shared with all [IMAGE_]. The [IMAGE] section do not define a runnable image, only section with [IMAGE_ImageName] format define runnable image.

Parameter in this section depends on which provider you are using. Moreover some parameters are used by DemoInstance itself

⁠config

⁠Openstack image parameter

If you use provider = openstack you must / can add this parameter to your image configuration

⁠example

Example with only one instance:

[IMAGE]

[IMAGE_MYAPP]
name=MyAPP
desc=My first app
info=Login/Password are<br />test/test
img=/instance_image/example.png
image_id=MonImage1
flavor_id=m1.tiny
time_default=20
prefix=myapp_
check_url=http://%ip%/ok
soft_url=http://%ip%/
max_instance=10
pool=2
meta=disk=ssd,ram=ECC

Example with three instances

[IMAGE]
flavor_id=1

[IMAGE_MYAPP1]
name=MyAPP
desc=My first app
...

[IMAGE_MYAPP2]
name=MyNewAPP
desc=My second app
...


[IMAGE_MYAPP3]
name=MyLastAPP
desc=My last app
flavor_id=2
...

In this example just [IMAGE_MYAPP3] run with flavor_id=2 and other image run with flavor_id=1 defined in [IMAGE]

⁠Ini format Tips

Sometimes, you need a value to be on multi-line. To do that you can write your key:parameter like this:

user_data:#cloud-config
    password: mypassword
    chpasswd: { expire: False }
    ssh_pwauth: True

This is defined here : http://tools.ietf.org/html/rfc822.html⁠ on LONG HEADER FIELDS section

⁠Run

python demo.py

Or

./demo.sh start

⁠Init script

⁠Redhat/Centos

Template for Centos is avaible in samples/ Just link file to /etc/init.d and maybe add it to boot sequence

ln -s /where/is/your/project /etc/init.d/demoinstance
chkconfig demoinstance on

Don't forget to add config file in /etc/sysconfig/demoinstance

cat <EOF /etc/sysconfig/demoinstance
# PID file
PIDFILE=/tmp/test.pid
# Log file
LOGFILE=/tmp/log.log
# Process's user
USER=demoinstance
# Demoinstance folder
DEMO_DIR=/opt/demoinstance
EOF

⁠Debian/Ubuntu

If you want this you can do it and make me a PR

⁠Contribute

If you want to contribute you're welcome. Just create issues or make some PR.

⁠Dev env

A docker env was set to help you to dev. To start just configure a good config.ini and run

fig up

If you don't have docker you can directly install needed lib on your hosts, it works well to

⁠Run test

To run test just run this command on with an URL od demoinstance run with test/samples/config/config-fake.ini

python test.py -u -f -U http://127.0.0.1:8080

⁠Add auth system

To add a new auth system is really simple, just add a class in Demo/auth directory which is son of DemoAuth and just add 2 functions with this prototype :

    def __init__(self, config):
        pass
        
    #Must return email if ok or False
    def check_auth(self, user, password):
        pass

init parameter is just "config" which is a dictionnary of your config section.

Config section name must be your filename (without '.py') uppercase and your class name must be a transformation of your filename like this : 'auth_ldap.py => AuthLdap'

⁠Add a new provider

To add a new provider, write a class in Demo/provider which herit from DemoProv.