Saltar al contenido principal
Un runtime en Square Cloud es el entorno completo y aislado dentro del cual se ejecuta tu aplicación: el intérprete del lenguaje o la máquina virtual, las bibliotecas del sistema con las que se enlaza, las herramientas a las que puede recurrir y la frontera de seguridad que la mantiene separada de todas las demás aplicaciones del host. Nunca construyes ni mantienes ese entorno. Tú envías tu código fuente y un pequeño archivo de configuración; Square Cloud detecta el lenguaje, resuelve tus dependencias, aprovisiona un contenedor aislado y lo ejecuta. El mismo pipeline impulsa bots de Discord/WhatsApp/Telegram, sitios web y APIs, workers en segundo plano y servicios de larga duración, sobre la misma infraestructura rápida y reforzada.

Lenguajes soportados

JavaScript

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

Más allá de los lenguajes anteriores, la mayoría de los demás stacks y bibliotecas funcionan sin configuración adicional. Las imágenes de runtime están construidas para ser permisivas: si tu lenguaje se instala en Linux, es muy probable que funcione en Square Cloud.

Versiones

Cada runtime ofrece dos canales de actualización, seleccionables a través del campo VERSION en tu archivo de configuración:
  • recommended — la versión que reforzamos y ejecutamos en producción para la mayoría de las aplicaciones. Elígela a menos que tengas una razón específica para no hacerlo.
  • latest — la versión más reciente, para equipos que necesitan una característica del lenguaje recién publicada.
También puedes fijar una versión exacta para lograr reproducibilidad total entre deploys.
Lenguajerecommendedlatest
Node.js [JS & TS]24.15.026.1.0
Python3.13.133.14.5
JavaJDK 25JDK 25
Elixir1.19.51.19.5
Rust1.95.01.95.0
Ruby4.0.44.0.4
PHP8.5.68.5.6
Go1.26.31.26.3
.NET/C#10.0.810.0.8
Fijar recommended te da actualizaciones de parches automáticas y probadas sin cambios que rompan la compatibilidad de forma inesperada. Consulta la referencia del archivo de configuración para los campos RUNTIME y VERSION.

Cómo funciona un deploy

Desde la subida hasta un proceso en vivo, cada deploy pasa por el mismo pipeline determinista:

Detección de lenguaje

Square Cloud inspecciona los archivos de tu subida e identifica el stack a partir de las señales que ya existen en tu proyecto — un package.json para Node.js, un requirements.txt o pyproject.toml para Python, un go.mod para Go, un Gemfile para Ruby, y así sucesivamente. Puedes anular la detección explícitamente con el campo RUNTIME.

Resolución de dependencias

Tu manifiesto de dependencias se instala del lado del servidor, dentro del entorno de compilación. Nunca envías node_modules, un virtualenv ni artefactos compilados dentro del .zip — la plataforma los resuelve e instala por ti, manteniendo las subidas pequeñas y las compilaciones reproducibles.

Aprovisionamiento

Se crea un contenedor aislado con la CPU y la memoria declaradas en tu archivo de configuración. Los recursos se aplican a nivel del kernel, de modo que una aplicación nunca puede privar a otra en el mismo host.

Inicio

El campo MAIN apunta a tu archivo de entrada y la plataforma lo lanza con el intérprete correcto. ¿Necesitas un paso de compilación, un servidor estático o un comando personalizado? Define START y se ejecuta tal cual.

Dentro de cada imagen de runtime

Cada imagen se construye sobre una base común y auditada en seguridad, de modo que el entorno es consistente sin importar qué lenguaje despliegues:

Node.js 26 + herramientas de compilación

Cada imagen incluye Node.js 26 junto al lenguaje principal. Las herramientas de compilación, los pipelines de assets y las utilidades basadas en JS siempre están disponibles, sea cual sea tu stack.

ffmpeg y Chromium

El procesamiento de medios (ffmpeg) y un navegador headless (Chromium) vienen preinstalados — listos para bots de medios, web scraping y generación de PDF o capturas de pantalla sin configuración adicional.

Sin privilegios por defecto

Las aplicaciones se ejecutan como un usuario no root dentro de un contenedor aislado. Una dependencia comprometida permanece contenida — no tiene acceso privilegiado al host.

Sitios estáticos, sin runtime

¿No necesitas un intérprete? Define RUNTIME=static para servir un sitio HTML/CSS/JS simple directamente, con la misma CDN y TLS que cualquier otra aplicación.

Aislamiento y seguridad

Cada aplicación es un contenedor completamente aislado con límites de CPU y memoria aplicados por el kernel — nunca un proceso compartido. Ejecutarse sin privilegios significa que una aplicación no puede alcanzar el host ni a sus vecinas, y los topes de recursos garantizan que un pico en un proyecto no tenga ningún efecto sobre el rendimiento de otro. Este es el mismo modelo que permite a Square Cloud alojar decenas de miles de cargas de trabajo en clústeres compartidos sin que interfieran entre sí.

Próximos pasos

Archivo de configuración

Domina MAIN, START, RUNTIME, VERSION y MEMORY — los campos que controlan tu runtime.

Guías por lenguaje

Configuración paso a paso para Node.js, Python, Go, Rust, Java y más.