Despliega tu sitio de Astro en Sevalla
Sevalla es una plataforma de alojamiento y gestión todo en uno para sitios estáticos, aplicaciones y bases de datos.
Esta guía detalla cómo desplegar tu proyecto de Astro en Sevalla.
Requisitos previos
Sección titulada “Requisitos previos”- A Cuenta de Sevalla.
- Tu proyecto de Astro subido a un repositorio Git público o privado compatible (GitHub, GitLab o Bitbucket).
Despliegue de sitio estático
Sección titulada “Despliegue de sitio estático”El alojamiento de sitios estáticos de Sevalla despliega tu sitio directamente a una red perimetral (edge) global.
-
Crea un nuevo Sitio estático en el panel de Sevalla.
-
Conecta tu repositorio Git (GitHub, GitLab o Bitbucket).
-
Selecciona tu repositorio y rama (por ejemplo,
main). -
Configura los ajustes de construcción:
- Build command:
npm run build - Publish directory:
dist
- Build command:
-
Haz clic en Create Static Site para desplegar.
Astro usa por defecto output: 'static', por lo que no se requiere configuración adicional para el despliegue estático.
Despliegue de SSR
Sección titulada “Despliegue de SSR”El alojamiento de aplicaciones de Sevalla es compatible con aplicaciones full-stack. Puedes desplegar proyectos de Astro usando renderizado bajo demanda (renderizado en el lado del servidor) a través del adaptador de Node.js.
-
Añade el adaptador
@astrojs/nodea tu proyecto de Astro.Ventana de la terminal npx astro add node -
Configura el adaptador en
astro.config.mjs. Establecemode: 'standalone'y asegúrate de configurarhost: truepara que el servidor escuche en todas las direcciones (requerido para entornos en contenedores).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}}); -
Asegúrate de que tu
package.jsontenga un scriptstartque ejecute el servidor construido:package.json "scripts": {"start": "node ./dist/server/entry.mjs"} -
Crea una nueva Aplicación en el panel de Sevalla.
-
Conecta tu repositorio Git.
-
Configura los ajustes de construcción:
- Método de construcción: Sevalla detecta automáticamente proyectos de Node.js (a través de Nixpacks).
- Build command:
npm run build - Start command:
npm run start
-
Haz clic en Create Application para desplegar.
Resolución de problemas
Sección titulada “Resolución de problemas”Fallos de construcción
Sección titulada “Fallos de construcción”Revisa los Registros de construcción en el panel de Sevalla para ver los mensajes de error. Asegúrate de que todas las dependencias estén en dependencies (no en devDependencies si son necesarias en tiempo de ejecución).
Versión de Node
Sección titulada “Versión de Node”Asegúrate de que la versión de Node.js seleccionada en Sevalla coincida con tu versión de desarrollo local (compruébalo con node -v).