npx deno.
Antes de empezar
- Deno en tu máquina, desde el instalador oficial de Deno, o el paquete de npm (
npm install deno). - 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
Si subes tu aplicación a través del dashboard, puedes omitir esta sección: el dashboard crea el archivo de configuración
squarecloud.app por ti.Referencia del archivo de configuración
El archivo
squarecloud.app le indica a Square Cloud cómo ejecutar tu aplicación: su archivo principal, la memoria, la versión del runtime, el nombre y, para un sitio web, su subdominio.deno a las dependencies de tu proyecto, para que el comando npx deno esté disponible en Square Cloud. No lo añadas a devDependencies: no se instalan en producción.
RUNTIME=nodejs e inicia tu app con Deno en el campo START, con los permisos que necesite. Un archivo de configuración completo para cada tipo de app:
- Bot o worker
- Sitio web o API
squarecloud.app
--allow-net, --allow-env, --allow-read y otros) a lo que use tu app. Si usas tareas definidas en deno.json, inicia con START=npx deno task start.
Qué ejecuta Square Cloud
STARTse 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 ejecutanpm install --no-audit --no-fundantes de iniciarla, lo que también instaladenoy cualquier módulo de npm listado enpackage.json. Los paquetes dedevDependenciesno se instalan, porque el runtime defineNODE_ENV=production. Cuandonode_modulesya existe, se omite el paso de instalación.
Puerto y host para sitios web y APIs
Deno.serve() escucha en el puerto 8000 por defecto y no lee la variable de entorno PORT. Pasa tú el puerto y el host: Square Cloud define PORT como 80, y 0.0.0.0 acepta conexiones desde fuera del contenedor.
main.ts
PORT requiere --allow-env, y servir requiere --allow-net, como en los ejemplos de START de arriba.
Preparar el proyecto
Archivos necesarios
squarecloud.app, en la raíz del ZIP.- Tu archivo de entrada, por ejemplo
main.ts. package.json, condenoendependencies. Una subida sin él falla conINVALID_DEPENDENCY.- Opcionalmente, un
deno.jsonodeno.jsoncpara tareas, imports y otros ajustes de Deno.
Qué dejar fuera
node_modules: Square Cloud elimina esta carpeta de tu subida e instala las dependencias desdepackage.jsonen el primer inicio.deno_diro.cache/deno: el directorio de caché de Deno, que Deno vuelve a llenar en el servidor.- Archivos de bloqueo: la CLI y la extensión de VS Code dejan fuera
package-lock.json,yarn.lockypnpm-lock.yamlpor defecto. Cuando necesites las versiones exactas de tupackage-lock.json, vuelve a incluirlo con!package-lock.jsonen tusquarecloud.ignore.
Solución de problemas
PermissionDenied: Requires net or env access
PermissionDenied: Requires net or env access
Deno bloquea el acceso a la red y al entorno a menos que lo permitas. Añade a tu comando
START el flag que indica el error, como --allow-net o --allow-env.Memoria insuficiente
Memoria insuficiente
La cantidad mínima de RAM requerida para alojar un bot es de 256MB y para
un sitio/API es de 512MB. Sin embargo, dependiendo del tamaño y la complejidad de
tu aplicación, puede ser recomendable asignar una mayor cantidad de RAM para
evitar que tu aplicación se quede sin memoria y se bloquee.
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.
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.
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
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
Aprende a crear el archivo de configuración
squarecloud.app que define el entorno de tu aplicación.1
Instala la CLI
Instala la CLI de Square Cloud. Si ya la tienes, ejecuta el mismo comando para actualizarla:
2
Inicia sesión
Ejecuta el comando de abajo. Abre tu navegador: aprueba el inicio de sesión allí y la CLI queda lista. No hay ninguna clave de API que copiar. Para scripts y CI, consulta autenticación de la CLI.
3
Sube tu proyecto
Desde la carpeta de tu proyecto, ejecuta el comando de abajo. La CLI comprime la carpeta actual en un zip, dejando fuera lo que lista Para subir un zip que creaste tú mismo, pásalo con
squarecloud.ignore, y lo sube:--file:4
Confirma que tu aplicación esté en vivo
Tu primer despliegue suele tardar menos de un minuto. Revisa el estado y los logs de tu aplicación directamente desde la terminal: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.
Próximos pasos
Variables de entorno
Mantén secretos y ajustes fuera de tu código y léelos en tiempo de ejecución.
Dominio personalizado
Sirve tu app en tu propio dominio, desde el plan Standard.
Solución de problemas
Arregla una app que no inicia o un sitio que no responde.

