cloudlaunch-server 2.0.2

Install Production Version

1. Install the cloudlaunch django server

$ pip install cloudlaunch-server

Once installed, You can run django admin commands as follows:

$ cloudlaunch-server django

2. Copy cloudlaunchserver/settings_local.py.sample to cloudlaunchserver/settings_local.py and make any desired configuration changes. Make sure to change the value for FERNET_KEYS variable because it is used to encrypt sensitive database fields.

3. Prepare the database with:

$ cloudlaunch-server django migrate
$ cloudlaunch-server django createsuperuser
$ cloudlaunch-server django runserver

4. Start the development server and celery task queue (along with a Redis server as the message broker), each process in its own tab.

$ python manage.py runserver
$ redis-server & celery -A cloudlaunchserver worker -l info --beat

5. Visit http://127.0.0.1:8000/admin/ to define your application and infrastructure properties.

6. Visit http://127.0.0.1:8000/api/v1/ to explore the API.

You will probably also want to install the UI for the server. The default UI is available at https://github.com/galaxyproject/cloudlaunch-ui.

Install Development Version

CloudLaunch is based on Python 3.6 and although it may work on older Python versions, 3.6 is the only supported version. Use of virtualenv is also highly advised.

1. Checkout cloudlaunch and create environment

$ mkdir launcher && cd launcher
$ virtualenv venv -p python3.6 --prompt "(cloudlaunch)" && source venv/bin/activate
$ git clone -b dev https://github.com/galaxyproject/cloudlaunch.git
$ cd cloudlaunch
$ python setup.py develop
$ cd django-cloudlaunch
$ python manage.py migrate
$ python manage.py runserver
$ python manage.py createsuperuser

2. Follow step 2 onwards from the production instructions above

History

2.0.0 (2017-01-28)

• First release of the rewritten CloudLaunch on PyPI.