68 lines
1.8 KiB
Markdown
68 lines
1.8 KiB
Markdown
# Openshift Django quickstart
|
|
|
|
This project is meant to be forked and used to quickly deploy a Django web application to an [OpenShift](https://github.com/openshift/origin) 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](https://virtualenv.pypa.io/) (you may want to use [virtualenvwrapper](http://virtualenvwrapper.readthedocs.org/)).
|
|
|
|
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. If everything is alright, you should be able to start the Django development server:
|
|
|
|
./manage.py runserver
|
|
|
|
5. 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 .`
|
|
3. Manually update `project/settings.py` to configure `SECRET_KEY`, `DATABASE` and `STATIC_ROOT` entries.
|
|
4. `./manage.py startapp openshift`, to create the welcome page's app
|
|
|
|
## Deploying to OpenShift
|
|
|
|
1. osc process -f application-template.json - | osc create -
|
|
deploy
|
|
see it running
|
|
|
|
|
|
## Next steps
|
|
|
|
### Add your own code
|
|
|
|
Add your own code, commit and redeploy.
|
|
hack (create app) & redeploy
|
|
|
|
### Add a database
|
|
|
|
Your OpenShift administrator should provide you ...
|
|
Change the configuration to point to your PostgreSQL database server.
|
|
|
|
### Scaling up
|
|
|
|
osc resize dc/web ...
|
|
|
|
### Web server logs
|
|
|
|
see gunicorn logs
|
|
|
|
|
|
## Not covered
|
|
|
|
- add application monitoring (newrelic)
|
|
- add error monitoring (rollbar)
|