Update readme description

Add installation manual for CentOS and fix
steps for application deploying and running under Ubuntu.

Changed default port for webui from 8000 to 8008 to run it near other
web applications.

Removed old Procfile for production.

Change-Id: I1472bf2e726078b3d12a7b978cb10ebe8cb8cc09
Closes-Bug: #1256920
This commit is contained in:
Peter Lomakin 2013-12-02 17:32:58 +04:00
parent 5d9a7d3b04
commit a9b8de3766
4 changed files with 25 additions and 10 deletions

View File

@ -1,2 +0,0 @@
webui: PYTHONPATH=joker: gunicorn --error-logfile - --log-level info rubick.webui:app --bind 0.0.0.0:8000
worker: PYTHONPATH=joker: celery worker --app=rubick.celery:app

View File

@ -11,24 +11,40 @@ Installation
### Completely environment in VirtualBox via Vagrant
1. Install vagrant(MacOS, Windows, Ubuntu) - http://downloads.vagrantup.com/tags/v1.3.3 and latest version of Virtualbox
2. ```$ vagrant up && vagrant provision```
3. After that you can access application on http://host_machine_ip:8000/
3. After that you can access application on http://host_machine_ip:8008/
4. For testing purposes of your application you can install latest-devstack installation via vagrant. We strongly recommend you to use this repo: https://github.com/lorin/devstack-vm. There are a lot of choices for devstack installation for Rubick to validate: with or without neutron\swift\security_groups\tempest etc.
5. After that youll get full worked environment with Rubick and OpenStack.
### Manual installation and running
For Ubuntu:
```shell
$ git clone https://github.com/stackforge/rubick && cd rubick
$ sudo apt-get install build-essential mongodb-server redis-server python-pip
$ sudo pip install -r requirements.txt
$ python webui.py &
$ celery worker --app=rubick.celery:app &
$ honcho start
```
All steps for manual deployment and running the app you can find here: /vagrant/cookbooks/openstack-validator/recipes/default.rb
For CentOS:
Follow the official documentation to take enable EPEL repo in your system: http://fedoraproject.org/wiki/EPEL/FAQ#How_can_I_install_the_packages_from_the_EPEL_software_repository
After that install dependencies and run an application.
```shell
$ git clone https://github.com/stackforge/rubick && cd rubick
$ sudo yum install build-essential mongodb-server redis-server python-pip
$ sudo pip install -r requirements.txt
$ honcho start
```
Note: If you use fuel-pm node as a rubicks destination node, you'll need to return CentOS base repositaries in the yum settings.
Note2: All steps for manual deployment and running the app you can find here: /vagrant/cookbooks/openstack-validator/recipes/default.rb
Rubick usage
-------------
Open http://host_machine_ip:8000/ with web-browser, host_machine_ip - address your application is installed.
Open http://host_machine_ip:8008/ with web-browser, host_machine_ip - address your application is installed.
Add new cluster by pushing the button “Add cluster” and fill the fields:
1. “Cluster name” - with name of your cluster (e.g. local_devstack )
@ -44,7 +60,7 @@ Rubick Command Line usage examples
```
$ python rubick/cli.py -h
$ python rubick/cli.py -l -v http://<host>:8000
$ python rubick/cli.py -l -v http://<host>:8008
$ python rubick/cli.py -a -n 'New_cluster_name' -d 'New description' -H 'root@10.10.3.1:2022' -k ~/.ssh/id_rsa http://<host>:8008
```
@ -54,3 +70,4 @@ Hacking
-------
To check project on compliance to PEP8 run command use: tox -v.

2
Vagrantfile vendored
View File

@ -6,7 +6,7 @@ Vagrant.configure("2") do |config|
config.vm.define "web" do |web|
web.vm.box = "ubuntu12.04-server-amd64"
web.vm.box_url = "http://goo.gl/8kWkm"
web.vm.network "forwarded_port", guest: 8000, host: 8000, host_ip: '0.0.0.0'
web.vm.network "forwarded_port", guest: 8008, host: 8008, host_ip: '0.0.0.0'
web.vm.provider "virtualbox" do |vb|
vb.customize ["modifyvm", :id, "--memory", "1024"]
vb.customize ["modifyvm", :id, "--cpus", "1"]

View File

@ -204,4 +204,4 @@ def job(id):
return json.dumps({'state': str(job.state).lower()})
if __name__ == '__main__':
app.run(host='0.0.0.0', port=8000, debug=True)
app.run(host='0.0.0.0', port=8008, debug=True)