1. Maak verbinding met je server
Gebruik SSH om verbinding te maken met je server:
ssh root@<server-ip>
2. Toegang tot inloggegevens
Er is een speciale gebruiker met de naam fastapi gemaakt om uw applicatie te beheren.
In dit bestand vindt u de inloggegevens: /root/.fastapi-creds
Om ze te bekijken, voert u het volgende uit:
cat /root/.fastapi-creds
Als u het wachtwoord wilt wijzigen, gebruikt u:
passwd fastapi
3. Schakel over naar de App-gebruiker
Schakel over naar het fastapi-gebruikersaccount om uw app te beheren:
su - flask
Dit account bevat uw FastAPI-project en -omgeving.
4. Projectstructuur
Dit is de standaard mapindeling:
/home/fastapi/fastapi_app/
├── main.py → Your main FastAPI application file
├── venv/ → Virtual environment
└── __pycache__/ → Compiled Python files (auto-generated)
5. Uw applicatie beheren
Navigeer naar de applicatiemap:
cd ~/fastapi_app
Activeer de virtuele omgeving:
source venv/bin/activate
Bewerk het hoofdapp-bestand:
nano main.py
Start de FastAPI-service opnieuw om wijzigingen toe te passen:
sudo systemctl restart uvicorn-fastapi
6. Logboeken bekijken
Je kunt de logbestanden voor Uvicorn en Nginx als volgt controleren:
- Uvicorn-logboeken:
/var/log/uvicorn/ - Nginx-foutenlogboek:
/var/log/nginx/error.log - Nginx-toegangslogboek:
/var/log/nginx/access.log
Om ze te bekijken:
sudo tail -f /var/log/uvicorn/*
7. Toegang tot uw API
Zodra de service actief is, is uw FastAPI-app beschikbaar in uw browser op: http://<server-ip>
Nginx stuurt HTTP-verzoeken automatisch door naar de Uvicorn-socket waarop uw FastAPI-app draait.
8. Het domein of de poort wijzigen
Als u de servernaam, poort of domein wilt bijwerken:
- Nginx-siteconfiguratie bewerken:
sudo nano /etc/nginx/sites-available/uvicorn-fastapi - Testconfiguratie:
sudo nginx -t - Nginx opnieuw laden:
sudo systemctl restart nginx
9. Uvicorn-service
De FastAPI-app werkt via een systeemservice genaamd uvicorn-fastapi.
Het gebruikt /home/fastapi/fastapi_app/main:app als ingangspunt van de applicatie en wordt automatisch opnieuw opgestart bij een fout.
Om de dienst te beheren:
systemctl status uvicorn-fastapi
systemctl restart uvicorn-fastapi
Om de dienst te 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.
