Files
Studio_Grasso/deploy/forgejo-deploy.yml.example
T
Alby96andClaude Opus 5.5 3befe7e266 fix: CI adattata a Forgejo, revisione completa del codice e avvio in debug
Le run della CI restavano «in attesa» perché l'unico runner dell'istanza («Ferrari») non si è
mai collegato: il runner resta da configurare. La revisione completa del codice ha trovato
anche difetti che avrebbero fatto fallire la CI con il runner online, oltre ad altri problemi
del sito, dei controlli e della documentazione.

CI e rilascio:
- continue-on-error sullo step dei link esterni: Forgejo lo ignora sul job, e un sito esterno
  irraggiungibile avrebbe reso rossa la CI;
- artifact con i file nascosti (report Lighthouse e .htaccess non venivano mai caricati);
- token personale RELEASE_TOKEN: FORGEJO_TOKEN è riservato ed è sempre il token automatico;
- dominio in un solo punto (site.config.mjs) e variabile del repository SITE_URL;
- ripiego REST: release in bozza, file, poi pubblicazione; tag verificato sul server;
  sostituzione dei file senza mai lasciarli mancanti;
- tar.gz identico su Windows, macOS e Linux (byte del sistema operativo nell'header gzip).

Sito: CSS compatibile con Safari/iOS 15 (media query classiche, backdrop-filter), anello di
focus con contrasto di almeno 3:1, bersagli touch di 44 px dove servono, intestazione desktop
senza voci o logo a capo, HTML valido in /servizi/, colore delle chip, stampa senza mappe,
giorni di apertura, ricerca e titolo delle mappe e numero breve ricavati dai dati.

Modulo di contatto e contact.php: stesse regole nel browser e sul server (spazi, e-mail,
a capo, lunghezze), tempo minimo misurato con un solo orologio (ts_invio), corpo in
quoted-printable e oggetto RFC 2047, funzionamento con PHP a 32 bit, costante
MODALITA_PREDEFINITA per attivarlo.

Controlli e test: valori letti dai dati del sito, i sei servizi del brief con le ancore,
«commercialista» anche in meta, attributi e dati strutturati, .htaccess su righe attive,
HSTS attivabile con una scelta esplicita, contrasto del focus misurato nei test.

Esempi di pubblicazione: nginx con gli header di sicurezza in un solo punto (HSTS compreso),
deploy automatico che parte alla pubblicazione e sincronizza solo una cartella confermata,
procedura nginx che toglie i file delle versioni precedenti.

Debug: .vscode/launch.json e tasks.json, F5 avvia il server Astro e apre il browser con il
debugger collegato.

Documentazione aggiornata (README, DEPLOY, CONTENUTI, CONFORMITA, TODO-STUDIO, CHANGELOG) e
decisioni D-045…D-055.

Verificato: npm run verify su Windows e nel container della CI (Playwright 1.56.1, root);
job dei link esterni in node:24; contact.php con PHP 7.4 e 8.3, a 64 e 32 bit; nginx in
Docker; release-upload.sh e deploy di esempio contro API e shell simulate.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 13:40:16 +02:00

197 lines
11 KiB
Plaintext

# =============================================================================
# DEPLOY AUTOMATICO (DISATTIVATO) — esempio per Forgejo Actions.
#
# Per attivarlo: copiare questo file in .forgejo/workflows/deploy.yml, scegliere UNA delle
# varianti qui sotto (rsync su SSH, FTPS con lftp, object storage con rclone), decommentarla
# e creare i segreti del repository indicati (Impostazioni → Actions → Segreti).
# Istruzioni complete in docs/DEPLOY.md, sezione «Deploy automatico».
#
# Si avvia quando release.yml pubblica una release stabile oppure a mano (workflow_dispatch,
# indicando il tag: serve anche per tornare a una versione precedente). Pubblica il pacchetto
# della release, già verificato.
# - Evento: l'action forgejo-release crea la release in bozza e poi la pubblica, e Forgejo
# notifica questo passaggio come «edited», non come «published». Per questo si ascoltano
# entrambi, e il job «controllo» procede solo per una release stabile che sia l'ultima
# pubblicata e, per «edited», solo se i file sono stati caricati nell'ultima ora (cioè è la
# pubblicazione fatta da release.yml o da scripts/release-upload.sh). Modificare in seguito
# titolo o note di una release, anche l'ultima, non avvia il deploy. Dopo un ritorno manuale
# a una versione precedente segnare come pre-release la versione ritirata.
# - Token: l'avvio automatico funziona solo se release.yml pubblica la release con un token
# personale (segreto RELEASE_TOKEN): le modifiche fatte con il token automatico non avviano
# altri workflow. Senza il segreto, avviarlo a mano dalla scheda Actions.
# I file gestiti dall'hosting (.well-known/, .user.ini, cgi-bin/) sono esclusi dalla
# sincronizzazione, quindi non vengono cancellati.
# RUNNER: `runs-on: docker`, adattare il label come negli altri workflow.
# =============================================================================
name: Deploy
on:
release:
types: [published, edited]
workflow_dispatch:
inputs:
tag:
description: 'Tag della release da pubblicare (es. v1.0.0)'
required: true
jobs:
controllo:
name: Release da pubblicare
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
container:
image: debian:stable-slim
outputs:
tag: ${{ steps.scelta.outputs.tag }}
steps:
- name: Scegli la release
id: scelta
env:
EVENTO: ${{ github.event_name }}
AZIONE: ${{ github.event.action }}
TAG_MANUALE: ${{ inputs.tag }}
TAG_RELEASE: ${{ github.event.release.tag_name }}
BOZZA: ${{ github.event.release.draft }}
PRERELEASE: ${{ github.event.release.prerelease }}
TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: |
set -eu
if [ "$EVENTO" = workflow_dispatch ]; then
echo "tag=$TAG_MANUALE" >> "$GITHUB_OUTPUT"
exit 0
fi
if [ "$BOZZA" = true ] || [ "$PRERELEASE" = true ]; then
echo "$TAG_RELEASE è una bozza o una pre-release: nessun deploy."
exit 0
fi
apt-get update -qq && apt-get install -y -qq --no-install-recommends ca-certificates curl jq >/dev/null
# «edited» anche per le modifiche successive: si procede solo se i file sono appena stati
# caricati, cioè se è la pubblicazione fatta da release.yml o da release-upload.sh
if [ "$AZIONE" != published ]; then
ULTIMO_FILE="$(jq -r '[.release.assets[].created_at] | max // empty' "$GITHUB_EVENT_PATH")"
if [ -z "$ULTIMO_FILE" ] || [ $(( $(date +%s) - $(date -d "$ULTIMO_FILE" +%s) )) -gt 3600 ]; then
echo "$TAG_RELEASE: modifica di una release già pubblicata, nessun deploy (per ripubblicarla usare l'avvio manuale)."
exit 0
fi
fi
# chiamata separata dal parsing: se l'API non risponde lo step fallisce (set -e) invece
# di saltare il deploy in silenzio
RISPOSTA="$(curl -fsS -H "Authorization: token ${TOKEN}" \
"${{ github.server_url }}/api/v1/repos/${{ github.repository }}/releases/latest")"
ULTIMA="$(printf '%s' "$RISPOSTA" | jq -r .tag_name)"
if [ -z "$ULTIMA" ] || [ "$ULTIMA" = null ]; then
echo "risposta inattesa da /releases/latest" >&2
exit 1
fi
if [ "$ULTIMA" != "$TAG_RELEASE" ]; then
echo "$TAG_RELEASE non è l'ultima release pubblicata ($ULTIMA): nessun deploy."
exit 0
fi
echo "tag=$TAG_RELEASE" >> "$GITHUB_OUTPUT"
deploy:
needs: controllo
if: needs.controllo.outputs.tag != ''
runs-on: docker # label del runner: adattare (es. ubuntu-latest)
container:
image: debian:stable-slim
environment: produzione
steps:
- name: Strumenti
run: apt-get update && apt-get install -y --no-install-recommends ca-certificates curl unzip
# aggiungere: rsync openssh-client (variante A) · lftp (variante B) · rclone (variante C)
- name: Scarica il pacchetto della release
env:
TAG: ${{ needs.controllo.outputs.tag }}
TOKEN: ${{ secrets.GITHUB_TOKEN }} # il token automatico basta per scaricare
run: |
set -eu
VERSION="${TAG#v}"
BASE="${{ github.server_url }}/${{ github.repository }}/releases/download/${TAG}"
curl -fsSL -H "Authorization: token ${TOKEN}" -o pacchetto.zip "${BASE}/sito-studio-grasso-v${VERSION}.zip"
curl -fsSL -H "Authorization: token ${TOKEN}" -o SHA256SUMS.txt "${BASE}/SHA256SUMS.txt"
curl -fsSL -H "Authorization: token ${TOKEN}" -o BUILD-INFO.txt "${BASE}/BUILD-INFO.txt"
grep " sito-studio-grasso-v${VERSION}.zip$" SHA256SUMS.txt | sed "s/sito-studio-grasso-v${VERSION}.zip/pacchetto.zip/" | sha256sum -c -
grep ' BUILD-INFO.txt$' SHA256SUMS.txt | sha256sum -c -
mkdir sito && unzip -q pacchetto.zip -d sito
# ---------------------------------------------------------------------------
# Variante A — rsync su SSH (VPS o hosting con accesso SSH)
# Segreti: DEPLOY_HOST, DEPLOY_USER, DEPLOY_PATH, DEPLOY_SSH_KEY (chiave privata)
# DEPLOY_PATH = cartella pubblica del sito (es. /var/www/studio-grasso): con --delete
# tutto ciò che contiene e non è nel pacchetto viene cancellato. Prima del primo deploy
# creare sul server il file di conferma: touch <DEPLOY_PATH>/.deploy-studio-grasso
# Senza quel file lo step si ferma: un percorso sbagliato (la home, /var/www…) non viene
# mai sincronizzato.
# ---------------------------------------------------------------------------
# - name: Pubblica con rsync
# env:
# DEPLOY_HOST: ${{ secrets.DEPLOY_HOST }}
# DEPLOY_USER: ${{ secrets.DEPLOY_USER }}
# DEPLOY_PATH: ${{ secrets.DEPLOY_PATH }}
# DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
# run: |
# set -eu
# # un segreto mancante vale "": senza questo controllo la destinazione sarebbe «/»
# : "${DEPLOY_PATH:?segreto DEPLOY_PATH mancante o vuoto}"
# case "$DEPLOY_PATH" in
# /|'~'|'~/'|.|./|/home|/home/|/root|/root/) echo "DEPLOY_PATH non sicuro: $DEPLOY_PATH" >&2; exit 1 ;;
# esac
# mkdir -p ~/.ssh && chmod 700 ~/.ssh
# printf '%s\n' "$DEPLOY_SSH_KEY" > ~/.ssh/id_deploy && chmod 600 ~/.ssh/id_deploy
# ssh-keyscan -H "$DEPLOY_HOST" >> ~/.ssh/known_hosts
# # la cartella deve essere quella del sito, confermata dal file creato a mano
# ssh -i ~/.ssh/id_deploy "$DEPLOY_USER@$DEPLOY_HOST" "test -f '$DEPLOY_PATH/.deploy-studio-grasso'" \
# || { echo "manca $DEPLOY_PATH/.deploy-studio-grasso: cartella del sito non confermata" >&2; exit 1; }
# rsync -az --delete --exclude '.well-known/' --exclude '.user.ini' --exclude 'cgi-bin/' \
# --exclude '.deploy-studio-grasso' \
# -e "ssh -i ~/.ssh/id_deploy" sito/ "$DEPLOY_USER@$DEPLOY_HOST:$DEPLOY_PATH/"
# ---------------------------------------------------------------------------
# Variante B — FTPS con lftp (hosting condivisi: cPanel, Plesk, Aruba, Register…)
# Segreti: FTP_HOST, FTP_USER, FTP_PASSWORD, FTP_PATH (es. /public_html)
# FTP_PATH = cartella pubblica del sito, MAI la radice dell'account quando questa è la home
# (cPanel): mirror --delete cancellerebbe posta, configurazioni e altri siti.
# ---------------------------------------------------------------------------
# - name: Pubblica via FTPS
# env:
# FTP_HOST: ${{ secrets.FTP_HOST }}
# FTP_USER: ${{ secrets.FTP_USER }}
# FTP_PASSWORD: ${{ secrets.FTP_PASSWORD }}
# FTP_PATH: ${{ secrets.FTP_PATH }}
# run: |
# set -eu
# : "${FTP_PATH:?segreto FTP_PATH mancante o vuoto}"
# lftp -u "$FTP_USER","$FTP_PASSWORD" -e "set ftp:ssl-force true; set ssl:verify-certificate yes; \
# mirror -R --delete --verbose --exclude-glob .well-known/ --exclude-glob .user.ini \
# --exclude-glob cgi-bin/ sito/ $FTP_PATH; quit" "$FTP_HOST"
# ---------------------------------------------------------------------------
# Variante C — object storage S3 compatibile con rclone
# Segreti: RCLONE_CONFIG (contenuto di rclone.conf con il remote «sito»), RCLONE_DEST (es. sito:bucket)
# ---------------------------------------------------------------------------
# - name: Pubblica su object storage
# env:
# RCLONE_CONFIG_CONTENT: ${{ secrets.RCLONE_CONFIG }}
# RCLONE_DEST: ${{ secrets.RCLONE_DEST }}
# run: |
# set -eu
# : "${RCLONE_DEST:?segreto RCLONE_DEST mancante o vuoto}"
# mkdir -p ~/.config/rclone && printf '%s\n' "$RCLONE_CONFIG_CONTENT" > ~/.config/rclone/rclone.conf
# rclone sync sito/ "$RCLONE_DEST" --checksum --exclude '.htaccess'
- name: Controllo dopo la pubblicazione
env:
SITE_URL: ${{ vars.SITE_URL }}
run: |
set -eu
# dominio per cui è stato costruito il pacchetto (BUILD-INFO.txt, scritto da
# scripts/package.mjs), se la variabile del repository SITE_URL non è impostata
SITE_URL="${SITE_URL:-$(sed -n 's/^SITE_URL: //p' BUILD-INFO.txt)}"
: "${SITE_URL:?dominio del sito non trovato in BUILD-INFO.txt}"
for p in / /servizi/ /contatti/ /sitemap-index.xml /robots.txt; do
code=$(curl -s -o /dev/null -w '%{http_code}' "${SITE_URL}${p}")
echo "${p} → ${code}"; [ "$code" = 200 ]
done
code=$(curl -s -o /dev/null -w '%{http_code}' "${SITE_URL}/pagina-inesistente/"); echo "404 → ${code}"; [ "$code" = 404 ]