Files
Studio_Grasso/docs/DEPLOY.md
T
Claude ac69a4351f fix: revisione legale e dei fatti prima del rilascio
- privacy: sezione sulle mappe di Google (consenso, contitolarità C-40/17,
  Data Privacy Framework), PEC personale della Dott.ssa Giulia Grasso,
  trasferimenti condizionati a fornitori.soloSee, art. 13, frasi sul
  consenso e sul modulo solo quando servono, grammatica dei destinatari
- mappe: avviso sulla scelta valida per tutto il sito e pulsante
  «Non caricare più le mappe» con test di revoca
- modulo: checkbox di presa visione, informativa breve dai dati dello
  Studio, nota diversa per php/endpoint, fornitori.modulo obbligatorio
  in modalità endpoint, messaggi da testi.ts
- contact.php: HMAC dell'IP con segreto casuale, cartella privata
  0700/0600 fuori dalla webroot, cancellazione dopo un'ora
- note legali e accessibilità: D.Lgs. 139/2005 e Codice deontologico,
  clausola di responsabilità, usi di JavaScript completi
- testi senza promesse di tempi; TODO B2/B3/B4/B5/C12, DECISIONS D-036–D-039

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
2026-10-15 23:35:06 +00:00

9.7 KiB

Pubblicare il sito sull'hosting

Il sito è un insieme di file statici: funziona su qualsiasi hosting (Apache/LiteSpeed con o senza PHP, nginx, object storage). Ogni release pubblicata su Forgejo contiene:

File Uso
sito-studio-grasso-vX.Y.Z.zip formato consigliato per i pannelli di hosting (cPanel, Plesk, Aruba, Register, SiteGround…)
sito-studio-grasso-vX.Y.Z.tar.gz server Linux con accesso SSH, nginx, object storage
SHA256SUMS.txt impronte per verificare che i file scaricati siano integri
BUILD-INFO.txt versione, commit, data e strumenti usati per la build

Il contenuto del sito è alla radice dell'archivio (non c'è una cartella da aprire): index.html, 404.html, .htaccess, robots.txt, sitemap-index.xml, le cartelle delle pagine e _astro/.

Il file .htaccess è nascosto (inizia con un punto): assicurarsi che il programma FTP o il file manager mostri i file nascosti e che venga caricato.

1. Scaricare e verificare il pacchetto

Dalla pagina Release del repository Forgejo scaricare lo zip (o il tar.gz) e SHA256SUMS.txt nella stessa cartella, poi:

sha256sum -c SHA256SUMS.txt --ignore-missing     # Linux
shasum -a 256 -c SHA256SUMS.txt --ignore-missing # macOS

Su Windows (PowerShell): Get-FileHash .\sito-studio-grasso-vX.Y.Z.zip -Algorithm SHA256 e confrontare con la riga corrispondente di SHA256SUMS.txt.

