Differenze tra le versioni di "OpenStreetMap/Podoma"

Da Wikimedia Italia.
Jump to navigation Jump to search
 
(12 versioni intermedie di 2 utenti non mostrate)
Riga 1: Riga 1:
Software realizzato dai volontari OpenStreetMap francesi per tracciare i progressi del loro progetto del mese OSM, potrebbe tornare utile anche per il [https://wiki.openstreetmap.org/wiki/IT:Italia/Progetto_del_Mese progetto del mese italiano]:
+
Software realizzato dai volontari OpenStreetMap francesi per tracciare i progressi del loro progetto del mese OSM, usato anche dagli italiani per tracciare i progressi del [https://wiki.openstreetmap.org/wiki/IT:Italia/Progetto_del_Mese progetto del mese italiano]:
  
 
== Link utili ==
 
== Link utili ==
 
* [https://wiki.openstreetmap.org/wiki/Podoma Pagina wiki]
 
* [https://wiki.openstreetmap.org/wiki/Podoma Pagina wiki]
* [https://github.com/osm-fr/podoma Repository GitHub]
+
* [https://github.com/osm-fr/podoma Repository GitHub] (originale)
 +
* [https://gitlab.wikimedia.org/repos/wikimedia-it/osmit-podoma Repository Wikimedia GitLab] (contiene la configurazione del sito italiano nel branch italia)
 
* [https://community.openstreetmap.org/t/podoma-helps-you-contribute-and-monitor-topics-that-matters/141323 Thread di introduzione su OSM Community] (2026-02-07)
 
* [https://community.openstreetmap.org/t/podoma-helps-you-contribute-and-monitor-topics-that-matters/141323 Thread di introduzione su OSM Community] (2026-02-07)
 
* [https://t.me/c/1124175268/124140 Prima discussione della comunità italiana] (2025-11-23)
 
* [https://t.me/c/1124175268/124140 Prima discussione della comunità italiana] (2025-11-23)
Riga 12: Riga 13:
 
== Istanza italiana ==
 
== Istanza italiana ==
  
Setup in corso (deploy completato, necessario configurare i progetti).
+
Accessibile su https://osmit-podoma.wmcloud.org . [https://community.openstreetmap.org/t/dashboard-podoma-per-il-progetto-del-mese/141779/2 Qui l'annuncio] su OSM Community.
  
Accessibile su https://osmit-podoma.wmcloud.org .
+
Deployato in WMF Cloud VPS, progetto <code>osmit</code> ([[Server#Altri_server_in_Wikimedia_Cloud]]), VPS <code>osmit-podoma</code> ([https://openstack-browser.toolforge.org/server/osmit-podoma.osmit.eqiad1.wikimedia.cloud OpenStack browser], [https://horizon.wikimedia.org/project/instances/d659580d-0f8e-42fd-acb5-c9ed65936ce6/ Horizon]).
 +
All'interno del VPS i componenti del sito sono deployati con Docker Compose da <code>/home/dsantini/podoma/docker-compose.yml</code>, è possibile controllare i servizi con <code>sudo docker ps</code>:
 +
 
 +
{| class="wikitable"
 +
! Container !! Esposto !! Note
 +
|-
 +
| pgsqldb || No || Database del server
 +
|-
 +
| pdm || https://osmit-podoma.wmcloud.org || Sito web vero e proprio
 +
|-
 +
| pdm-tileserv|| https://osmit-podoma-tiles.wmcloud.org || Tile server, necessario per la visualizzazione delle statistiche sulla mappa nel sito
 +
|-
 +
| pgadmin || https://osmit-podoma-pgadmin.wmcloud.org || Permette di esplorare e amministrare il DB. Normalmente spento, per usarlo va acceso con <code>sudo docker compose --profile pgadmin up -d pgadmin</code>
 +
|}
 +
 
 +
Tutti i dati permanenti del sito sono all'interno dei volumi Docker che sono salvati nel volume Cloud VPS <code>osmit-podoma-disk</code>, montato in <code>/mnt/volume</code>.
 +
La dimensione attuale del volume è 75GB, attualmente a regime solo 15 GB sono occupati, ma in fase di inizializzazione/aggiornamento del DB più di 40GB sono occupati quindi fare molta attenzione prima di ridurre la dimensione.
  
Deployato in WMF Cloud VPS, progetto <code>osmit</code> ([[Server#Altri_server_in_Wikimedia_Cloud]]), VPS <code>osmit-podoma</code> ([https://openstack-browser.toolforge.org/server/osmit-podoma.osmit.eqiad1.wikimedia.cloud OpenStack browser], [https://horizon.wikimedia.org/project/instances/d659580d-0f8e-42fd-acb5-c9ed65936ce6/ Horizon]).
+
I dati nel DB sono aggiornati quotidianamente tramite cron root (<code>sudo crontab -l</code> per i dettagli).
All'interno del VPS i componenti del sito sono deployati con Docker Compose da <code>/home/dsantini/podoma/docker-compose.yml</code>, è possibile controllare i servizi con <code>sudo docker ps</code>.
 
Tutti i dati permanenti del sito sono all'interno dei volumi Docker che sono salvati nel volume <code>osmit-podoma-disk</code>, montato in <code>/mnt/volume</code>.
 
  
 
== Aspetti tecnici ==
 
== Aspetti tecnici ==
Riga 34: Riga 49:
 
=== Setup con Docker Compose ===
 
=== Setup con Docker Compose ===
  
<ol>
+
* Clonare la repo con <code copy>git clone https://gitlab.wikimedia.org/repos/wikimedia-it/osmit-podoma.git --branch italia</code>
<li>Clonare la repo con <code copy>git clone https://github.com/osm-fr/podoma.git</code></li>
+
* Entrare nella cartella della repo e inizializzare i sottomoduli con <code copy>git submodule update --init</code>
<li>Entrare nella cartella della repo e inizializzare i sottomoduli con <code>git submodule update --init</code></li>
+
* Creare <code>config.json</code> con <code copy>cp config.italia.json config.json</code> e modificarlo aggiungendo i secret
<li>Creare <code>config.json</code> copiando e adattando [[OpenStreetMap/Podoma/config.json]]</li>
+
* Compilare le immagini docker con <code copy>docker compose build</code>
<li>Configurare i progetti dei mesi nella cartella <code>projects</code></li>
+
* Avviare il DB con <code copy>docker compose up -d pgsqldb</code>
<li>Eseguire <code copy>docker compose build</code></li>
+
* Inizializzare il DB con <code copy>docker compose run --rm pdm install</code>
<li>Avviare il DB con <code copy>docker compose up -d pgsqldb</code></li>
+
* Scaricare i dati OSM e caricarli sul DB con <code copy>docker compose run --rm pdm init</code> (è normale che richieda molto tempo, anche varie ore)
<li>Inizializzare il DB con <code copy>docker compose run --rm pdm install</code></li>
+
* Avviare il server con <code copy>docker compose up -d</code>
<li>Scaricare i dati OSM e caricarli sul DB con <code copy>docker compose run --rm pdm init</code> (è normale che richieda molto tempo)</li>
 
<li>Avviare il server con <code copy>docker compose up -d</code></li>
 
</ol>
 

Versione attuale delle 20:56, 26 feb 2026

Software realizzato dai volontari OpenStreetMap francesi per tracciare i progressi del loro progetto del mese OSM, usato anche dagli italiani per tracciare i progressi del progetto del mese italiano:

Link utili

Istanza italiana

Accessibile su https://osmit-podoma.wmcloud.org . Qui l'annuncio su OSM Community.

Deployato in WMF Cloud VPS, progetto osmit (Server#Altri_server_in_Wikimedia_Cloud), VPS osmit-podoma (OpenStack browser, Horizon). All'interno del VPS i componenti del sito sono deployati con Docker Compose da /home/dsantini/podoma/docker-compose.yml, è possibile controllare i servizi con sudo docker ps:

Container Esposto Note
pgsqldb No Database del server
pdm https://osmit-podoma.wmcloud.org Sito web vero e proprio
pdm-tileserv https://osmit-podoma-tiles.wmcloud.org Tile server, necessario per la visualizzazione delle statistiche sulla mappa nel sito
pgadmin https://osmit-podoma-pgadmin.wmcloud.org Permette di esplorare e amministrare il DB. Normalmente spento, per usarlo va acceso con sudo docker compose --profile pgadmin up -d pgadmin

Tutti i dati permanenti del sito sono all'interno dei volumi Docker che sono salvati nel volume Cloud VPS osmit-podoma-disk, montato in /mnt/volume. La dimensione attuale del volume è 75GB, attualmente a regime solo 15 GB sono occupati, ma in fase di inizializzazione/aggiornamento del DB più di 40GB sono occupati quindi fare molta attenzione prima di ridurre la dimensione.

I dati nel DB sono aggiornati quotidianamente tramite cron root (sudo crontab -l per i dettagli).

Aspetti tecnici

Vedere la documentazione ufficiale.

Architettura e requisiti

Tre componenti:

  • Web server Podoma (NodeJS >= 24, Python 3, Osmium > 1.18, Imposm >= 3)
  • Database PostGIS (PostgreSQL >= 15)
  • Tile server (pg_tileserv)

Sono disponibili le configurazioni per il deploy con Docker Compose

Setup con Docker Compose

  • Clonare la repo con git clone https://gitlab.wikimedia.org/repos/wikimedia-it/osmit-podoma.git --branch italia
  • Entrare nella cartella della repo e inizializzare i sottomoduli con git submodule update --init
  • Creare config.json con cp config.italia.json config.json e modificarlo aggiungendo i secret
  • Compilare le immagini docker con docker compose build
  • Avviare il DB con docker compose up -d pgsqldb
  • Inizializzare il DB con docker compose run --rm pdm install
  • Scaricare i dati OSM e caricarli sul DB con docker compose run --rm pdm init (è normale che richieda molto tempo, anche varie ore)
  • Avviare il server con docker compose up -d