Introducción
Para desarrollar y alojar una aplicación Gatsby en Square Cloud, es esencial seguir una secuencia estructurada de configuraciones y requisitos previos. Esta guía técnica cubrirá todo el proceso, desde la configuración inicial hasta el despliegue en producción.Requisitos previos
- Cuenta de Square Cloud: Regístrate a través de la página de registro usando tu correo electrónico.
- Plan activo: Garantiza recursos dedicados y un rendimiento optimizado para tu aplicación. Consulta nuestros planes disponibles y elige el más adecuado para tus necesidades.
Crear el proyecto
Necesitas Node.js y npm en tu máquina. Si no los tienes, descárgalos desde el sitio oficial de Node.js. Crea un proyecto con el inicializador oficial:npm run develop (escucha en http://localhost:8000). Las páginas están en src/pages/: edita src/pages/index.js (o index.tsx) para cambiar la página de inicio.
Compilar para producción
public/, un archivo HTML por página.
Elegir cómo servirlo
Un build de Gatsby es un sitio estático: archivos HTML, CSS y JavaScript que cualquier servidor web puede entregar. Elige una de estas opciones:- Runtime estático (recomendado)
- Servidor Express
- Paquete serve
Compila el sitio
npm run build. La salida va a la carpeta public.Mantén funcionando las rutas del cliente
public/index.html a vite.html. El runtime estático responde con vite.html a toda ruta que no sea un archivo, así que recargar una ruta como /about sigue cargando tu app. Un sitio con un archivo HTML por página conserva index.html: las rutas desconocidas devuelven entonces tu 404.html. Consulta cómo sirve los archivos el runtime estático.Añade el archivo de configuración
squarecloud.app dentro de public. Un MAIN que apunta a un archivo HTML selecciona el runtime estático:MAIN=index.html si conservaste index.html. 512 MB es la memoria mínima para un sitio web. Cuando subes por el dashboard, te pide estos valores y escribe el archivo por ti.Comprime la salida del build
public, no la carpeta en sí, para que squarecloud.app quede en la raíz del ZIP. Con la CLI, ejecuta squarecloud upload desde dentro de public.index.html (sin renombrarlo a vite.html): tu página src/pages/404.js se convierte en el 404.html que responde a las rutas desconocidas. Para conservar squarecloud.app entre builds, ponlo en la carpeta static/: Gatsby copia esa carpeta sin cambios en public/.
getServerData), Deferred Static Generation o Gatsby Functions necesitan un servidor de Gatsby y no se cubren aquí.Hacer deploy y verificar
Crea el ZIP descrito en la opción que elegiste y súbelo:A través del panel
Accede a la página de subida
Configura tu entorno
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.
Despliega tu proyecto
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

Confirma que tu aplicación esté en vivo
Si desplegaste un sitio web o una API, abre
https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.
A través de la CLI
Para usar este método, tu proyecto necesita un archivo de configuración llamadosquarecloud.app en su raíz. Le indica a Square Cloud cómo ejecutar tu aplicación.
Guía del archivo de configuración
squarecloud.app que define el entorno de tu aplicación.Instala la CLI
Inicia sesión
Sube tu proyecto
squarecloud.ignore, y lo sube:--file:Confirma que tu aplicación esté en vivo
https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.
Errores comunes
Dominio personalizado
mysite.com) en lugar de la URL predeterminada mysite.squareweb.app, necesitas el plan Standard o superior. La URL predeterminada sale del campo SUBDOMAIN del archivo de configuración. Para conectar tu dominio, sigue cómo configurar tu propio dominio.Requisitos mínimos de RAM
No se pudo encontrar este sitio.
El sitio tardó demasiado en responder…
80) y HOST (0.0.0.0) en tu aplicación: léelas en tu código en lugar de fijar otros valores. Un servidor que escucha solo en localhost o 127.0.0.1 nunca recibe solicitudes.
