Saltar al contenido principal

​
🚀 Introducción

  • Antes de empezar, puedes optar por usar el runtime de Deno en tu proyecto. Si aún no tienes Deno instalado localmente, tienes dos opciones principales:
  • Instalar mediante npm (recomendado por compatibilidad con npx durante el deploy): 
npm install deno
  • O instalar Deno mediante el instalador oficial (consulta la documentación de Deno para las instrucciones de instalación nativa).
  • Al añadir deno como dependencia, puedes usar npx deno en el campo START de squarecloud.app para iniciar tu aplicación con Deno. Consulta más abajo, en la sección “Cómo iniciar tu aplicación”, ejemplos de START.
  • A continuación, tendrás que crear una cuenta en Square Cloud, lo cual puedes hacer a través de la página de inicio de sesión. Puedes usar tu correo electrónico, GitHub o ambos para crear la cuenta.
  • Por último, necesitas tener un plan de pago activo en tu cuenta. Puedes ver nuestros planes y adquirir uno según tus necesidades aquí.

​
⚙️ Configuración del archivo squarecloud.app

Si estás subiendo tu aplicación a través del sitio web de Square Cloud, puedes ignorar esta sección. El sitio crea automáticamente el archivo de configuración squarecloud.app por ti.

Más información: cómo crear el archivo de configuración para Square Cloud.

El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; servirá para definir el nombre, la descripción, la versión, el archivo principal, entre otras cosas.

​
▶️ Cómo iniciar tu aplicación

  • Para usar el runtime de Deno en el entorno Node.js de Square Cloud, primero añade el paquete deno a tu proyecto (por ejemplo, npm install deno) para que el comando npx deno esté disponible en el entorno de ejecución.
  • Luego, define el campo START en tu squarecloud.app con el comando que inicia tu aplicación usando Deno. Ejemplos:
OR .config
START=npx deno run --allow-net --allow-env main.ts
Si usas tareas definidas en deno.json, puedes iniciar así: 
START=npx deno task start
  • Ajusta los permisos (--allow-net, --allow-env, --allow-read, etc.) según las necesidades de tu aplicación.
  • Recuerda: si el campo START está definido, el valor que contenga se ejecutará directamente. Para más información sobre los parámetros del archivo de configuración, visita parámetros de configuración.
  • Si usas módulos npm con Deno y la carpeta node_modules no existe, Square Cloud ejecutará npm install --no-package-lock --no-audit --no-fund para instalar las dependencias y limpiar la carpeta .npm.
Si tienes la intención de usar Deno como runtime, recomendamos añadir deno como dependencia (npm install deno) para garantizar que npx deno esté disponible en el entorno de ejecución durante el deploy. En los proyectos en los que prefieras usar el instalador nativo de Deno, verifica la compatibilidad y los requisitos de tu build antes de optar por este enfoque.

​
🖥️ Preparando el proyecto

​
📁 Archivos de configuración esenciales

Al preparar tu proyecto Deno para el deploy en Square Cloud, asegúrate de incluir el archivo de configuración (squarecloud.app/.config) y los archivos esenciales de tu aplicación dentro de un archivo zip.
El archivo de configuración (squarecloud.app/.config) debe estar ubicado en la raíz del archivo zip. De lo contrario, Square Cloud no podrá encontrarlo durante el deploy.

​
🗑️ Archivos a excluir antes de subir

  • node_modules: Solo es necesario si usas módulos npm; de lo contrario, no lo subas para reducir el tamaño de subida.
  • package-lock.json: El entorno de producción instalará las dependencias basándose en package.json cuando se detecte el uso de npm.
  • deno_dir o .cache/deno: Directorio de caché de Deno; no es necesario para el deploy.

​
🤔 ¿Por qué excluir estos archivos?

Existen varias razones para excluir node_modules, package-lock.json y la caché de Deno antes de subir tu proyecto:
  1. Consistencia de la instalación: No subir node_modules garantiza que las dependencias sean instaladas por el entorno de producción, lo que resulta en un build consistente y libre de discrepancias del sistema local.
  2. Instalaciones actualizadas: El entorno de producción instalará las versiones compatibles más recientes de las dependencias listadas en package.json (cuando corresponda) o usará las importaciones remotas definidas en deno.json.
  3. Reducción del tamaño de subida: No incluir estos directorios reduce el tamaño del archivo subido, acelerando el proceso de subida y haciendo el deploy más eficiente.
Al hacer esto, garantizas que tu aplicación Deno esté preparada de forma óptima para el alojamiento en Square Cloud.

​
📄 Archivos requeridos

Se necesitan tres archivos para alojar tu proyecto Deno:
  • squarecloud.app/.config
  • mainFile.ts/.js (Ejemplo de archivo principal)
  • deno.json o deno.jsonc (definición de permisos y tareas). Si usas módulos npm, incluye también package.json.

​
💡 Solución de problemas

Este error ocurre cuando el archivo definido como “main” para tu aplicación en el archivo de configuración no existe, está mal escrito, o la ruta es incorrecta. Si tu archivo principal está dentro de una carpeta, por ejemplo, debes indicar folder/file.ts o folder/file.js.
La cantidad mínima de RAM requerida para alojar un bot es 256MB y para un sitio/API es 512MB. Sin embargo, dependiendo del tamaño y la complejidad de tu aplicación, puede ser aconsejable asignar una cantidad mayor de RAM para evitar que tu aplicación se quede sin memoria y se bloquee.

​
📤 Cómo alojar tu proyecto

Ahora que has preparado todos los archivos de tu proyecto Deno, el siguiente paso es subirlos a Square Cloud y poner tu aplicación en línea. Hay varias formas de subirlos, pero cubriremos dos: mediante el Dashboard o mediante la CLI.

​
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.
Subiendo aplicación a Square Cloud

​
A través de la CLI

Para usar este método, necesitas crear un archivo de configuración llamado squarecloud.app en el directorio raíz de tu proyecto. Este archivo contendrá la configuración necesaria para tu proyecto.

Aprende más sobre: cómo crear el archivo de configuración para Square Cloud.

El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; se utilizará para definir tu entorno.
1

Instala la CLI

Primero, necesitas tener la CLI instalada en tu entorno. Si aún no la tienes, ejecuta el siguiente comando en tu terminal:
npm install -g @squarecloud/cli
Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:
squarecloud update
2

Autentícate

Ahora, para autenticarte y usar otros comandos de la CLI, encontrarás tu clave de autorización aquí haciendo clic en “Request API Key”. Después de obtener tu clave de autorización, ejecuta el siguiente comando:
squarecloud auth login
3

Sube tu proyecto

Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando:
squarecloud upload
O si creaste el zip manualmente, puedes usar:
squarecloud upload --file <path/to/zip>

​
Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema.