Files
Alby96andClaude Sonnet 5.5 31ac5b7f68
CI / Verifica (lint, build, test, Lighthouse, pacchetto) (push) Canceled after 40m56s
CI / Link esterni (non bloccante) (push) Canceled after 0s
ci: Gitea Actions, release con il solo zip del sito e documentazione senza Forgejo
Il progetto vive in modo definitivo su Gitea: i workflow passano da .forgejo/ a
.gitea/workflows/ e la documentazione non nomina più la piattaforma precedente.

- ci.yml: i controlli di npm run verify sono passi separati (si vede subito quale è
  fallito) e alla fine la CI crea lo zip di rilascio e ne verifica il contenuto, così un
  errore di pacchetto emerge prima del tag. Runner ubuntu-latest, azioni da github.com con
  URL completo, upload-artifact@v3 (la v4 non funziona su Gitea).
- release.yml: a ogni tag vX.Y.Z verifica tutto, crea lo zip e lo pubblica nella Release
  con scripts/release-upload.sh e l'API di Gitea, senza action esterne di release.
- La release contiene un solo file, sito-studio-grasso-vX.Y.Z.zip (contenuto di dist/ alla
  radice, .htaccess compreso): tolti tar.gz, SHA256SUMS.txt e BUILD-INFO.txt da
  package.mjs, check-package.mjs e dalla documentazione.
- release-upload.sh: variabili GITEA_*, si ferma su errori diversi da 404 invece di
  provare a creare la release, rifiuta una cartella vuota; provato su una finta API Gitea.
- deploy/gitea-deploy.yml.example convertito per Gitea (resta disattivato).
- Versione 1.0.1 pronta (package.json, CHANGELOG, D-056 e D-057 in DECISIONS.md); il tag
  v1.0.1 non è stato creato.

Verifica: npm run verify completo (lint, formato, tipi, build, HTML, link, e2e 39,
a11y 51, conformità 1455, Lighthouse) e npm run package eseguiti in una copia fuori da
.claude/. I workflow non sono ancora stati eseguiti su un runner Gitea.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-22 11:15:08 +02:00

120 lines
6.5 KiB
Bash
Executable File

#!/usr/bin/env bash
# =============================================================================
# Pubblica una release su Gitea tramite API REST e carica i file di release/ (lo zip del sito).
# Lo usa release.yml; si può eseguire anche a mano.
#
# Uso:
# GITEA_URL=https://gitea.encke-hake.ts.net \
# GITEA_REPO=proprietario/repository \
# GITEA_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.
#
# Una release nuova viene creata in bozza, riceve i file e solo alla fine viene pubblicata.
# Se la release esiste già (anche come bozza rimasta a metà), 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 "${GITEA_URL:-}" ] || die "variabile GITEA_URL mancante (es. https://gitea.encke-hake.ts.net)"
[ -n "${GITEA_REPO:-}" ] || die "variabile GITEA_REPO mancante (es. proprietario/repository)"
[ -n "${GITEA_TOKEN:-}" ] || die "variabile GITEA_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"
# nessun file da caricare = pacchetto non creato: meglio fermarsi che pubblicare una release vuota
FILES=()
for FILE in "$DIR"/*; do
[ -f "$FILE" ] && FILES+=("$FILE")
done
[ "${#FILES[@]}" -gt 0 ] || die "nessun file in $DIR: eseguire prima npm run package"
API="${GITEA_URL%/}/api/v1/repos/${GITEA_REPO}"
AUTH="Authorization: token ${GITEA_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 "$(dirname "${BASH_SOURCE[0]}")/changelog-notes.mjs" "$TAG")" \
|| die "note della release non disponibili: manca la sezione di $TAG in CHANGELOG.md"
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 $GITEA_REPO"
# 1) il tag deve essere già sul server: senza, Gitea lo creerebbe sulla punta del branch
# predefinito (un altro commit)
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: solo un 404 vuol dire «non
# esiste ancora»; qualunque altro errore (rete, 401, 403, 5xx) ferma lo script
EXISTING_FILE="$(mktemp)"
trap 'rm -f "$EXISTING_FILE"' EXIT
EXISTING_CODE="$(curl -sS -o "$EXISTING_FILE" -w '%{http_code}' -H "$AUTH" "$API/releases/tags/$TAG_URL")" \
|| die "il server non risponde ($GITEA_URL)"
if [ "$EXISTING_CODE" = "200" ]; then
EXISTING="$(cat "$EXISTING_FILE")"
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
elif [ "$EXISTING_CODE" = "404" ]; then
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)"
else
die "lettura della release $TAG non riuscita (HTTP $EXISTING_CODE): controllare l'indirizzo, il token e riprovare"
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 "${FILES[@]}"; do
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: ${GITEA_URL%/}/${GITEA_REPO}/releases/tag/$TAG"