Brevi istruzioni per lanciare l'applicazione. Prerequisiti: Java 17, Maven, Ionic CLI
A causa di alcune limitazioni all'uso di localhost con spring-authorization-server
è necessario evitare l'utilizzo di localhost come hostname per il client
e l'authorization server. Per questo, ho aggiunto la seguente configurazione
nel file /etc/hosts
127.0.0.1 unicam-turns-app
127.0.0.1 unicam-turns-authorization-server
127.0.0.1 unicam-turns-backend
(questo funziona in Linux, non ho idea se e come fare in altri OS)
Per lanciare quindi il tutto:
cd unicam-turns-authorization-server
mvn spring-boot:run &
cd ../unicam-turns-backend
mvn spring-boot:run &
cd ../unicam-turns-app
ionic serve --host=unicam-turns-app
Per stopparla, dopo aver premuto CTRL+C per stoppare il server ionic, non dimenticare i backend
che erano stati lasciati in background (vedi la &), quindi ad esempio:
$ jobs
[1]+ Running JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 mvn spring-boot:run &
$ kill %1
... Shutdown completed.
Dopo #10 bisogna fare le configurazioni opportune (vedi #10) e lanciare la app aggiungendo l'opzione --ssl:
ionic serve --ssl --host=unicam-turns-app
Modalità per lanciare l'applicazione in ambiente Docker, che si presuppone installato nel proprio PC. In questa semplice configurazione avremo due container, uno per il DBMS e uno per il backend della nostra applicazione. Compiliamo anzitutto l'immagine Docker del nostro backend:
cd unicam-turns-backend
docker build -t unicam/unicam-turns-backend .
Quindi prepariamo un file di configurazione application.yml con il seguente contenuto:
spring:
datasource:
url: jdbc:postgresql://postgres:5432/postgres
username: postgres
password: changeme
E mettiamolo in una cartella di nostra scelta, io ad esempio l'ho messo in /home/giulio/var/docker/volumes/unicam/turns/unicam-turns-backend/config.
Ora occorre creare una rete Docker con cui far comunicare privatamente i container (se si ha già una rete e si vuole usare questa si può saltare questo step); io ne creerò una chiamata unicam-turns:
docker network create unicam-turns
A questo punto lanciamo il container del DBMS:
docker run --name unicam-turns-postgres -e POSTGRES_PASSWORD=changeme --network unicam-turns --network-alias postgres -d postgres
e il container del nostro backend:
docker run -p 8080:8080 --network unicam-turns -v /home/giulio/var/docker/volumes/unicam/turns/unicam-turns-backend/config:/config unicam/unicam-turns-backend
A questo punto, se tutto è andato a buon fine, aprendo il browser all'indirizzo http://localhost:8080/ si dovrebbe vedere un JSON con alcune informazioni. Per lanciare la app, si può procedere come nel "Development mode", ovvero:
cd ../unicam-turns-app
ionic serve