Deploy automatico con GitHub Actions

Configurare una pipeline CI/CD non deve essere complicato. Ecco come automatizzare il deploy del tuo sito statico ad ogni push.

Perché automatizzare il deploy

Fare il deploy manuale è soggetto a errori e richiede tempo. Con una pipeline automatizzata:

• Ogni push su main genera una nuova versione del sito
• Il build viene testato prima del deploy
• Hai un log completo di ogni operazione
• Puoi aggiungere step di linting, test e validazione

Il workflow di base

Un workflow GitHub Actions per un sito VitePress si presenta così:

name: Deploy

on:
  push:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci
      - run: npm run docs:build

Questo è il minimo indispensabile. Da qui puoi aggiungere il deploy su Cloudflare Pages, Netlify, o qualsiasi altro hosting.

Best practices

• Usa npm ci invece di npm install per build riproducibili
• Blocca la versione di Node.js nel workflow
• Aggiungi un job di lint prima del build
• Usa i secrets di GitHub per le chiavi di deploy