2. Hosting con pannello (cPanel, Plesk, DirectAdmin…)

  1. Aprire il File Manager del pannello ed entrare nella cartella pubblica del dominio (public_html su cPanel, httpdocs su Plesk).
  2. Fare una copia di sicurezza del sito esistente (o scaricarla), poi svuotare la cartella.
  3. Caricare lo zip e usare Estrai (Extract) nella stessa cartella.
  4. Verificare che nella cartella ci siano index.html e .htaccess (attivare «mostra file nascosti»), poi eliminare lo zip.
  5. Attivare il certificato HTTPS (Let's Encrypt/AutoSSL) dal pannello, se non è già attivo.

Note sul .htaccess

  • Il redirect HTTP → HTTPS è attivo: se l'hosting lo gestisce già dal pannello, o se il certificato non è ancora attivo, commentare le tre righe indicate nella sezione «Redirect».
  • Il redirect tra dominio con e senza «www» è commentato: decommentare la variante coerente con il dominio usato per la build (SITE_URL, predefinito https://www.grassoezio.it → variante A).
  • HSTS è commentato: attivarlo solo quando HTTPS funziona su tutto il dominio.
  • Se compare un errore 500 dopo il caricamento, l'hosting non consente una direttiva: commentare la riga indicata nel log degli errori del pannello (tutte le direttive dei moduli sono già dentro <IfModule>).
  • La configurazione è stata provata su Apache 2.4 con AllowOverride All (vedi DECISIONS.md, D-034).

3. FTP / SFTP

  1. Estrarre lo zip sul proprio computer in una cartella vuota.
  2. Con il programma FTP (es. FileZilla, modalità di trasferimento automatica o binaria) caricare il contenuto della cartella, .htaccess compreso, nella cartella pubblica del dominio, sostituendo i file esistenti.
  3. Eliminare dal server i file del vecchio sito non più presenti (es. vecchie pagine .php o .html), dopo averne fatto una copia.

4. Server con nginx

  1. Copiare sito-studio-grasso-vX.Y.Z.tar.gz sul server ed estrarlo:

    sudo mkdir -p /var/www/studio-grasso
    sudo tar -xzf sito-studio-grasso-vX.Y.Z.tar.gz -C /var/www/studio-grasso
    
  2. Usare come base deploy/nginx.conf.example (redirect HTTPS e www, try_files, error_page 404, header di sicurezza, cache, compressione, blocco dei file nascosti): adattare server_name e certificati, poi sudo nginx -t && sudo systemctl reload nginx.

  3. Il .htaccess è ignorato da nginx (e bloccato dalla configurazione).

5. Object storage (S3 compatibile, hosting statico)

  1. Estrarre il tar.gz e caricare il contenuto nel bucket (es. rclone sync sito/ remote:bucket), con «documento indice» index.html e «documento di errore» 404.html.
  2. Il .htaccess non è usato: configurare nel CDN o nel servizio redirect HTTPS, il redirect /privacy → /privacy-policy/ e gli header di sicurezza (Content-Security-Policy, X-Content-Type-Options, Referrer-Policy, X-Frame-Options, Permissions-Policy) come in public/.htaccess.

6. Modulo di contatto (facoltativo)

Per impostazione predefinita il modulo è disattivato (contactForm.mode = 'off'): la pagina Contatti mostra il pulsante «Scrivi a info@studiograssoezio.it». Nessun dato passa dal server del sito.

Modalità php (hosting con PHP 7.4+ e funzione mail())

  1. In src/data/studio.ts impostare mode: 'php' (oggetto contactForm).
  2. Copiare deploy/optional-php-form/contact.php in public/contact.php e controllare le costanti in testa al file: DESTINATARIO (predefinito info@studiograssoezio.it) e MITTENTE (una casella del dominio del sito, es. noreply@…, perché molti hosting rifiutano mittenti esterni).
  3. npm run verify, commit e nuova release: il pacchetto conterrà contact.php.
  4. Dopo il deploy inviare una richiesta di prova e verificare la ricezione (anche nella cartella spam).

Il gestore:

  • valida i campi e scarta in silenzio gli invii con il campo trappola compilato;
  • rifiuta gli invii troppo rapidi (meno di 3 secondi) e quelli oltre 5 all'ora dallo stesso indirizzo IP;
  • non salva il contenuto dei messaggi e reindirizza a /contatti/grazie/.

Il contatore degli invii è un file per IP con un nome cifrato (HMAC dell'IP con un segreto casuale generato al primo uso), cancellato dopo un'ora. Sta in una cartella privata fuori dalla cartella pubblica: la costante CARTELLA_LIMITI, predefinita ../.studio-grasso-form, cioè accanto a public_html. Se l'hosting non permette di scrivere lì, indicare una cartella privata scrivibile. Senza una cartella sicura il limite non si applica.

La Privacy policy si aggiorna automaticamente.

Modalità endpoint (servizio esterno di gestione moduli)

  1. Scegliere un fornitore con sede e server nell'Unione europea e conforme al GDPR; nominarlo responsabile del trattamento.
  2. In src/data/studio.ts impostare mode: 'endpoint' e endpoint: 'https://…'.
  3. Aggiornare la Content-Security-Policy (public/.htaccess e deploy/nginx.conf.example): aggiungere il dominio del fornitore a form-action.
  4. Indicare denominazione e sede del fornitore in studio.fornitori.modulo (senza, la build si ferma): compaiono nella Privacy policy e sotto il modulo. Far rivedere la Privacy policy al consulente.

7. Controlli dopo la pubblicazione

  • https:// attivo, il lucchetto del browser è presente e http:// reindirizza a https://.
  • Il dominio con/senza «www» reindirizza alla versione usata in SITE_URL.
  • https://dominio/privacy reindirizza a /privacy-policy/; https://dominio/studio a /studio/.
  • Un indirizzo inesistente (es. /prova-404/) mostra la pagina «Pagina non trovata».
  • https://dominio/sitemap-index.xml e /robots.txt sono raggiungibili.
  • Gli header di sicurezza sono presenti (es. con securityheaders.com o curl -I https://dominio/).
  • Le mappe si caricano solo premendo «Carica la mappa».
  • Lighthouse sul sito pubblicato (Chrome → DevTools → Lighthouse, modalità mobile): valori in linea con quelli della CI.
  • Modulo (se attivo): richiesta di prova ricevuta.
  • Google Search Console: inviare la sitemap sitemap-index.xml (facoltativo).

8. Tornare alla versione precedente

Scaricare dalla pagina Release il pacchetto della versione precedente e ripetere la procedura (punto 2, 3, 4 o 5). Ogni release è completa e indipendente.

9. Deploy automatico (facoltativo, da attivare quando l'hosting è definito)

deploy/forgejo-deploy.yml.example è un workflow pronto ma non attivo: alla pubblicazione di una release (o su avvio manuale) scarica il pacchetto, ne verifica l'impronta e lo pubblica, poi controlla che le pagine principali rispondano.

  1. Copiarlo in .forgejo/workflows/deploy.yml.
  2. Decommentare una variante e creare i segreti del repository (Impostazioni → Actions → Segreti):
    • A — rsync su SSH: DEPLOY_HOST, DEPLOY_USER, DEPLOY_PATH, DEPLOY_SSH_KEY (chiave privata dedicata, con la chiave pubblica in ~/.ssh/authorized_keys sul server);
    • B — FTPS con lftp: FTP_HOST, FTP_USER, FTP_PASSWORD, FTP_PATH (es. /public_html);
    • C — rclone (object storage): RCLONE_CONFIG (contenuto di rclone.conf), RCLONE_DEST.
  3. Facoltativo: variabile del repository SITE_URL per il controllo finale; segreto FORGEJO_TOKEN se il token automatico non può scaricare gli allegati delle release.
  4. Aggiungere al passo «Strumenti» i programmi della variante scelta (rsync openssh-client, lftp o rclone).

10. Pubblicare la release a mano (senza workflow)

Se le Actions non sono disponibili:

RELEASE_VERSION=vX.Y.Z npm run package
FORGEJO_URL=https://forgejo.example.it FORGEJO_REPO=proprietario/repository \
FORGEJO_TOKEN=<token write:repository> scripts/release-upload.sh vX.Y.Z

Il tag deve già esistere sul server (git push origin vX.Y.Z). Lo script crea la release (o aggiorna quella esistente) con le note del CHANGELOG e carica i quattro file di release/.