1. Verbind met je server
Gebruik SSH om verbinding te maken met je server:
ssh root@<server-ip>
2. Inloggegevens ophalen
Er is een speciale gebruiker aangemaakt met de naam fastapi om je applicatie te beheren.
De inloggegevens vind je in dit bestand: /root/.fastapi-creds
Voer het volgende uit om ze te bekijken:
cat /root/.fastapi-creds
Gebruik het volgende om het wachtwoord te wijzigen:
passwd fastapi
3. Schakel Over naar de App-gebruiker
Schakel over naar het fastapi-gebruikersaccount om je app te beheren:
su - flask
Dit account bevat je FastAPI-project en de bijbehorende omgeving.
4. Projectstructuur
Dit is de standaard mappenstructuur:
/home/fastapi/fastapi_app/
├── main.py → Your main FastAPI application file
├── venv/ → Virtual environment
└── __pycache__/ → Compiled Python files (auto-generated)
5. Je applicatie beheren
Ga naar de applicatiemap:
cd ~/fastapi_app
Activeer de virtuele omgeving:
source venv/bin/activate
Bewerk het hoofdbestand van de app:
nano main.py
Herstart de FastAPI-service om de wijzigingen door te voeren:
sudo systemctl restart uvicorn-fastapi
6. Logbestanden weergeven
Zo bekijk je de logs van Uvicorn en Nginx:
- Uvicorn-logboeken:
/var/log/uvicorn/ - Nginx-foutenlog:
/var/log/nginx/error.log - Nginx-toegangslog:
/var/log/nginx/access.log
Om ze te bekijken:
sudo tail -f /var/log/uvicorn/*
7. Je API openen
Zodra de service actief is, is je FastAPI-app beschikbaar in je browser op: http://<server-ip>
Nginx stuurt HTTP-verzoeken automatisch door naar de Uvicorn-socket waarop je FastAPI-app draait.
8. Het domein of de poort wijzigen
Als je de servernaam, poort of het domein wilt aanpassen:
- Bewerk de Nginx-siteconfiguratie:
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - Testconfiguratie:
sudo nginx -t - Nginx herladen:
sudo systemctl restart nginx
9. Uvicorn Service
De FastAPI-app draait via een systemd-service met de naam uvicorn-fastapi.
Het gebruikt /home/fastapi/fastapi_app/main:app als startpunt van de applicatie, en wordt automatisch herstart bij een storing.
De service beheren:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
De service bewerken:
sudo vim /etc/systemd/system/uvicorn-fastapi.service
sudo systemctl daemon-reload
sudo systemctl restart uvicorn-fastapi
sudo systemctl status uvicorn-fastapi
10. HTTPS inschakelen (optioneel)
Gebruik Certbot om HTTPS in te schakelen.
