Déployez votre site Astro sur Sevalla
Sevalla est une plateforme d’hébergement et de gestion tout-en-un pour les sites statiques, les applications et les bases de données.
Ce guide explique en détail comment déployer votre projet Astro sur Sevalla.
Prérequis
Section intitulée « Prérequis »- Un compte Sevalla.
- Votre projet Astro a été envoyé vers un dépôt Git public ou privé pris en charge (GitHub, GitLab ou Bitbucket).
Déploiement de site statique
Section intitulée « Déploiement de site statique »L’hébergement de sites statiques de Sevalla déploie votre site directement sur un réseau périphérique mondial.
-
Créez un nouveau Static Site (site statique) dans le tableau de bord Sevalla.
-
Connectez votre dépôt Git (GitHub, GitLab ou Bitbucket).
-
Sélectionnez votre dépôt et votre branche (par exemple,
main). -
Configurez les paramètres de compilation :
- Build command (commande de compilation) :
npm run build - Publish directory (dossier de publication) :
dist
- Build command (commande de compilation) :
-
Cliquez sur Create Static Site (créer un site statique) pour déployer.
Astro utilise par défaut la valeur output: 'static', aucune configuration supplémentaire n’est donc requise pour un déploiement statique.
Déploiement SSR
Section intitulée « Déploiement SSR »L’hébergement d’applications de Sevalla prend en charge les applications full-stack. Vous pouvez déployer des projets Astro en utilisant le rendu à la demande (rendu côté serveur) via l’adaptateur Node.js.
-
Ajoutez l’adaptateur
@astrojs/nodeà votre projet Astro.Fenêtre du terminal npx astro add node -
Configurez l’adaptateur dans
astro.config.mjs. Définissezmode: 'standalone'et assurez-vous quehost: trueest défini afin que le serveur écoute toutes les adresses (requis pour les environnements conteneurisés).astro.config.mjs import { defineConfig } from 'astro/config';import node from '@astrojs/node';export default defineConfig({output: 'server',adapter: node({mode: 'standalone'}),server: {host: true}}); -
Assurez-vous que votre fichier
package.jsoncontient un scriptstartqui exécute le serveur compilé :package.json "scripts": {"start": "node ./dist/server/entry.mjs"} -
Créez une nouvelle Application dans le tableau de bord Sevalla.
-
Connectez votre dépôt Git.
-
Configurez les paramètres de compilation :
- Build Method (méthode de compilation) : Sevalla détecte automatiquement les projets Node.js (via Nixpacks).
- Build command (commande de compilation) :
npm run build - Start command (commande de démarrage) :
npm run start
-
Cliquez sur Create Application (créer une application) pour déployer.
Dépannage
Section intitulée « Dépannage »Échecs de compilation
Section intitulée « Échecs de compilation »Consultez les Build Logs (journaux de compilation) dans le tableau de bord de Sevalla pour rechercher les messages d’erreur. Assurez-vous que toutes les dépendances se trouvent dans dependencies (et non dans devDependencies si nécessaire lors de l’exécution).
Version de Node
Section intitulée « Version de Node »Assurez-vous que la version de Node.js sélectionnée dans Sevalla correspond à votre version de développement locale (vérifiez avec node -v).