Python applicatie draaien op je hostingpakket
Bij ieder pakket bij CloudNode heb je de mogelijkheid om een Python-applicatie te laten draaien. Voordat je applicatie
kunt deployen zal je een aantal stappen moeten doorlopen, welke stappen dat zijn dat leggen we je in dit
kennisbankartikel uit.
Wat is belangrijk om te weten?
- Voer deze stappen alleen uit als er geen belangrijke websites op je hosting draaien. Door het volgen van dit
kennisbankartikel ga je direct een Python applicatie in productie opleveren waardoor er een kans is dat je de
huidige website beschadigt.
- Het is aan te raden om eerst een staging of dev omgeving aan te maken en niet meteen in productie te gaan.
- Wacht nog met het invoeren van gevoelige data in de testapplicatie totdat je weet hoe de beveiliging van Django
werkt.
De applicatie aanmaken
Ga naar DirectAdmin.
Zodra je bent ingelogd op DirectAdmin, zoek je links in de balk Extra Kenmerken en dan Setup Python App.
Klik vervolgens op Create Application om je applicatie te maken.
applicatie aanmaken
Je komt nu in het volgende scherm:
instellingen applicatie
Hier zijn een aantal belangrijke velden die je moet invullen:
Python version: De versie van Python waar je mee werkt. Het is aan te raden om versie 3.9 of 3.10 te gebruiken.
Application root: Dit is de map waarin je de applicatie in maakt, je kan het zien als de public_html map in web
development termen. Let op dat je geen submap installeert om problemen met de pip installer te voorkomen.
Application URL: De standaard URL van je applicatie, je kan bijvoorbeeld je-domein.nl/applicatie of leeg laten voor
alleen je-domein.nl.
Application startup file: Dit is de map waar je applicatie wordt opgehaald door de server. Je kan het leeg laten bij de
eerste keer opstarten.
Application entry point: Dit is de plek waar je linkt naar je wsgi.py bestand, deze kan je ook leeg laten zodat de
default waarde wordt ingevuld.
Aan de slag met je nieuwe Python applicatie.
Zodra je de python applicatie hebt aangemaakt kom je in het volgende scherm:
applicatie aangemaakt
Anders dan bij webdevelopment komt de inhoud van je project niet in de public_html map maar in de kennisbank-demo map
zoals we die net hebben opgegeven.
Wat is virtualenv?
Bij CloudNode werk je met een virtualenv (virtual enviroment). Een virtuele "root" omgeving op je eigen hosting pakket.
Zo kan je al je pip-pakketten en python versies gescheiden houden mocht je meerdere applicaties willen runnen.
Kortgezegd zorgt het ervoor dat de software en modules niet met elkaar conflicten maar netjes bij de applicatie blijven
waar ze horen.
Virtualenv kan je activeren door de volgende commands via SSH hebt ingevoerd:
let op, onderstaande is een voorbeeld. Je eigen source pad vind je in de app en kan je gewoon kopieren om het in je ssh
sessie te gebruiken.
Zie afbeelding waar je je source link vind in je app:
Wij gebruiken nu:
source /home/jegebruikersnaam/virtualenv/kennisbankdemo/3.7/bin/activate && cd /home/jegebruikersnaam/kennisbankdemo
Let op dat dit command verschilt per installatie, de code hierboven is puur ter illustratie.
Weet je niet hoe je moet inloggen op SSH? Dan is het het makkelijkste om gebruik te maken van de online Terminal
omgeving in Directadmin.
Wat is Django en hoe installeer je het?
Om toch een beetje in de webdevelopment sferen te blijven is dit kennsibankartikel gericht op het maken van een
webapplicatie. Een van de bekende keuzes die je kan maken is dan de Django library. Django kan je via SSH installeren op
je applcatie:
pip install --upgrade pip
pip install django "mysqlclient<2.0.2"
Daarna kan je het Django project aanmaken met het volgende command, let op dat je ook de . meeneemt op het einde:
django-admin startproject begin .
Het config bestand aanpassen naar wens
In je configuratie bestand kan je zaken zoals je database credentials aangeven. Dit kan je aanpassen in het settings.py
bestand, dit bestand wordt pas actief zodra je de Python applicatie herstart. De applicatie kan je herstarten in het
admin panel van je Python applicatie:
applicatie herstarten
Nadat je de Python applicatie hebt herstart kan je je eigen domein toevoegen aan de ALLOWED_HOSTS zodat django deze ook
herkent. Vervolgens voeg je de STATIC_ROOT toe, je laat zo aan django weten waar de statische bestanden uit je
applicatie moeten worden opgeslagen. Deze wijzigingen dien je te doen in de settings.py:
ALLOWED_HOSTS = ['jouw-domein.nl']
DEBUG = False
STATIC_ROOT = '/home/jegebruikersnaam/domains/jouw-domein.nl/public_html/static'
In hetzelfde bestand geef je ook aan waar Django naartoe kan loggen:
LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'handlers': {
'file': {
'level': 'INFO',
'class': 'logging.FileHandler',
'filename': '/home/jouw-gebruikersnaam/project-naam/django.log',
},
},
'loggers': {
'django': {
'handlers': ['file'],
'level': 'INFO',
'propagate': True,
},
},
}
Let op dat je het bestand django.log wel eerst aanmaakt, dit kan je doen in de command line met het volgende command:
touch django.log
Daarna geef je aan welke database er gebruikt wordt:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'database_naam ',
'USER': 'database_gebruiker ',
'PASSWORD': 'database_wachtwoord',
'HOST': 'localhost',
'PORT': '3306',
}
}
Starten met de eerste testpagina
Nu de instellingen zijn doorgenomen is het tijd om te testen of de applicatie werkt. Dit doen we door middel van een
hello-world pagina. Start de app als volgt:
python manage.py startapp start
Hierdoor maak je de map ‘start’ aan. In deze map kan je de view aanpassen voor je testpagina. Vervang de inhoud van het
volgende code snippet in start/views.py:
from django.http import HttpResponse
def index(request):
return HttpResponse("Hallo CloudNode kennisbank, de testpagina werkt!")
Met het volgende code snippet kan je ervoor zorgen dat ‘start’ kan worden ingeladen in de hoofdapplicatie
(demo/urls.py):
from django.contrib import admin
from django.urls import path
from start.views import index
urlpatterns = [
path('', index),
path('admin/', admin.site.urls),
]
Als laatste stap voeg je in de settings.py de wijzigingen in de lijst van INSTALLED_APPS, hier zet je de string* ‘start’
in.
*Een string is een datatype die alleen letters bevat.
De laatste stappen om live te gaan
De code voor de testpagina is nu compleet en je kan bijna live gaan met je test applicatie. Er zijn nog een aantal zaken
die goed zijn om uit te voeren. Een van die dingen is de virtualenv die eerder in dit kennisbank artikel is besproken.
Gebruik het command om je virtualenv te activeren (zie ook het kopje wat is virtualenv?).
Daarna kan je het manage.py bestand gebruiken om je applicatie klaar te maken voor gebruik:
python manage.py collectstatic
python manage.py migrate
python manage.py createsuperuser
Net zoals bij bijvoorbeeld Wordpress beschikt Django ook over een admin gedeelte:
- Collectstatic: Hiermee zet je de CSS en JavaScript bestanden in de public_html map.
- Migrate: Is de eerste database structuur die de Django admin nodig heeft.
- Createsuperuser: Dit is het account met de meeste rechten ofwel het beheer account genoemd.
De applicatie activeren
Dan is het nu toch eindelijk tijd om de applicatie te activeren, je hoeft python alleen nog te laten weten waar je de
applicatie kan inladen. Ga naar het admin panel in python en wijzig het passenger_wsgi.py naar demo.py. Sla de
wijzigingen op en klik op restart om de wijzigingen door te voeren.
Zoals je kan zien is het gelukt om onze testpagina te laten zien:
test pagina online
Een werkende admin gedeelte:
admin pagina
Bekende foutcodes
403 Forbidden: Check of de applicatie actief is en of de juiste wsgi.py staat ingesteld.
404 Not found: Dit betekend dat een bestand of bestanden niet gevonden kunnen worden waardoor de applicatie niet kan
laden. Check de instellingen nogmaals die je in het python admin gedeelte hebt opgegeven.
500 Internal Server Error: Kijk in het Django log voor meer informatie.
Can’t acquire lock for app:
Geen styling: Het kan gebeuren dat de Django admin gedeelte er niet uit ziet zoals het hoort. Check of de static map in
de public_html map gevuld is met bestanden. Mocht dit niet het geval zijn, check dan de STATIC_ROOT instelling en of de
STATIC_URL verwijst naar de juiste static map en gebruik het volgende command:
python manage.py collectstatic
