Lavagna

by LeonardoAlgeri

GitHub Readme.md

Lavagna

Una semplice lavagna su cui poter scrivere.
Frontend: https://gitlab.com/Leonardoalgeri/lavagnafrontend
Backend: https://github.com/LeonardoAlgeri/Lavagna
DockerHub: https://hub.docker.com/r/leonardoalgeri/lavagna

API

Il backend mette a disposizione le seguenti chiamate:

  • /all Restituisce tutti gli elementi scritti sulla lavagna
  • /add Aggiunge un messaggio alla lavagna (tramite una richiesta POST)
  • /reset Resetta la lavagna (API temporanea da migliorare)

Deploy

In fase di deploy è necessario fornire all'applicativo le seguenti varibili d'ambiente:

  • Per il database mysql
    • SQL_URL il link dell'host sql seguito da porta e nome del database. Ad esempio host:port/mydatabase
    • SQL_USER l'utente del database sql
    • SQL_PASSWORD la password del database sql
  • Generiche
    • PASS_RESET la password da utilizzare con l'api /reset

Heroku

Solo un semplice click

Deploy

Una volta che l'applicazione è stata deployata correttamente settare le variabili d'ambiente qui sopra citate nella sezione Settings->Config Vars dell'applicazione heroku. Non è necessario riavviare l'applicazione

Docker

È possibile eseguire il seguente programma su docker seguendo questi passi:

  1. Settare un file env.list contentente il valore delle variabili d'ambiente. Trovate un esempio qui cercando env
  2. Eseguire le seguenti istruzioni
docker run --env-file env.list -dp 8080:8080 --name lavagna --restart always leonardoalgeri/lavagna
  1. Attendere qualche minuto per l'avvio di spring

Per fermare il container è sufficiente la seguente operazione

docker stop lavagna

Update dell'applicazione

In entrambi i casi l'update va fatto a mano.
Per quanto riguarda heroku basta eliminare l'applicazione e deployarla di nuovo Deploy

Per quanto riguarda docker eseguire le seguenti istruzioni

docker stop lavagna
docker rm lavagna
docker pull leonardoalgeri/lavagna

Ed eseguire poi di nuovo il container

docker run --env-file env.list -dp 8080:8080 --name lavagna --restart always leonardoalgeri/lavagna

Warning

In caso di problemi con la visualizzazione di emoji sulla lavagna controllare che la codifica del database sia utf8mb4_0900_ai_ci