Revision 442b6550 snf-app/docs/src/asterias-dev-guide.rst
| b/snf-app/docs/src/asterias-dev-guide.rst | ||
|---|---|---|
| 1 |
.. _snf-asterias-developer-guide:
|
|
| 1 |
.. _asterias-developer-guide: |
|
| 2 | 2 |
|
| 3 | 3 |
=============== |
| 4 | 4 |
Developer Guide |
| ... | ... | |
| 7 | 7 |
This is the asterias developer guide. |
| 8 | 8 |
|
| 9 | 9 |
It is intended for developers, wishing to implement new functionality |
| 10 |
inside :ref:`asterias <snf-asterias>`.
|
|
| 10 |
inside :ref:`asterias <asterias>`. |
|
| 11 | 11 |
|
| 12 |
It assumes thorough familiarity with the :ref:`snf-asterias-admin-guide`.
|
|
| 12 |
It assumes thorough familiarity with the :ref:`asterias-admin-guide`. |
|
| 13 | 13 |
|
| 14 | 14 |
It contains development-specific ammendments to the basic installation steps |
| 15 | 15 |
outlined in `installation guide <installation>`, and development-specific |
| ... | ... | |
| 92 | 92 |
* Clone the repository of the synnefo software components you wish |
| 93 | 93 |
to work on, e.g.: |
| 94 | 94 |
|
| 95 |
.. code-block:: console |
|
| 96 |
|
|
| 97 |
(synnefo-env)$ git clone https://code.grnet.gr/git/synnefo synnefo |
|
| 98 |
|
|
| 95 |
.. code-block:: console
|
|
| 96 |
|
|
| 97 |
(synnefo-env)$ git clone https://code.grnet.gr/git/synnefo synnefo
|
|
| 98 |
|
|
| 99 | 99 |
* Install the software components you wish to work on inside the |
| 100 | 100 |
virtualenv, in development mode: |
| 101 | 101 |
|
| 102 |
.. code-block:: console |
|
| 103 |
|
|
| 104 |
(synnefo-env)$ cd snf-asterias-app |
|
| 105 |
(synnefo-env)$ python setup.py develop -N |
|
| 106 |
|
|
| 107 |
* Initialize database:: |
|
| 108 |
|
|
| 109 |
(synnefo-env)$ snf-manage syndb |
|
| 110 |
(synnefo-env)$ snf-manage migrate |
|
| 111 |
(synnefo-env)$ snf-manage loaddata users flavors images |
|
| 102 |
.. code-block:: console |
|
| 103 |
|
|
| 104 |
(synnefo-env)$ cd snf-asterias-app |
|
| 105 |
(synnefo-env)$ python setup.py develop -N |
|
| 106 |
|
|
| 107 |
* Initialize database: |
|
| 112 | 108 |
|
| 109 |
.. code-block:: console |
|
| 110 |
|
|
| 111 |
(synnefo-env)$ snf-manage syndb |
|
| 112 |
(synnefo-env)$ snf-manage migrate |
|
| 113 |
(synnefo-env)$ snf-manage loaddata users flavors images |
|
| 114 |
|
|
| 113 | 115 |
Development tips |
| 114 | 116 |
**************** |
| 115 | 117 |
|
| ... | ... | |
| 141 | 143 |
South Database Migrations |
| 142 | 144 |
------------------------- |
| 143 | 145 |
|
| 144 |
.. _snf-asterias-dev-initialmigration:
|
|
| 146 |
.. _asterias-dev-initialmigration: |
|
| 145 | 147 |
|
| 146 | 148 |
Initial Migration |
| 147 | 149 |
***************** |
| ... | ... | |
| 178 | 180 |
|
| 179 | 181 |
Do not use the syncdb management command. It can only be used the first time |
| 180 | 182 |
and/or if you drop the database and must recreate it from scratch. See |
| 181 |
:ref:`snf-asterias-dev-initialmigration`.
|
|
| 183 |
:ref:`asterias-dev-initialmigration`. |
|
| 182 | 184 |
|
| 183 | 185 |
|
| 184 | 186 |
Every time you make changes to the database and data migration is not required |
| ... | ... | |
| 289 | 291 |
(*) 0003_rename_credit_wallet |
| 290 | 292 |
|
| 291 | 293 |
.. seealso:: |
| 292 |
More information and more thorough examples can be found in the South web site.
|
|
| 294 |
More information and more thorough examples can be found in the South web site,
|
|
| 293 | 295 |
http://south.aeracode.org/ |
| 294 | 296 |
|
| 295 | 297 |
Test coverage |
Also available in: Unified diff