Revision c469ca86 docs/src/develop.rst
| b/docs/src/develop.rst | ||
|---|---|---|
| 4 | 4 |
Information on how to setup a development environment. |
| 5 | 5 |
|
| 6 | 6 |
This file documents the installation of a development environment for Synnefo. |
| 7 |
It should be read alongside README.deploy.
|
|
| 7 |
It should be read alongside :ref:`installation guide <installation>`.
|
|
| 8 | 8 |
|
| 9 |
It contains development-specific ammendments to the basic deployment steps
|
|
| 10 |
outlined in README.deploy, and development-specific notes.
|
|
| 9 |
It contains development-specific ammendments to the basic installation steps
|
|
| 10 |
outlined in `installation guide <installation>`, and development-specific notes.
|
|
| 11 | 11 |
|
| 12 | 12 |
Installing the development environment |
| 13 | 13 |
-------------------------------------- |
| 14 | 14 |
|
| 15 |
For a basic development environment you need to follow steps 0-15 |
|
| 16 |
of README.deploy, which should be read in its entirety *before* this document. |
|
| 15 |
For a basic development environment you need to follow steps |
|
| 16 |
of `installation guide <installation>`, which should be read in its |
|
| 17 |
entirety *before* this document. |
|
| 17 | 18 |
|
| 18 | 19 |
Development-specific guidelines on each step: |
| 19 | 20 |
|
| ... | ... | |
| 28 | 29 |
|
| 29 | 30 |
|
| 30 | 31 |
1. You do not need to install your own Ganeti installation. |
| 31 |
Use the RAPI endpoint as contained in settings.py.dist.
|
|
| 32 |
Use the RAPI endpoint as contained in common settings.
|
|
| 32 | 33 |
|
| 33 | 34 |
|
| 34 | 35 |
2. You do not need to setup your own RabbitMQ nodes, use the AMQP endpoints |
| 35 | 36 |
contained in settings.py.dist. |
| 36 | 37 |
|
| 37 | 38 |
3. For development purposes, Django's own development |
| 38 |
`server, ./manage.py runserver' will suffice.
|
|
| 39 |
server, `./manage.py runserver` will suffice.
|
|
| 39 | 40 |
|
| 40 | 41 |
|
| 41 | 42 |
4. Use a virtual environment to install the Django project, or packages provided |
| ... | ... | |
| 103 | 104 |
|
| 104 | 105 |
|
| 105 | 106 |
17.[OPTIONAL] Create settings.d/99-local.conf and insert local overrides for |
| 106 |
settings.d/*. This will allow pulling new files without needing to reapply |
|
| 107 |
settings.d/\*. This will allow pulling new files without needing to reapply
|
|
| 107 | 108 |
local any local modifications. |
| 108 | 109 |
|
| 109 | 110 |
|
| 110 | 111 |
South Database Migrations |
| 111 |
------------------------=
|
|
| 112 |
-------------------------
|
|
| 112 | 113 |
|
| 113 | 114 |
* Initial Migration |
| 114 | 115 |
|
| ... | ... | |
| 159 | 160 |
|
| 160 | 161 |
$ ./bin/python manage.py schemamigration db --auto |
| 161 | 162 |
+ Added field new_south_test_field on db.SynnefoUser |
| 163 |
|
|
| 162 | 164 |
Created 0002_auto__add_field_synnefouser_new_south_test_field.py. |
| 163 | 165 |
|
| 164 | 166 |
You can now apply this migration with: ./manage.py migrate db |
| ... | ... | |
| 168 | 170 |
- Migrating forwards to 0002_auto__add_field_synnefouser_new_south_test_field. |
| 169 | 171 |
> db:0002_auto__add_field_synnefouser_new_south_test_field |
| 170 | 172 |
- Loading initial data for db. |
| 173 |
|
|
| 171 | 174 |
Installing json fixture 'initial_data' from '/home/bkarak/devel/synnefo/../synnefo/db/fixtures'. |
| 172 | 175 |
Installed 1 object(s) from 1 fixture(s) |
| 173 | 176 |
|
Also available in: Unified diff