Django-hosting » History » Version 13
Nico Schottelius, 04/08/2016 11:51 AM
1 | 1 | Nico Schottelius | h1. django-hosting.ch by ungleich |
---|---|---|---|
2 | |||
3 | 9 | Nico Schottelius | {{toc}} |
4 | |||
5 | 1 | Nico Schottelius | h2. How to use |
6 | |||
7 | 8 | Nico Schottelius | # Configure your app |
8 | # Deploy your app |
||
9 | 11 | Nico Schottelius | # Install python requirements into the pyvenv |
10 | 8 | Nico Schottelius | # Restart uwsgi to restart your app |
11 | # Go to http://your-hostname/ and enjoy! |
||
12 | 1 | Nico Schottelius | |
13 | |||
14 | 8 | Nico Schottelius | h2. Configure your app |
15 | |||
16 | h3. WSGI |
||
17 | |||
18 | * Ensure that there is _projectname_/wsgi.py in your project root |
||
19 | |||
20 | h3. Database |
||
21 | |||
22 | Add the following to your settings.py: |
||
23 | |||
24 | <pre> |
||
25 | DATABASES = { |
||
26 | 'default': { |
||
27 | 'ENGINE': 'django.db.backends.postgresql_psycopg2', |
||
28 | 'NAME': 'app', |
||
29 | } |
||
30 | } |
||
31 | </pre> |
||
32 | 4 | Nico Schottelius | |
33 | |||
34 | 10 | Nico Schottelius | h2. Deploy |
35 | 1 | Nico Schottelius | |
36 | 10 | Nico Schottelius | You can login to your VM as user *app* (for the django app) and *root* (in case you need to change settings): |
37 | 1 | Nico Schottelius | |
38 | 10 | Nico Schottelius | <pre> |
39 | ssh app@MYHOSTNAME |
||
40 | </pre> |
||
41 | 4 | Nico Schottelius | |
42 | 1 | Nico Schottelius | |
43 | 10 | Nico Schottelius | * Deploy / update your app into the folder *~app/app* (that is the app folder in the home of the user app) |
44 | 1 | Nico Schottelius | * We recommended to use git to deploy it |
45 | 11 | Nico Schottelius | |
46 | h2. Install python requirements into the pyvenv |
||
47 | |||
48 | 13 | Nico Schottelius | Pyvenv has been installed to *~app/pyvenv* for you. |
49 | Required packages for the hosting like PostgreSQL support and uwsgi support have already been placed. |
||
50 | |||
51 | You need to use pyvenv found in *~app/pyvenv*, as uwsgi loads this pyvenv before loading your app. |
||
52 | |||
53 | To install your requirements use: |
||
54 | 11 | Nico Schottelius | |
55 | <pre> |
||
56 | . ~/pyvenv/bin/activate |
||
57 | pip install ... |
||
58 | </pre> |
||
59 | 10 | Nico Schottelius | |
60 | h2. Restarting the app |
||
61 | 2 | Nico Schottelius | |
62 | * *sudo systemctl restart uwsgi* |
||
63 | |||
64 | |||
65 | 1 | Nico Schottelius | h3. Viewing logfiles |
66 | 4 | Nico Schottelius | |
67 | * nginx access log: *tail -F /var/log/nginx/access.log* |
||
68 | 7 | Nico Schottelius | * nginx error log: *tail -F /var/log/nginx/error.log* |
69 | 6 | Nico Schottelius | * uwsgi log: *tail -F /var/log/uwsgi/app/app.log* |
70 | 4 | Nico Schottelius | |
71 | 1 | Nico Schottelius | |
72 | |||
73 | |||
74 | h2. Description of the stack |
||
75 | |||
76 | h3. Technologies |
||
77 | |||
78 | * Debian 8 |
||
79 | * nginx |
||
80 | * PostgreSQL |
||
81 | 3 | Nico Schottelius | * uwsgi |
82 | |||
83 | h3. Configuration |
||
84 | |||
85 | * user "app" |
||
86 | ** in group "adm" (to view logfiles) |
||
87 | * PostgreSQL with |
||
88 | 1 | Nico Schottelius | ** database "app" |
89 | 3 | Nico Schottelius | ** Listens only on localhost / socket (no remote connections) |
90 | 12 | Nico Schottelius | ** |