# ============================================================================= # DEPLOY AUTOMATICO (DISATTIVATO) — esempio per Gitea Actions. # # Per attivarlo: copiare questo file in .gitea/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). I nomi dei # segreti non possono iniziare con GITEA_ o GITHUB_. # Istruzioni complete in docs/DEPLOY.md, sezione «Deploy automatico». # # Pubblica il contenuto dello zip della release, sito-studio-grasso-vX.Y.Z.zip: l'unico file # allegato da release.yml (i due archivi «Source code» che Gitea aggiunge da solo sono il # codice sorgente, non il sito). Dopo il download ne controlla l'integrità (unzip -t) e la # presenza di index.html e .htaccess. # # 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). # - Evento: per «release» Gitea supporta i tipi published (release non in bozza creata) ed # edited (release modificata); una bozza non genera alcun evento. release.yml e # scripts/release-upload.sh creano la release in bozza, caricano lo zip e solo allora la # pubblicano: Gitea notifica questo passaggio come modifica, non come «published». Per questo # si ascoltano entrambi i tipi, e il job «controllo» procede solo per una release stabile che # sia l'ultima pubblicata e, per le modifiche, solo se lo zip è stato caricato 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: Gitea non avvia workflow in risposta a ciò che fa il token automatico di un altro # workflow (per evitare cicli). L'avvio automatico funziona quindi solo se release.yml # pubblica la release con un token personale (segreto RELEASE_TOKEN). Senza il segreto, # avviarlo a mano dalla scheda Actions del repository. # - File: per gli eventi di release Gitea legge il workflow dal commit del tag, quindi questo # file deve già essere nel commit su cui è messo il tag. Per una release uscita prima di # aggiungerlo, usare l'avvio manuale. # I file gestiti dall'hosting (.well-known/, .user.ini, cgi-bin/) sono esclusi dalla # sincronizzazione, quindi non vengono cancellati. # RUNNER: `runs-on: ubuntu-latest`, il label predefinito di act_runner, come negli altri # workflow: sostituirlo se il runner ne usa un altro. # ============================================================================= name: Deploy on: release: types: [published, edited] workflow_dispatch: inputs: tag: description: 'Tag della release da pubblicare (es. v1.0.1)' required: true jobs: controllo: name: Release da pubblicare runs-on: ubuntu-latest # label del runner: adattare se diverso 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: ${{ github.event.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 # il tag finisce in un indirizzo di download: solo vX.Y.Z (o vX.Y.Z-suffisso) printf '%s' "$TAG_MANUALE" | grep -Eq '^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.]+)?$' \ || { echo "tag non valido: $TAG_MANUALE (atteso vX.Y.Z)" >&2; exit 1; } 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 # modifica anziché prima pubblicazione: si procede solo se lo zip è appena stato # caricato, 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: ubuntu-latest # label del runner: adattare se diverso container: image: debian:stable-slim 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 e controlla lo zip della release env: TAG: ${{ needs.controllo.outputs.tag }} TOKEN: ${{ secrets.GITHUB_TOKEN }} # token automatico del workflow run: | set -eu VERSION="${TAG#v}" curl -fsSL -H "Authorization: token ${TOKEN}" -o pacchetto.zip \ "${{ github.server_url }}/${{ github.repository }}/releases/download/${TAG}/sito-studio-grasso-v${VERSION}.zip" unzip -tq pacchetto.zip # integrità: si ferma se lo zip è danneggiato o incompleto mkdir sito && unzip -q pacchetto.zip -d sito for f in index.html .htaccess; do [ -f "sito/$f" ] || { echo "manca $f nel pacchetto: non è lo zip del sito" >&2; exit 1; } done # --------------------------------------------------------------------------- # 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-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: la riga «Sitemap:» del robots.txt # (scritto in build da src/pages/robots.txt.ts), se la variabile del repository SITE_URL # non è impostata if [ -z "$SITE_URL" ]; then SITE_URL="$(tr -d '\r' < sito/robots.txt | sed -n 's|^Sitemap: \(.*\)/sitemap-index\.xml$|\1|p' | head -n 1)" fi SITE_URL="${SITE_URL%/}" : "${SITE_URL:?dominio del sito non trovato (riga Sitemap: di robots.txt nel pacchetto)}" 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 ]