Comment installer Astro sur Saplo (site rapide avec islands)

Par défaut, Astro génère un site entièrement statique - zéro octet de JavaScript au démarrage - et te permet d'insérer des composants interactifs individuels (islands) de React, Vue ou Svelte exactement là où l'interactivité est réellement nécessaire. Le reste du site reste en HTML pur. Le résultat ? Des pages de contenu et des blogs qui se chargent instantanément, même avec une connexion faible, sans le compromis d'un lourd bundle de framework pour l'ensemble du site. Sur Saplo, tu installes Astro comme toute autre application statique - le moteur construit le projet et expose le répertoire prêt à l'emploi dist sous nginx.

À qui s'adresse Astro sur Saplo

Avant de commencer l'installation, vérifie si c'est le bon choix pour ton projet :

• un blog ou un site de contenu qui doit être rapide - zéro JavaScript superflu au départ, le contenu se charge instantanément,
• documentation produit - les collections de contenu en Markdown et la construction statique sont parfaites pour cela,
• portfolio ou page de destination avec un peu d'interaction - un formulaire de contact ou une galerie comme îlot unique de React ou Vue, sans hydratation de toute la page,
• un site qui est aujourd'hui sur WordPress simplement parce que quelqu'un avait besoin d'éditer le contenu - si l'édition se fait via des fichiers Markdown dans le dépôt, Astro offre la même commodité sans moteur PHP ni base de données en arrière-plan.

Si le site doit être entièrement dynamique (données différentes pour chaque requête, connexion des utilisateurs), consulte le catalogue d'applications pour la pile Node.js au lieu d'Astro statique.

Exigences

Pour installer Astro sur Saplo, tu as besoin :

• D'un Box dans n'importe quel plan, le Box S est suffisant pour commencer - le résultat est un build statique sans processus maintenu en mémoire,
• D'un minimum de 512 Mo de RAM libre pour le processus de build lui-même (Astro a une chaîne d'outils de build plus lourde que Vite pur) et de 3 Go d'espace disque,
• D'un domaine ou sous-domaine *.saploapp.pl inclus dans le prix de chaque plan,
• D'un dépôt Git, si tu souhaites des déploiements automatiques (optionnel pour commencer, tu peux aussi télécharger l'application via une archive .zip via le Panneau).

Installation étape par étape

1. Dans le Panneau Saplo, va dans le Catalogue d'applications et choisis Astro (catégorie "Sites").
2. Indique la Box et le nom de l'application - cela créera le sous-domaine par défaut <name>.saploapp.pl.
3. Choisis la version de Node.js pour la build (18, 20 ou 22, par défaut 20) et confirme l'installation.
4. Le moteur scaffoldera un squelette Astro minimal, installera les dépendances et construira le projet, et le contenu du répertoire dist ira directement dans le répertoire de l'application, servi par nginx.
5. Une fois l'installation terminée, le Domaine de l'étape 2 affichera la page de démarrage d'Astro - à partir de ce moment, tu peux y déployer ton propre contenu.

Déploiement de votre propre code via Git

1. Dans les détails de l'application, trouve la section Git / CI-CD et clique sur "Connecter GitHub", confirme l'installation de l'application "Saplo Deploy" et indique le dépôt de ton projet Astro.
2. Le fichier saplo.yaml doit se trouver dans le répertoire racine du dépôt.
3. Valide et pousse le fichier saplo.yaml vers la branche de production (par défaut main).
4. Chaque git push suivant vers cette branche construit le projet et remplace le contenu du répertoire dist sur la Box. Tu peux consulter le statut dans l'onglet Déploiements.
5. Par défaut, Astro génère des fichiers statiques vers dist/ - Nginx les sert directement, sans aucun processus en arrière-plan sur le serveur.

Exemple de fichier minimal saplo.yaml pour Astro :

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

Astro sur Saplo vs. les alternatives

Questions fréquentes

Puis-je écrire du contenu en Markdown ? Oui, les content collections d'Astro stockent le contenu sous forme de fichiers Markdown dans le dépôt, validés lors du build.

Astro a-t-il besoin d'un processus en arrière-plan ? Non, pas en mode par défaut. Le résultat est entièrement statique et servi directement par nginx, sans consommation de RAM après la fin du build.

Quand choisir le SSR (adaptateur Node) plutôt que le statique ? Quand la page doit retourner des données différentes pour chaque requête (par exemple, un panneau utilisateur), choisis la pile Node.js dans le Catalogue d'applications et configure start.command.

Puis-je mélanger des islands de différents frameworks sur une même page ? Oui, Astro permet de combiner des composants React, Vue et Svelte sur la même page, chacun étant hydraté indépendamment.

Vais-je obtenir un certificat SSL et mon propre Domaine ? Oui, le certificat SSL est automatique, et le Domaine ou sous-domaine *.saploapp.pl est inclus dans le Prix de chaque plan.

Tu peux déployer Astro sur Saplo de zéro à un Domaine fonctionnel en quelques minutes, et mettre à jour le contenu via git push sans toucher au panneau d'administration ni à la base de données. Si le projet grandit jusqu'à nécessiter un SSR complet, tu trouveras la pile Node.js dans le même répertoire.