Haz deploy de una app o bot con Bun

​

Antes de empezar

• Bun en tu máquina, desde el instalador oficial de Bun, o el paquete de npm (npm install bun).
• Una cuenta de Square Cloud: regístrate con tu email o GitHub.
• Un plan activo. Consulta los planes y elige el que se ajuste a tu proyecto.

​

Configurar Square Cloud

npm install bun

RUNTIME=nodejs
START=npx bun index.ts
MEMORY=256
VERSION=recommended
DISPLAY_NAME=My bot

RUNTIME=nodejs
START=npx bun index.ts
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My website
SUBDOMAIN=mywebsite

​

Qué ejecuta Square Cloud

• START se ejecuta directamente. Para obtener más información sobre los parámetros del archivo de configuración, visita parámetros de configuración.
• Si la app no tiene una carpeta node_modules, Square Cloud ejecuta npm install --no-audit --no-fund antes de iniciarla, lo que también instala bun. Los paquetes de devDependencies no se instalan, porque el runtime define NODE_ENV=production. Cuando node_modules ya existe, se omite el paso de instalación.

​

Puerto y host para sitios web y APIs

Bun.serve({
  fetch() {
    return new Response("Hello, World!");
  },
});

​

Preparar el proyecto

​

Archivos necesarios

• squarecloud.app, en la raíz del ZIP.
• Tu archivo de entrada, por ejemplo index.ts.
• package.json, con bun en dependencies. Una subida sin él falla con INVALID_DEPENDENCY.

​

Qué dejar fuera

• node_modules: Square Cloud elimina esta carpeta de tu subida e instala las dependencias desde package.json en el primer inicio.
• Archivos de bloqueo: las dependencias se instalan con npm, así que bun.lock no se usa. La CLI y la extensión de VS Code también dejan fuera package-lock.json, yarn.lock y pnpm-lock.yaml por defecto; cuando necesites las versiones exactas de tu package-lock.json, vuelve a incluirlo con !package-lock.json en tu squarecloud.ignore.

​

Solución de problemas

​

Hacer deploy

​

A través del panel

1

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.

2

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.

3

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
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.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​

A través de la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Próximos pasos

​

Contáctanos