Files
Studio_Grasso/scripts/release-upload.sh
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

105 lines
5.7 KiB
Bash
Executable File

#!/usr/bin/env bash
# =============================================================================
# Pubblica una release su Forgejo tramite API REST e carica i file di release/.
# Alternativa manuale (o step di riserva) all'action forgejo-release del workflow.
#
# Uso:
# FORGEJO_URL=https://forgejo.example.it \
# FORGEJO_REPO=proprietario/repository \
# FORGEJO_TOKEN=<token con permesso write:repository> \
# scripts/release-upload.sh v1.0.0 [cartella] # cartella predefinita: release
#
# Prima eseguire `npm run package` con RELEASE_VERSION=v1.0.0 e pubblicare il tag
# (git push origin v1.0.0): lo script si ferma se il tag non è sul server oppure se punta a
# un commit diverso dal tag locale. Le note della release sono prese da CHANGELOG.md.
#
# Come l'action, una release nuova viene creata in bozza, riceve i file e solo alla fine viene
# pubblicata. Se la release esiste già (anche come bozza lasciata dall'action), i file con lo
# stesso nome vengono sostituiti (prima si carica il nuovo, poi si cancella il vecchio) e la
# release viene pubblicata con titolo e note del CHANGELOG.
# =============================================================================
set -euo pipefail
TAG="${1:-${RELEASE_VERSION:-}}"
DIR="${2:-release}"
die() { echo "✘ $*" >&2; exit 1; }
[ -n "$TAG" ] || die "indicare il tag, es.: scripts/release-upload.sh v1.0.0"
[ -n "${FORGEJO_URL:-}" ] || die "variabile FORGEJO_URL mancante (es. https://forgejo.example.it)"
[ -n "${FORGEJO_REPO:-}" ] || die "variabile FORGEJO_REPO mancante (es. proprietario/repository)"
[ -n "${FORGEJO_TOKEN:-}" ] || die "variabile FORGEJO_TOKEN mancante"
[ -d "$DIR" ] || die "cartella $DIR assente: eseguire prima npm run package"
command -v curl >/dev/null || die "curl non installato"
command -v node >/dev/null || die "node non installato"
API="${FORGEJO_URL%/}/api/v1/repos/${FORGEJO_REPO}"
AUTH="Authorization: token ${FORGEJO_TOKEN}"
# Valore di un campo (anche annidato: «commit.sha») di un oggetto JSON letto da stdin.
json_field() { node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{let v=JSON.parse(s);for(const k of process.argv[1].split("."))v=v==null?undefined:v[k];if(v===undefined)process.exit(1);console.log(typeof v==="object"?JSON.stringify(v):v)})' "$1"; }
# Id degli asset con un certo nome, da un elenco JSON letto da stdin.
asset_ids() { node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{console.log(JSON.parse(s).filter(a=>a.name===process.argv[1]).map(a=>a.id).join(" "))})' "$1"; }
urlencode() { node -e 'console.log(encodeURIComponent(process.argv[1]))' "$1"; }
TAG_URL="$(urlencode "$TAG")"
NOTES="$(node scripts/changelog-notes.mjs "$TAG")"
PRERELEASE=false
case "$TAG" in *-*) PRERELEASE=true ;; esac
# Dati della release; $1 = true per la bozza, false per pubblicarla.
payload() {
node -e 'console.log(JSON.stringify({tag_name:process.argv[1],name:process.argv[1],body:process.argv[2],draft:process.argv[3]==="true",prerelease:process.argv[4]==="true"}))' \
"$TAG" "$NOTES" "$1" "$PRERELEASE"
}
echo "→ Release $TAG su $FORGEJO_REPO"
# 1) il tag deve essere già sul server: senza, Forgejo lo creerebbe sulla punta del branch
# predefinito (un altro commit) e avvierebbe release.yml
TAG_JSON="$(curl -fsS -H "$AUTH" "$API/tags/$TAG_URL")" \
|| die "tag $TAG assente sul server (o token senza accesso al repository): eseguire prima git push origin $TAG"
SERVER_SHA="$(printf '%s' "$TAG_JSON" | json_field commit.sha)" || die "risposta inattesa per il tag $TAG"
if LOCAL_SHA="$(git rev-parse --verify --quiet "refs/tags/$TAG^{commit}" 2>/dev/null)"; then
[ "$LOCAL_SHA" = "$SERVER_SHA" ] \
|| die "il tag $TAG sul server punta a $SERVER_SHA, quello locale a $LOCAL_SHA: pacchetto e tag non coincidono"
fi
# 2) release esistente (pubblicata o bozza) oppure nuova bozza
if EXISTING="$(curl -fsS -H "$AUTH" "$API/releases/tags/$TAG_URL" 2>/dev/null)"; then
RELEASE_ID="$(printf '%s' "$EXISTING" | json_field id)"
if [ "$(printf '%s' "$EXISTING" | json_field draft)" = "true" ]; then
echo " bozza già esistente (id $RELEASE_ID): caricamento dei file e pubblicazione"
else
echo " release già pubblicata (id $RELEASE_ID): sostituzione dei file con lo stesso nome"
fi
else
CREATED="$(curl -fsS -X POST -H "$AUTH" -H 'Content-Type: application/json' -d "$(payload true)" "$API/releases")" \
|| die "creazione della release non riuscita (il token ha il permesso write:repository?)"
RELEASE_ID="$(printf '%s' "$CREATED" | json_field id)"
echo " bozza creata (id $RELEASE_ID)"
fi
# 3) file: prima il nuovo, poi la cancellazione dell'eventuale versione precedente, così un
# errore a metà non lascia la release senza quel file
ASSETS="$(curl -fsS -H "$AUTH" "$API/releases/$RELEASE_ID/assets")" \
|| die "elenco dei file della release $RELEASE_ID non disponibile"
for FILE in "$DIR"/*; do
[ -f "$FILE" ] || continue
NAME="$(basename "$FILE")"
OLD_IDS="$(printf '%s' "$ASSETS" | asset_ids "$NAME")"
curl -fsS -X POST -H "$AUTH" -F "attachment=@${FILE}" \
"$API/releases/$RELEASE_ID/assets?name=$(urlencode "$NAME")" >/dev/null \
|| die "caricamento di $NAME non riuscito"
for OLD_ID in $OLD_IDS; do
curl -fsS -X DELETE -H "$AUTH" "$API/releases/$RELEASE_ID/assets/$OLD_ID" >/dev/null \
|| die "cancellazione della versione precedente di $NAME (id $OLD_ID) non riuscita"
done
echo " ✔ $NAME${OLD_IDS:+ (sostituito)}"
done
# 4) pubblicazione (o aggiornamento di titolo e note) solo con tutti i file caricati
curl -fsS -X PATCH -H "$AUTH" -H 'Content-Type: application/json' -d "$(payload false)" \
"$API/releases/$RELEASE_ID" >/dev/null \
|| die "pubblicazione non riuscita: la release $RELEASE_ID potrebbe essere rimasta in bozza"
echo "✔ Release $TAG pubblicata: ${FORGEJO_URL%/}/${FORGEJO_REPO}/releases/tag/$TAG"