Revision 55faeced docs/dev-guide.rst
b/docs/dev-guide.rst | ||
---|---|---|
10 | 10 |
|
11 | 11 |
First of all you have to set up a developing environment for Synnefo. |
12 | 12 |
|
13 |
**1. Create a new Squeeze VM** |
|
13 |
**1. Create a new VM** |
|
14 |
|
|
15 |
It has been tested on Debian Wheezy. It is expected to work with other |
|
16 |
releases (e.g., Squeeze) too, as long as they are supported by |
|
17 |
``snf-deploy``. |
|
14 | 18 |
|
15 | 19 |
**2. Build your own Synnefo installation** |
16 | 20 |
|
... | ... | |
44 | 48 |
|
45 | 49 |
.. code-block:: console |
46 | 50 |
|
51 |
# su some_regular_user |
|
47 | 52 |
$ git clone https://code.grnet.gr/git/synnefo |
48 | 53 |
|
49 |
Make sure you did the previous as a regular user. Otherwise you will have problems
|
|
50 |
with file permissions when deploying. |
|
54 |
Make sure you clone the repository as a regular user. Otherwise you will
|
|
55 |
have problems with file permissions when deploying.
|
|
51 | 56 |
|
52 | 57 |
**6. Code and deploy** |
53 | 58 |
|
... | ... | |
58 | 63 |
$ devflow-update-version |
59 | 64 |
|
60 | 65 |
2. Code |
61 |
3. In every component you change run |
|
66 |
3. In every component you change, run as root |
|
67 |
|
|
68 |
.. code-block:: console |
|
69 |
|
|
70 |
# python setup.py develop -N |
|
71 |
|
|
72 |
This does not automatically install dependencies, in order to avoid |
|
73 |
confusion with synnefo packages installed by ``snf-deploy``. External |
|
74 |
dependencies have already been installed by ``snf-deploy``; if you introduce |
|
75 |
a new dependency, you will have to explicitly install it. |
|
76 |
|
|
77 |
4. You will need to restart the server with |
|
78 |
|
|
79 |
.. code-block:: console |
|
80 |
|
|
81 |
# service gunicorn restart |
|
82 |
|
|
83 |
5. If your changes affected ``snf-dispatcher`` (from package |
|
84 |
``snf-cyclades-app``) or ``snf-ganeti-eventd`` (from |
|
85 |
``snf-cyclades-gtools``) you will need to restart these daemons, too. |
|
86 |
Since step 3 installed the former under ``/usr/local/``, you need to |
|
87 |
make sure that the correct version is evoked. You can override the |
|
88 |
version installed by ``snf-deploy`` with |
|
89 |
|
|
90 |
.. code-block:: console |
|
91 |
|
|
92 |
# ln -sf /usr/local/bin/snf-dispatcher /usr/bin/snf-dispatcher |
|
93 |
|
|
94 |
and then restart the daemons |
|
62 | 95 |
|
63 | 96 |
.. code-block:: console |
64 | 97 |
|
65 |
# python setup.py develop |
|
98 |
# service snf-dispatcher restart |
|
99 |
# service snf-ganeti-eventd restart |
|
66 | 100 |
|
67 |
4. Refresh the web page and see your changes
|
|
101 |
6. Refresh the web page and see your changes
|
|
68 | 102 |
|
69 | 103 |
Synnefo REST APIs |
70 | 104 |
================= |
Also available in: Unified diff