Update README

This commit is contained in:
Rodolfo Carvalho 2015-06-01 13:12:20 +02:00
parent 4d4166b2a1
commit c09d32e758
1 changed files with 15 additions and 2 deletions

View File

@ -4,7 +4,6 @@ This is a [Django](http://www.djangoproject.com) project that you can use as the
It assumes you have access to an existing OpenShift installation.
## What has been done for you
This is a minimal Django 1.8 project. It was created with these steps:
@ -13,9 +12,16 @@ This is a minimal Django 1.8 project. It was created with these steps:
2. Manually install Django and other dependencies
3. `pip freeze > requirements.txt`
4. `django-admin startproject project .`
3. Manually update `project/settings.py` to configure `SECRET_KEY`, `DATABASE` and `STATIC_ROOT` entries.
3. Update `project/settings.py` to configure `SECRET_KEY`, `DATABASE` and `STATIC_ROOT` entries
4. `./manage.py startapp welcome`, to create the welcome page's app
From this initial state you can:
* create new Django apps
* remove the `welcome` app
* rename the Django project
* update settings to suit your needs
* install more Python libraries and add them to the `requirements.txt` file
## Local development
@ -44,6 +50,8 @@ To run this project in your development machine, follow these steps:
## Deploying to OpenShift
To follow the next steps, you need to be logged in to an OpenShift cluster and have an OpenShift project where you can work on.
The directory `openshift/` contains OpenShift application template files that you can add you your OpenShift project with:
osc create -f openshift/<TEMPLATE_NAME>.json
@ -91,6 +99,11 @@ To do that, you should add a properly configured database server or ask your Ope
Redeploy your application to have your changes applied, and open the welcome page again to make sure your application is successfully connected to the database server.
## Looking for help
If you get stuck at some point, or think that this document needs further details or clarification, you can give feedback and look for help using the channels mentioned in [the OpenShift Origin repo](https://github.com/openshift/origin), or by filling an issue.
## License
This code is dedicated to the public domain to the maximum extent permitted by applicable law, pursuant to [CC0](http://creativecommons.org/publicdomain/zero/1.0/).