Cómo alojar aplicaciones NestJS

Introducción

Para desarrollar y alojar 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 de pago 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

Para crear una aplicación NestJS, necesitas tener Node.js y npm instalados en tu sistema antes de seguir los pasos.

Instalación de la CLI

Para usar la interfaz de línea de comandos (CLI) de NestJS, necesitas instalarla globalmente en tu sistema. Ejecuta el siguiente comando:

npm install -g @nestjs/cli

Este comando instala el paquete @nestjs/cli globalmente en tu sistema, lo que te permite usar el comando nest desde cualquier lugar de tu terminal.

Desarrollar el proyecto

Para crear un nuevo proyecto NestJS, ejecuta el siguiente comando:

nest new my-app

En este comando, nest new my-app se utiliza para crear un nuevo proyecto NestJS. El comando nest new es una herramienta que viene con nest, la CLI (interfaz de línea de comandos) de NestJS. Se usa para inicializar una nueva aplicación NestJS. my-app es el nombre de la nueva aplicación. Este comando crea un nuevo directorio llamado my-app y configura los archivos y dependencias necesarios para una aplicación NestJS básica. Después de generar el proyecto NestJS con el comando nest new my-app, el archivo que necesitas modificar para cambiar el puerto es main.ts. Este archivo se encuentra en la raíz del directorio de tu proyecto, dentro de la carpeta src.

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(80); // Change the port number here to 80
}
bootstrap();

El puerto 80 es el puerto predeterminado para el tráfico HTTP.
Puedes iniciar tu servidor de desarrollo con el siguiente comando:

npm run start:dev

Compilar el proyecto

NestJS usa TypeScript, por lo que debes compilar tu código TypeScript a JavaScript antes de ejecutar tu aplicación. Puedes compilar tu aplicación ejecutando el siguiente comando:

npm run build

Este comando ejecuta el script build definido en tu archivo package.json, que a su vez ejecuta el comando nest build. Este comando compila tu código TypeScript a JavaScript.
Después de ejecutar este comando, los archivos JavaScript compilados estarán ubicados en el directorio dist de tu proyecto. Estos archivos son los que usarás para ejecutar tu aplicación en un entorno de producción.
El archivo principal para ejecutar tu aplicación será dist/main.js.

Deploy

Después de preparar los archivos de tu proyecto, ya puedes subirlos a Square Cloud y alojar tu proyecto. Para ello, crea un archivo ZIP que contenga todos los archivos de tu proyecto.

A través del panel

Accede a la página de subida

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

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.

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.

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

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.

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.

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:

Windows
Linux, macOS y WSL

squarecloud update

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

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

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>

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:

squarecloud app status
squarecloud app logs

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.

Solución de problemas

Dominio personalizado

Para usar un dominio personalizado (por ejemplo, mysite.com) en lugar de la URL predeterminada mysite.squareweb.app, necesitas el plan Standard o superior. El subdominio se define mediante el campo SUBDOMAIN en el archivo de configuración.

Requisitos mínimos de RAM

Mínimo: 512MB de RAM para sitios web/APIs sencillos. Para sitios con frameworks (Next.JS, React, Vue, Angular, etc.), siempre recomendamos al menos 1GB de RAM. Para aplicaciones más grandes, asigna más RAM para evitar que la aplicación se quede sin memoria y falle.

No se pudo encontrar este sitio.

Verifica que el subdominio/dominio coincida con lo configurado en el campo SUBDOMAIN o en la configuración del dominio personalizado. Si acabas de subir el sitio, espera hasta 60 segundos para que Square habilite el primer acceso.

El sitio tardó demasiado en responder…

Verifica que hayas configurado correctamente el puerto 80 y el host 0.0.0.0 en la aplicación. Recomendamos usar las variables de entorno forzadas de Square: PORT y HOST del archivo .env.

Recursos adicionales

Para más información sobre NestJS y sus herramientas, visita la documentación oficial de NestJS. Allí encontrarás guías detalladas, tutoriales y documentación de API para ayudarte a aprovechar al máximo NestJS.

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 — la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot.

Tutoriales

Bots

Proyectos listos

Bases de datos

APIs

Sitios web

Guías de migración

Cómo alojar aplicaciones NestJS

Introducción

Requisitos previos

Crear el proyecto

Instalación de la CLI

Desarrollar el proyecto

Compilar el proyecto

Deploy

A través del panel

A través de la CLI

Guía del archivo de configuración

Solución de problemas

Dominio personalizado

Requisitos mínimos de RAM

No se pudo encontrar este sitio.

El sitio tardó demasiado en responder…

Recursos adicionales

Contáctanos

​Introducción

​Requisitos previos

​Crear el proyecto

​Instalación de la CLI

​Desarrollar el proyecto

​Compilar el proyecto

​Deploy

​A través del panel

​A través de la CLI

Guía del archivo de configuración

​Solución de problemas

​Dominio personalizado

​Requisitos mínimos de RAM

​No se pudo encontrar este sitio.

​El sitio tardó demasiado en responder…

​Recursos adicionales

​Contáctanos

Introducción

Requisitos previos

Crear el proyecto

Instalación de la CLI

Desarrollar el proyecto

Compilar el proyecto

Deploy

A través del panel

A través de la CLI

Solución de problemas

Dominio personalizado

Requisitos mínimos de RAM

No se pudo encontrar este sitio.

El sitio tardó demasiado en responder…

Recursos adicionales

Contáctanos