caa03e0343 | ||
---|---|---|
api | ||
core | ||
deploy | ||
docs | ||
experimental | ||
frontend | ||
logs | ||
payment | ||
settings | ||
static | ||
test | ||
test-data | ||
.gitignore | ||
.gitignore~ | ||
README.md | ||
__init__.py | ||
manage.py | ||
requirements.pip | ||
selenium-server-standalone-2.5.0.jar | ||
urls.py |
README.md
regluit
A 'monolithic' alternative to unglu
for the unglue.it website. regluit is essentially a Django project that
contains three applications: frontend
, api
and core
that can be deployed
and configured on as many ec2 instances that are needed to support traffic.
The key difference with unglu is that the
frontend
app is able to access database models from core
in the same
way that the api
is able to...which hopefully should simplify some things.
Develop
Here are some instructions for setting up regluit for development on an Ubuntu system. If you are on OS X see notes below to install python-setuptools in step 1:
aptitude install python-setuptools git
sudo easy_install virtualenv virtualenvwrapper
git clone git@github.com:Gluejar/regluit.git
cd regluit
mkvirtualenv --no-site-packages regluit
pip install -r requirements.pip
add2virtualenv ..
cp settings/dev.py settings/me.py
- edit
settings/me.py
and setEMAIL_HOST_USER
andEMAIL_HOST_PASSWORD
to your gmail username and password, if you want to see that registration emails will work properly. - edit
settings/me.py
and look at the facebook, twitter and google auth settings to enable federated logins from those sites echo 'export DJANGO_SETTINGS_MODULE=regluit.settings.me' >> ~/.virtualenvs/regluit/bin/postactivate
deactivate ; workon regluit
django-admin.py syncdb --migrate --noinput
django-admin.py celeryd --loglevel=INFO
start the celery daemon to perform asynchronous tasks like adding related editions, and display logging information in the foreground.`django-admin.py runserver 0.0.0.0:8000
(you can change the port number from the default value of 8000)- point your browser at http://localhost:8000/
Production Deployment
Below are the steps for getting regluit running on EC2 with Apache and mod_wsgi, and talking to an Amazon Relational Data Store instance.
- create an ubuntu natty ec2 instance using ami-1aad5273
sudo aptitude update
sudo aptitude upgrade
sudo aptitude install git apache libapache2-mod-wsgi mysql-client python-virtualenv python-mysqldb redis-server
sudo mkdir /opt/regluit
sudo chown ubuntu:ubuntu /opt/regluit
cd /opt
git config --global user.name "Ed Summers"
git config --global user.email "ehs@pobox.com"
ssh-keygen
- add
~/.ssh/id_rsa.pub
as a deploy key on github git clone git@github.com:Gluejar/regluit.git
cd /opt/regluit
cp settings/dev.py settings/prod.py
- create an Amazon RDS instance
- connect to it, e.g.
mysql -u root -h gluejardb.cboagmr25pjs.us-east-1.rds.amazonaws.com -p
CREATE DATABASE unglueit CHARSET utf8;
GRANT ALL ON unglueit.* TO ‘unglueit’@’ip-10-244-250-168.ec2.internal’ IDENTIFIED BY 'unglueit' REQUIRE SSL
- update settings/prod.py with database credentials
virtualenv --no-site-packages ENV
source ENV/bin/activate
pip install -r requirements.pip
echo "/opt/" > ENV/lib/python2.7/site-packages/regluit.pth
django-admin.py syncdb --migrate --settings regluit.settings.prod
sudo ln -s /opt/regluit/deploy/regluit.conf /etc/apache2/sites-available/regluit
sudo a2ensite regluit
sudo /etc/init.d/apache2 restart
sudo adduser --no-create-home celery --disabled-password --disabled-login
sudo cp celeryd /etc/init.d/celeryd
sudo chmod 755 /etc/init.d/celeryd
sudo cp celeryd.conf /etc/default/celeryd
sudo mkdir /var/log/celery
sudo chown celery:celery /var/log/celery
sudo mkdir /var/run/celery
sudo chown celery:celery /var/run/celery
sudo /etc/init.d/celeryd start
OS X Develper Notes
To run regluit on OS X you should have XCode installed
Install virtualenvwrapper according to the process at http://blog.praveengollakota.com/47430655:
sudo easy_install pip
sudo pip install virtualenv
pip install virtualenvwrapper
Edit or create .bashrc in ~ to enable virtualenvwrapper commands:
mkdir ~/.virtualenvs
- Edit .bashrc to include the following lines: export WORKON_HOME=$HOME/.virtualenvs source <your_path_to_virtualenvwrapper.sh_here>
In the above web site, the path to virtualenvwrapper.sh was /Library/Frameworks/Python.framework/Versions/2.7/bin/virtualenvwrapper.sh In Snow Leopard, this may be /usr/local/bin/virtualenvwrapper.sh
Configure Terminal to automatically notice this at startup:
Terminal –> Preferences –> Settings –> Shell
Click "run command"; add source ~/.bashrc
Selenium Install
Download the selenium server: http://selenium.googlecode.com/files/selenium-server-standalone-2.5.0.jar
Start the selenium server: 'java -jar selenium-server-standalone-2.5.0.jar'