mirror of
https://github.com/pds-nest/nest.git
synced 2024-11-29 07:54:19 +00:00
🗒 Add backend README
This commit is contained in:
parent
b912e78d37
commit
59d6f51dc7
2 changed files with 50 additions and 2 deletions
|
@ -1,10 +1,58 @@
|
||||||
# `nest_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](https://www.python.org/downloads/)
|
||||||
|
- Deve includere anche
|
||||||
|
- [Poetry ^1.0.0](https://python-poetry.org/docs/)
|
||||||
|
- Se possibile non seguire le istruzioni disponibili sul sito, ma installarlo dal proprio package manager!
|
||||||
|
- [{Arch Linux}](https://archlinux.org/packages/community/any/python-poetry/)
|
||||||
|
|
||||||
## Installazione
|
## Installazione
|
||||||
|
|
||||||
|
Per installare le dipendenze del backend, è necessario eseguire in questa cartella:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
poetry install
|
||||||
|
```
|
||||||
|
|
||||||
|
Questo creerà un nuovo venv nelle cartelle interne di Poetry e vi installerà all'interno le dipendenze necessarie.
|
||||||
|
|
||||||
## Configurazione
|
## Configurazione
|
||||||
`export COOKIE_SECRET=hippityhoppity`
|
|
||||||
|
Perchè il backend gestisca correttamente i cookie <!-- TODO: ma noi non usiamo cookies...? -->, è necessario che la
|
||||||
|
seguente variabile di ambiente sia settata a una stringa casuale:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export COOKIE_SECRET=hippityhoppity
|
||||||
|
```
|
||||||
|
|
||||||
|
## Avvio
|
||||||
|
|
||||||
|
Per avviare il backend, è innanzitutto necessario attivare il venv contenente le dipendenze con il seguente comando:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
poetry shell
|
||||||
|
```
|
||||||
|
|
||||||
|
In seguito, è possibile avviare il backend con:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python -m nest_backend
|
||||||
|
```
|
||||||
|
|
||||||
## Sviluppo
|
## 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.
|
||||||
|
|
||||||
## Deployment
|
## Deployment
|
||||||
|
|
||||||
|
Per effettuare il deployment in production,
|
||||||
|
seguire [la guida ufficiale di Flask](https://flask.palletsprojects.com/en/1.1.x/deploying/).
|
||||||
|
|
|
@ -34,7 +34,7 @@ Questo avvierà un webserver su `localhost` legato alla porta TCP `3000`.
|
||||||
## Sviluppo
|
## Sviluppo
|
||||||
|
|
||||||
Mentre il development server è avviato, qualsiasi modifica verrà immediatamente applicata sulla
|
Mentre il development server è avviato, qualsiasi modifica verrà immediatamente applicata sulla
|
||||||
[pagina web di anteprima](https://localhost:3000).
|
pagina web di anteprima a http://localhost:3000 .
|
||||||
|
|
||||||
## Documentazione
|
## Documentazione
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue