'Jorvik' is the codename for the second and latest version of the Gaia Project, used by Italian Red Cross. ISSUES: https://jira.gaia.cri.it/browse/JO
Jorvik è il nome in codice del progetto di ridisegno del software del Progetto Gaia Croce Rossa Italiana (GitHub, Web).
I punti chiave nella riprogettazione sono i seguenti:
Le segnalazioni sono state spostate da GitHub al nuovo sistema di tracciamento issues utilizzato dal Progetto Gaia (JIRA). Vedi l'articolo "Segnalazioni tecniche" sul wiki per maggiori informazioni sul come utilizzarlo.
Sei interessato a partecipare allo sviluppo di Gaia/Jorvik? Contattaci all'indirizzo e-mail [email protected]!
Jorvik viene installato e testato sulle recenti versioni di Python 3, in modo automatico, da Travis CI ad ogni push.
*: Il deployment non viene ancora effettuato automaticamente.
Gli ambienti di staging e test sono orchestrati automaticamente da Wonderbot, e sono accessibili al seguente indirizzo:
Alcune note:
Puoi trovare la Documentazione sul Wiki del progetto.
Per lo sviluppo di Jorvik, potrai utilizzare i container già pronti che ti permetteranno di lavorare su Gaia senza la necessità di configurare manualmente un sistema di produzione.
Se vuoi configurare manualmente un sistema di produzione, puoi installare manualmente i requisiti necessari. A meno che tu abbia intenzione di mettere online un fork di Gaia su di un ambiente di produzione, questo è un metodo sconsigliato.
python3
)pip3
)
Per la configurazione automatica dell'ambiente di sviluppo su Linux, Mac OS X 10.9+ e Windows 10, è possibile usare Docker CE con Docker Compose. Docker Compose gestisce la creazione e la configurazione automatica (orchestration) di una insieme di container Docker.
$ git clone --recursive https://github.com/CroceRossaItaliana/jorvik
$ cd jorvik
web
come da immagine, e cliccare OK. (Vedi immagine)[jorvik] installa dati di esempio
** su PyCharm e premendo il taso "Run" (Vedi immagine).
[email protected]
42
[jorvik] runserver
(Vedi immagine). Questo avvierà tutti i servizi necessari, utilizzando Docker Compose:
web
: Un server di sviluppo Django (runserver
), che rileverà automaticamente le modifiche al codice e si riavvierà automaticamente;db
: Un server di database PostgreSQL;broker
, celery
: Un broker (Redis) e un server per lo smistamento della coda di task (ad es., task di smistamento della posta);pdf
: Un server per la generazione dei file PDF (Apache, PHP con DOMPDF);selenium
: Un server Selenium con Firefox e un server VNC, per l'esecuzione dei test funzionali.[jorvik] runcrons
.[jorvik] test
(Vedi imagine).PostgreSQL
,localhost
come host e 5432
come porta,postgres
come username, senza alcuna password.remmina
.localhost
come host, e porta 5900
.secret
come password.Se non utilizzi PyCharm, puoi utilizzare direttamente docker-compose
da terminale
per orchestrare i container dei vari servizi di Jorvik. Ecco un paio di comandi di
esmepio.
Configurare (primo avvio) e avviare i container di Gaia
$ docker-compose up
Arrestare Gaia
$ docker-compose stop
Cancellare e riconfigurare i container da zero
$ docker-compose stop && docker-compose rm && docker-compose up --build
Eseguire comandi sulla macchina Web (Django)
# Shell di Django
$ docker-compose exec web python manage.py shell
# Bash
$ docker-compose exec web bash
Attualmente la piattaforma supporta la 2FA con:
Per l'utilizzo di Yubikey, vedi la documentazione del modulo al seguente indirizzo: http://django-two-factor-auth.readthedocs.io/en/stable/installation.html#yubikey-setup
/admin
)