Scaricare prima di tutto l'ultima versione stabile di Arches (6.1.0):
https://github.com/archesproject/arches/archive/refs/tags/6.1.0.zip
quindi estrarre il contenuto dell'archivio in una cartella (di default, l'archivio verrà estratto in ./arches-6.1.0).
Per le attività di sviluppo in locale, si consiglia di seguire la procedura descritta sotto.
Creare dapprima un fork del progetto CNR-DHILab/dataspace dal proprio account GitHub, quindi clonare il fork all'interno della cartella principale di Arches:
cd ./arches-6.1.0
git clone https://github.com/<user_github>/dataspace.git
sostituendo <user_github> con il proprio nome utente.
Il progetto dataspace sarà quindi tracciato da Git e il fork su GitHub sarà associato al repository locale come origine remota di default verso le quale fare i push.
Si può scegliere di lavorare sulla branch principale - main - oppure creare una branch di sviluppo; in entrambi i casi, per far sì che le modifiche siano integrate con il repository originario (CNR-DHILab/dataspace), sarà necessario fare il push verso il proprio fork e aprire una pull request.
Una volta impostato l'ambiente di sviluppo, creare un ambiente virtuale con python nella root di Arches (arches-6.1.0):
python -m venv ENV
e attivarlo con il comando (Windows):
ENV\Scripts\activate.bat
In ambiente Unix/Linux, usare il comando source ENV/bin/activate.
Procedere quindi all'installazione di Arches con pip:
pip install arches
Avviare quindi Elasticsearch (Windows):
path/to/elasticsearch.bat
In ambiente Unix/Linux:
/path/to/elasticsearch/bin/elasticsearch -d
L'opzione -d permette di avviare Elasticsearch come servizio (demone).
Per configurare correttamente l'installazione locale, rinominare dapprima i file di configurazione come segue:
dataspace/template_settings.py -> dataspace/settings.py
dataspace/template_settings_local.py -> dataspace/settings_local.py
Modificare quindi i file di configurazione inserendo le credenziali per accedere al database PostgreSQL e gli altri parametri necessari.
Installare infine il database di Arches posizionandosi nella sottocartella dataspace:
cd dataspace
python manage.py setup_db
e avviare il server di sviluppo:
python manage.py runserver
La piattaforma dovrebbe essere raggiungibile in localhost sulla porta 8000 di default:
localhost:8000
- Python
- PostgreSQL e PostGIS
- Elasticsearch 7x
- GDAL (OSGeo)
- Non hai bisogno di QGIS o GRASS
- Node.js