https://wiki.gazzi.net/index.php?action=history&feed=atom&title=Progetti%2FCartClin
Progetti/CartClin - Cronologia
2026-05-17T01:04:57Z
Cronologia della pagina su questo sito
MediaWiki 1.40.1
https://wiki.gazzi.net/index.php?title=Progetti/CartClin&diff=644&oldid=prev
Maintenance script: Aggiunta documentazione progetto CartClin e pubblicazione cartclin.gazzi.net
2026-03-30T23:09:58Z
<p>Aggiunta documentazione progetto CartClin e pubblicazione cartclin.gazzi.net</p>
<p><b>Nuova pagina</b></p><div>== CartClin ==<br />
<br />
'''CartClin''' e' un'applicazione web Python/Flask pubblicata dietro reverse proxy come:<br />
<br />
* URL pubblico: <code>https://cartclin.gazzi.net/</code><br />
* host applicativo: <code>web01.gazzi.local</code><br />
* host proxy pubblico: <code>proxy01.gazzi.local</code><br />
<br />
== Architettura ==<br />
<br />
La pubblicazione e' divisa in tre livelli:<br />
<br />
* '''runtime applicativo''' su <code>web01</code><br />
* '''backend HTTP interno''' su <code>web01</code><br />
* '''reverse proxy e TLS''' su <code>proxy01</code><br />
<br />
=== Runtime applicativo su web01 ===<br />
<br />
Il codice applicativo viene installato in:<br />
<br />
* <code>/opt/cartclin</code><br />
<br />
Componenti principali runtime:<br />
<br />
* virtualenv Python: <code>/opt/cartclin/venv</code><br />
* database SQLite locale: <code>/opt/cartclin/cartclin.db</code><br />
* cache locale per WeasyPrint/fontconfig: <code>/opt/cartclin/.cache</code><br />
<br />
Il servizio applicativo e' gestito da systemd:<br />
<br />
* unit file: <code>/etc/systemd/system/cartclin.service</code><br />
* service name: <code>cartclin.service</code><br />
* utente runtime: <code>www-data</code><br />
* working directory: <code>/opt</code><br />
* variabili runtime rilevanti:<br />
** <code>PYTHONPATH=/opt</code><br />
** <code>HOME=/opt/cartclin</code><br />
** <code>XDG_CACHE_HOME=/opt/cartclin/.cache</code><br />
<br />
Il servizio avvia:<br />
<br />
* <code>gunicorn --workers 2 --bind 127.0.0.1:8090 cartclin.app:app</code><br />
<br />
=== Backend HTTP interno su web01 ===<br />
<br />
Nginx locale su <code>web01</code> pubblica l'app su una porta interna dedicata:<br />
<br />
* vhost backend: <code>/etc/nginx/sites-available/cartclin-backend</code><br />
* symlink attivo: <code>/etc/nginx/sites-enabled/cartclin-backend</code><br />
* bind interno: <code>0.0.0.0:8082</code><br />
* upstream applicativo: <code>http://127.0.0.1:8090</code><br />
<br />
Test locale atteso su <code>web01</code>:<br />
<br />
* <code>http://127.0.0.1:8090/</code> risponde con redirect a <code>/login</code><br />
* <code>http://127.0.0.1:8082/</code> risponde come proxy locale verso l'app<br />
<br />
=== Reverse proxy e TLS su proxy01 ===<br />
<br />
La pubblicazione pubblica e' gestita da <code>proxy01</code>:<br />
<br />
* vhost: <code>/etc/nginx/sites-available/cartclin</code><br />
* symlink attivo: <code>/etc/nginx/sites-enabled/cartclin</code><br />
* host pubblico: <code>cartclin.gazzi.net</code><br />
* upstream interno: <code>http://172.16.1.3:8082</code><br />
<br />
Comportamento del vhost:<br />
<br />
* su porta 80 esegue redirect verso HTTPS<br />
* su porta 443 termina TLS e inoltra verso <code>web01:8082</code><br />
<br />
== Certificato TLS ==<br />
<br />
Il certificato pubblico e' gestito con Let's Encrypt su <code>proxy01</code>:<br />
<br />
* certificate path: <code>/etc/letsencrypt/live/cartclin.gazzi.net/fullchain.pem</code><br />
* private key path: <code>/etc/letsencrypt/live/cartclin.gazzi.net/privkey.pem</code><br />
* rinnovo automatico: gestito da Certbot<br />
<br />
== Flusso richieste ==<br />
<br />
Percorso sintetico di una richiesta:<br />
<br />
# il client apre <code>https://cartclin.gazzi.net/</code><br />
# <code>proxy01</code> riceve TLS e inoltra verso <code>http://172.16.1.3:8082</code><br />
# <code>web01</code> inoltra verso <code>gunicorn</code> su <code>127.0.0.1:8090</code><br />
# l'app Flask serve la login page o le route applicative<br />
<br />
== Verifiche rapide ==<br />
<br />
Su <code>web01</code>:<br />
<br />
* <code>systemctl status cartclin.service</code><br />
* <code>curl -I http://127.0.0.1:8090/</code><br />
* <code>curl -I -H 'Host: web01.gazzi.local' http://127.0.0.1:8082/</code><br />
<br />
Su <code>proxy01</code>:<br />
<br />
* <code>nginx -t</code><br />
* <code>curl -I --resolve cartclin.gazzi.net:443:127.0.0.1 https://cartclin.gazzi.net/ -k</code><br />
* <code>certbot certificates</code><br />
<br />
== Note operative ==<br />
<br />
* Non versionare segreti o password nel repository.<br />
* Il file SQLite fa parte del runtime applicativo e va trattato come dato operativo, non come configurazione di proxy.<br />
* Se si cambia host o porta interna, aggiornare sia il backend Nginx su <code>web01</code> sia il reverse proxy su <code>proxy01</code>.</div>
Maintenance script