/InnovaCity

Progetto del corso di Ingegneria del Software 2023-2024 @ Università degli Studi di Padova

Primary LanguagePython

InnovaCity

Progetto del corso di Ingegneria del Software 2023-2024 @ Università degli Studi di Padova

Proponente: SyncLab

Proposta: Realizzazione di una architettura software in grado di ingerire, immagazzinare ed analizzare grandi quantità di dati provenienti da device IoT.

Utilizzo

Impostazione variabili d'ambiente

Prima di avviare il progetto, è necessario impostare delle variabili d'ambiente per il corretto funzionamento del progetto. Per farlo, è necessario creare un file .env nella root del progetto con il seguenti contenuto:

ORS_API_KEY=[openrouteservice api key]
DISCORD_WEBHOOK_URL=[discord webhook url]

In alternativa, è possibile impostare le variabili d'ambiente direttamente nel sistema operativo, con i comandi:

export ORS_API_KEY=[openrouteservice api key]
export DISCORD_WEBHOOK_URL=[discord webhook url]

Per l'avvio tramite Docker, dell'intero stack, utilizzare il comando

docker-compose --profile prod up -d

Secondo le necessità si possono aggiungere le flag --force-recreate e --build.

Se si vuole avviare solamente la data pipeline, e lanciare il simulatore in locale (per esempio durante lo sviluppo), è sufficiente utilzzare il comando

docker-compose --profile dev up -d,

aggiungendo anche qui le flag secondo le necessità.

Per fermare tutti i container utilizzare rispettivamente i comandi

docker-compose --profile prod down

docker-compose --profile dev down

Accesso

Le credenziali per l'accesso a Grafana username e password sono rispettivamente ic_admin e ic_admin.

Note

In base alla versione di Docker installata potrebbe essere necessario usare invece il comando docker compose al posto di docker-compose.