Project

General

Profile

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
**