No description
Find a file
2015-05-25 22:31:57 +02:00
.sti/bin Run django migrations during deploy 2015-05-22 14:03:13 +02:00
openshift Include database info in welcome page 2015-05-25 21:08:30 +02:00
project Remove custom debug toolbar settings 2015-05-24 14:17:14 +02:00
scripts Add script to run command in container 2015-05-24 14:32:06 +02:00
.gitignore Add Django project 2015-05-19 12:19:44 +02:00
application-template.json Add ConfigChange trigger 2015-05-25 22:31:57 +02:00
gunicorn_conf.py Add config to send access log to file 2015-05-22 17:10:19 +02:00
manage.py Add Django project 2015-05-19 12:19:44 +02:00
README.md Update README 2015-05-24 14:10:08 +02:00
requirements.txt Add Django Debug Toolbar 2015-05-24 13:09:31 +02:00

Openshift Django quickstart

This project is meant to be forked and used to quickly deploy a Django web application to an OpenShift cluster. It assumes you have access to an existing OpenShift installation.

You can use this as a starting point to build your own application.

Getting started

  1. (optional) Create and activate a virtualenv (you may want to use virtualenvwrapper).

  2. Fork this repo and clone your fork:

    git clone https://github.com/rhcarvalho/openshift-django-quickstart.git

  3. Install dependencies:

    pip install -r requirements.txt

  4. Create a development database:

    ./manage.py migrate

  5. If everything is alright, you should be able to start the Django development server:

    ./manage.py runserver

  6. Open your browser and go to http://127.0.0.1:8000, you will be greeted with a welcome page.

What has been done for you

This is a minimal Django 1.8 project. It was created with these steps:

  1. Create a virtualenv
  2. Manually install requirements
  3. pip freeze > requirements.txt
  4. django-admin startproject PROJECT_NAME .
  5. Manually update project/settings.py to configure SECRET_KEY, DATABASE and STATIC_ROOT entries.
  6. ./manage.py startapp openshift, to create the welcome page's app

Deploying to OpenShift

The file application-template.json contains an OpenShift application template that you can add you your OpenShift project with:

  • osc create -f application-template.json

Now you can browse to your OpenShift web console and create a new app from the 'django-quickstart' template. After adjusting your preferences (or accepting the defaults), your application will be built and deployed.

You will probably want to set the GIT_REPOSITORY parameter to point to your fork.