pds-2021-g2-nest/code/backend

nest_backend

Un server WSGI in Flask che fornisce una web API per interfacciarsi a N.E.S.T.

Requisiti

Per eseguire nest_backend, è necessario avere installato:

• Python ^3.8.5
  • Deve includere anche
• Poetry ^1.0.0
  • Se possibile non seguire le istruzioni disponibili sul sito, ma installarlo dal proprio package manager!
    • {Arch Linux}
• Postgres ^13.2

Installazione

Per installare le dipendenze del backend, è necessario eseguire in questa cartella:

poetry install

Questo creerà un nuovo venv nelle cartelle interne di Poetry e vi installerà all'interno le dipendenze necessarie.

Configurazione

Configurazione del Database

Dopo aver installato Postgres, è necessario creare un database dedicato all'applicazione (ad esempio PdSTest).
Se si desidera, si può anche creare un utente dedicato (l'utente postgres di default va benissimo).
Per configurare l'URI del database che N.E.S.T. andrà a impiegare, è necessario eseguire

export DATABASE_URI=postgresql://[postgresUser]:[postgresPassword]@localhost:[port, default 5432]/[DatabaseName]

Ora il database è pronto per l'uso.

Altre variabili d'ambiente

Questo ultimo passaggio è importante solo in un ambiente non-dev. La configurazione andrà a valore di default nel caso in cui queste variabili non siano definite.
Per terminare la configurazione, eseguire:

export COOKIE_SECRET=[cookiepass]
export JWT_SECRET_KEY=[jwtsecret]
export DISABLE_DEBUG=[farts]

Queste due variabili d'ambiente conterranno le chiavi con cui i cookie e le key di autorizzazione JWT saranno cifrate.

Avvio

Per avviare il backend, è innanzitutto necessario attivare il venv contenente le dipendenze con il seguente comando:

poetry shell

In seguito, è possibile avviare il backend con:

python -m nest_backend

Nota: eseguire questo programma in modalità ottimizzata (python -OO -m nest_backend) disattiverà completamente le funzionalità di documentazione automatica, pertanto è fortemente sconsigliato.

Sviluppo

Le pagine web del server sono disponibili a http://127.0.0.1:5000 .

Mentre il development server è avviato, buona parte delle modifiche saranno rilevate e applicate automaticamente senza dover riavviare il server. Per testare la connettività, visitare http://127.0.0.1:5000/doa.

Documentazione

Mentre il server è avviato, la documentazione sarà disponibile a http://127.0.0.1:5000/docs/ .

Deployment

Per effettuare il deployment in production, seguire la guida ufficiale di Flask.

Nota: un bug attualmente impedisce a questo programma di essere installato su percorsi diversi da /. Usare sottodomini e virtualhosts se è necessario avere più servizi web in esecuzione sullo stesso server!