Come installare Astro su Saplo (sito veloce con islands)

Astro genera una pagina completamente statica per impostazione predefinita - zero byte di JavaScript all'avvio - e ti permette di inserire singoli componenti interattivi (islands) da React, Vue o Svelte esattamente dove l'interazione è realmente necessaria. Il resto della pagina rimane puro HTML. Il risultato sono siti di contenuti e blog che si caricano istantaneamente anche con una connessione debole, senza compromettere la pagina intera con un pesante bundle del framework. Su Saplo, puoi installare Astro come qualsiasi altra applicazione a costruzione statica: il motore costruisce il progetto ed espone la directory dist pronta sotto nginx.

Per chi è Astro su Saplo

Prima di iniziare l'installazione, verifica se è la scelta giusta per il tuo progetto:

• blog o sito di contenuti che deve essere veloce - zero JavaScript superfluo all'inizio, il contenuto si carica istantaneamente,
• documentazione del prodotto - le raccolte di contenuti in Markdown e la build statica sono perfette per questo,
• portfolio o landing con un po' di interazione - un modulo di contatto o una galleria come singola isola React o Vue, senza idratazione dell'intera pagina,
• sito che oggi è su WordPress solo perché qualcuno aveva bisogno di modificare il contenuto - se la modifica avviene tramite file Markdown nel repository, Astro offre la stessa comodità senza un motore PHP e un database in background.

Se il sito deve essere completamente dinamico (dati diversi per ogni query, login degli utenti), controlla lo stack Node.js nel catalogo delle applicazioni invece di Astro statico.

Requisiti

Per creare un sito Astro su Saplo, ti servirà:

• Un Box di qualsiasi piano. Un Box S è sufficiente per iniziare, in quanto il risultato è una build statica senza un processo mantenuto in memoria.
• Un minimo di 512 MB di RAM libera per il processo di build (Astro ha una toolchain di build più pesante rispetto a Vite puro) e 3 GB di spazio su disco.
• Un dominio o sottodominio *.saploapp.pl incluso nel prezzo di ogni piano.
• Un repository Git, se desideri implementazioni automatiche (opzionale per iniziare, puoi anche caricare l'applicazione come archivio .zip tramite il pannello).

Installazione passo dopo passo

1. Nel Pannello Saplo, vai su Catalogo delle applicazioni e seleziona Astro (categoria "Siti").
2. Scegli il tuo Box e il nome dell'applicazione - da questo verrà creato il sottodominio predefinito <name>.saploapp.pl.
3. Seleziona la versione di Node.js per il build (18, 20 o 22, predefinito 20) e conferma l'installazione.
4. Il motore dello scaffold crea uno scheletro minimo di Astro, installa le dipendenze e costruisce il progetto, e il contenuto della directory dist viene inserito direttamente nella directory dell'applicazione, servita da nginx.
5. Al termine dell'installazione, il dominio del passo 2 mostra la pagina iniziale di Astro - da questo momento puoi distribuire il tuo contenuto su di essa.

Deploy del tuo codice tramite Git

1. Nei dettagli dell'applicazione, trova la sezione Git / CI-CD e clicca su "Connetti GitHub", conferma l'installazione dell'applicazione "Saplo Deploy" e indica il repository con il progetto Astro.
2. Nella directory principale del repository, deve trovarsi il file saplo.yaml.
3. Effettua il commit e il push del file saplo.yaml sul branch di produzione (di default main).
4. Ogni successivo git push su questo branch costruisce il progetto e sostituisce il contenuto della directory dist sul Box, lo stato lo vedi nella scheda Deploy.
5. Di default, Astro genera la statica in dist/ - nginx la serve direttamente, senza alcun processo in background sul server.

Esempio di un file saplo.yaml minimale per Astro:

name: my-project
stack: astro
build:
  install: npm ci
  command: npm run build
  output: dist

Astro su Saplo vs. alternative

Domande frequenti

Posso scrivere contenuti in Markdown? Sì, le content collections in Astro memorizzano il contenuto come file Markdown nel repository, convalidati al momento della build.

Astro ha bisogno di un processo in background? Non in modalità predefinita: l'output è completamente statico e servito direttamente da nginx, senza consumo di RAM dopo il completamento della build.

Quando scegliere SSR (adapter node) invece di una versione statica? Quando il sito deve restituire dati diversi per ogni richiesta (es. pannello utente) - in tal caso, nella sezione Catalogo delle applicazioni scegli lo stack Node.js e configura start.command.

Posso mescolare islands di diversi framework su una singola pagina? Sì, Astro consente di combinare componenti React, Vue e Svelte sulla stessa pagina, ognuno idratato in modo indipendente.

Avrò SSL e il mio dominio? Sì, il certificato SSL è automatico, e un Dominio o sottodominio *.saploapp.pl è incluso nel prezzo di ogni piano.

Puoi configurare Astro su Saplo da zero a un Dominio funzionante in pochi minuti, e aggiornare i contenuti tramite git push senza toccare il pannello di amministrazione o il database. Se il progetto cresce fino a richiedere un SSR completo, troverai lo stack Node.js nella stessa directory.