added {README,DEPLOY}.rst

Signed-off-by: rscnt <rascnt@gmail.com>
This commit is contained in:
rascencio 2015-06-09 02:28:10 -06:00
parent ef9849c56f
commit 7066e190e8
2 changed files with 66 additions and 0 deletions

64
DEPLOY.rst Normal file
View file

@ -0,0 +1,64 @@
dynamicweb deploy steps
=======================
The Makefile has a couple of tasks that can be useful when deploying the project, if using please
configure the values for the ssh host, user, port and target directory.
1. Upload the project.
It's recommended to *make* use of the task 'rsync_upload' (See Makefile for more info.)
If there's access to the git repo, just pull from master/develop.
2. Install system dependencies.
If using debian, you could *make* use of the task 'install_debian_packages'.
One cloud use the task 'install_debian_packages', which first do an update and then
it installs the packages listed in the file ./requirements.debian.txt.
3. Make a new virtualenv with python3.
In the requirements.debian.txt, 'virtualenvwrapper' is listed, maybe you could do:
$ source /usr/share/virtualenvwrapper/virtualenvwrapper_lazy.sh
$ mkvirtualenv dynamicweb --python=/usr/bin/python3
4. Install the requirements.txt for the dynamicweb project.
Problem is you need an ssh key that exists in a github account, because I use two or three github repos
for some packages, which they egg in pypi doesn't work well with python3, it's annoying...
$ pip -r requirements.txt
5. Database/Memcached settings.
Create postgres user: https://wiki.debian.org/PostgreSql.
Create postgres database.
Set postgres settings on dynamicweb/dynamicweb/settings.py
Memcached should be already installed, we just need to check if the service is running.
6. Make migrations and sync the database
Run:
$ python manage.py makemigratoins
$ python manage.py syncdb
7. Setup a circus configuration.
[http://circus.readthedocs.org/en/0.11.1/]
You could use the circus.ungleich.ini file in configs/ :
$ circusd --daemon configs/circus.ungleich.ini
That will start a new process for the webapp.
To stop, restart, reload or see the status use circusctl.
$ circusctl
...
(circusctl) reload webapp
8. Configure nginx proxy.
There's an example for the nginx proxy in configs/nginx.proxy.conf.
For the stating server one can just copy configs/nginx.proxy.conf -> /etc/nginx/conf.d/ungleich.proxy.conf.
Remember to comment/delete/change the configuration /etc/nginx/sites-enabled/default.

2
README.rst Normal file
View file

@ -0,0 +1,2 @@
Ungleich
========