# ============================================================================= # 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-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 ]