Differenze tra le versioni di "Progetto Percorsi Agili/Technical documentation"

Da Wikimedia Italia.
Jump to navigation Jump to search
(Creata pagina con "{{Stub}} {{Server|intreccio}} This page is the '''technical documentation''' for a webapp related to ''Progetto Percorsi Agili''. See online: * '''https://barriere.wikim...")
 
 
(15 versioni intermedie di 2 utenti non mostrate)
Riga 1: Riga 1:
{{Stub}}
 
 
{{Server|intreccio}}
 
{{Server|intreccio}}
 
This page is the '''technical documentation''' for a webapp related to ''[[Progetto Percorsi Agili]]''.
 
This page is the '''technical documentation''' for a webapp related to ''[[Progetto Percorsi Agili]]''.
Riga 6: Riga 5:
  
 
* '''https://barriere.wikimedia.it/'''
 
* '''https://barriere.wikimedia.it/'''
 +
 +
Problems? See [[#Contact]].
  
 
== Access ==
 
== Access ==
Riga 14: Riga 15:
  
 
How to be authorized? See [[Infrastruttura]].
 
How to be authorized? See [[Infrastruttura]].
 +
 +
== Webserver ==
 +
 +
{| class="wikitable"
 +
! URL
 +
! Filesystem
 +
|-
 +
| https://barriere.wikimedia.it/
 +
| <code>/var/www/barriere/www</code>
 +
|-
 +
| https://barriere.wikimedia.it/public/static/data/
 +
| <code>/var/www/barriere/repos/OSM-Accessibility-Data/data</code>
 +
|}
 +
 +
Note that the data is automagically updated via [[#Cron]].
 +
 +
== Open Route Service ==
 +
 +
The [https://openrouteservice.org/ Open Route Service] enables in-app routing and needs a key.
 +
 +
The key should be specified here:
 +
 +
<pre>
 +
/var/www/barriere/www/static/config.js
 +
</pre>
 +
 +
In this way:
 +
 +
<pre>
 +
window.OPENROUTE_KEY = '';
 +
</pre>
 +
 +
The account was registered by [[User:LorenzoStucchi]] and [[User:Anisa]] with the mailbox <code>segreteria</code> at wikimedia.it.
  
 
== Filesystem ==
 
== Filesystem ==
  
/var/www/barriere
+
User home:
 +
 
 +
<pre>
 +
ls -l /var/www/barriere/
 +
total 16
 +
drwxr-xr-x 2 barriere barriere 4096 giu 15 08:21 private
 +
drwxr-xr-x 3 barriere barriere 4096 giu 16 11:59 repos
 +
drwxr-xr-x 2 barriere barriere 4096 giu 16 12:05 scripts
 +
drwxr-xr-x 2 barriere barriere 4096 giu 15 08:21 www
 +
</pre>
  
 
Document root:
 
Document root:
  
 
  /var/www/barriere/www
 
  /var/www/barriere/www
 +
 +
== Cron ==
 +
 +
A cronjob keeps the data up to date from a GitHub repository.
 +
 +
<pre>
 +
# every two hour update OSM Accessibility map
 +
#  https://github.com/GISdevio/OSM-Accessibility-Web
 +
# https://wiki.wikimedia.it/wiki/Progetto_Percorsi_Agili/Technical_documentation
 +
# m    h    dom mon dow  command
 +
  22  */2  *  *  *    su barriere --command /var/www/barriere/scripts/update.sh
 +
</pre>
 +
 +
Script:
 +
 +
<pre>
 +
#!/bin/sh
 +
 +
set -e
 +
 +
# https://github.com/GISdevio/OSM-Accessibility-Web
 +
cd /var/www/barriere/repos/OSM-Accessibility-Data
 +
git pull --quiet
 +
</pre>
 +
 +
== Source code ==
 +
 +
This is the source code that generates the static HTML of the website:
 +
 +
* https://github.com/GISdevio/OSM-Accessibility-Web
 +
* https://github.com/GISdevio/OSM-Accessibility-Data
  
 
== Database ==
 
== Database ==
  
None.
+
The application is stateless.
 +
 
 +
== Backup ==
 +
 
 +
The application is stateless.
 +
 
 +
== Contact ==
 +
;Project contact: [[Utente:LorenzoStucchi]] (OSM [[Coordinatori|coordinator]])
 +
;Generic contact: [[Contatti]]
 +
; Contact for app features and app issues: https://github.com/GISdevio/OSM-Accessibility-Web/issues (upstream developers)
 +
; Contact for server issues: [[User:Valerio Bozzolan]] (volunteer sysadmin)
 +
 
 +
[[Categoria:Documentazione tecnica|Progetto Percorsi Agili]]
 +
[[Categoria:Percorsi Agili]]

Versione attuale delle 15:20, 20 apr 2022

Pagina legata al server ⚙️ intreccio

This page is the technical documentation for a webapp related to Progetto Percorsi Agili.

See online:

Problems? See #Contact.

Access

Secure access via SSH using your public key:

ssh barriere@intreccio.wikimedia.it

How to be authorized? See Infrastruttura.

Webserver

URL Filesystem
https://barriere.wikimedia.it/ /var/www/barriere/www
https://barriere.wikimedia.it/public/static/data/ /var/www/barriere/repos/OSM-Accessibility-Data/data

Note that the data is automagically updated via #Cron.

Open Route Service

The Open Route Service enables in-app routing and needs a key.

The key should be specified here:

/var/www/barriere/www/static/config.js

In this way:

window.OPENROUTE_KEY = '';

The account was registered by User:LorenzoStucchi and User:Anisa with the mailbox segreteria at wikimedia.it.

Filesystem

User home:

ls -l /var/www/barriere/
total 16
drwxr-xr-x 2 barriere barriere 4096 giu 15 08:21 private
drwxr-xr-x 3 barriere barriere 4096 giu 16 11:59 repos
drwxr-xr-x 2 barriere barriere 4096 giu 16 12:05 scripts
drwxr-xr-x 2 barriere barriere 4096 giu 15 08:21 www

Document root:

/var/www/barriere/www

Cron

A cronjob keeps the data up to date from a GitHub repository.

# every two hour update OSM Accessibility map
#  https://github.com/GISdevio/OSM-Accessibility-Web
# https://wiki.wikimedia.it/wiki/Progetto_Percorsi_Agili/Technical_documentation
# m    h    dom mon dow   command
  22   */2  *   *   *     su barriere --command /var/www/barriere/scripts/update.sh

Script:

#!/bin/sh

set -e

# https://github.com/GISdevio/OSM-Accessibility-Web
cd /var/www/barriere/repos/OSM-Accessibility-Data
git pull --quiet

Source code

This is the source code that generates the static HTML of the website:

Database

The application is stateless.

Backup

The application is stateless.

Contact

Project contact
Utente:LorenzoStucchi (OSM coordinator)
Generic contact
Contatti
Contact for app features and app issues
https://github.com/GISdevio/OSM-Accessibility-Web/issues (upstream developers)
Contact for server issues
User:Valerio Bozzolan (volunteer sysadmin)