Django Poll Site

This repository contains the source code for a sample Django Polls site. The username and password for Django administration is simply "admin".

Basic Deployment

The following deployment setup is only meant as an example for those wishing to quickly deploy this application to a web server without necessarily understanding the code.

You'll need the following installed before cloning the source code:

• Python 2.7
• PyCrypto (if you're on Windows, look at these installers)
• PIP

You'll need to setup the following Amazon Web Services (AWS):

• Launch an EC2 instance running Ubuntu Server (or some other Debian-based operating system)
• Save the .pem key pair file for the EC2 instance as ~/.ssh/myserver.pem
• Create an EC2 Security Group that has port 80 opened
• Create an S3 bucket.
• Generate an AWS Access Key and Secret Access Key
• (Optional) Create an elastic IP and associate it with the EC2 instace you created
• (Optional) Create a DNS entry of your choosing to point to the elastic IP (AWS will generate their own DNS entry that you can also use, if you don't have your own domain name)

Now you're ready to checkout, configure, and deploy the code to your EC2 server.

• Fork the repository on GitHub
• Clone your forked repository
• Modify the variables at the bottom of djangopollsite/settings.py to customize the application
• Modify the HOSTNAME variables at the top of fabfile.py to point to your EC2 instance's DNS entry
• Modify the REPO_URL variable at the top of fabfile.py to point to your fork of the repository
• From the Command Line at the root of the cloned source, execute "pip install -r reqs.txt"
• From the Command Line at the root of the cloned source, execute "fab deploy"

Use a Production-Like Database

In a production environment, you should not use the accompanying SQLite database. To use a database like PostgreSQL, execute the following commands on the EC2 instance:

• sudo apt-getinstall python-psycopg2 postgresql-9.3
• sudo -u postgres psql
• CREATE USER db_user WITH PASSWORD 'db_password';
• CREATE DATABASE "db_name" encoding='UTF8';
• GRANT ALL PRIVILEGES ON DATABASE "db_name" to db_user;
• \q

Modify the database configuration in djangopollsite/settings.py to match the PostgreSQL settings found here: https://docs.djangoproject.com/en/1.7/ref/settings/#databases, restart Apache, then run migrations on the Django project to rebuild the tables in the new database:

• sudo service apache2 restart
• sudo python manage.py migrate