Skip to main content

​
🚀 Introducción

  • Antes de empezar, asegúrate de que Ruby esté instalado en tu sistema. Si aún no lo tienes, puedes descargarlo desde el sitio web oficial de Ruby, o usar gestores de versiones como rbenv o rvm.
  • A continuación, deberás 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.

​
📄 Archivos requeridos

  • main.rb (Ejemplo de archivo principal — tu punto de entrada de Ruby).
  • Gemfile (Archivo de dependencias, si usas Bundler).
  • Gemfile.lock (Generado por Bundler; se recomienda incluirlo para builds reproducibles).
  • squarecloud.app (archivo que contiene la configuración de Square Cloud).

​
▶️ Cómo iniciar tu aplicación

  • Si el campo START no está definido en el archivo de configuración, Square Cloud ejecutará ruby MAIN, donde el archivo especificado en MAIN es el archivo Ruby (por ejemplo, main.rb). Si el campo START está definido, se ejecutará directamente el valor que contenga. En aplicaciones que usan Bundler, es común definir START como bundle exec ruby main.rb u otro comando de inicio adecuado. Para más información sobre los parámetros del archivo de configuración, visita parámetros de configuración.
Para aplicaciones Ruby que usan Bundler, es importante configurar correctamente las variables de entorno para optimizar el proceso de instalación de dependencias en Square Cloud. Square Cloud ejecuta la instalación de bundler usando variables de entorno. Para excluir grupos de gems innecesarios en producción, configura la variable BUNDLE_WITHOUT=development:test. Esto también ayuda a eliminar las deprecations de Bundler 2.x.

​
🖥️ Preparando el proyecto

Antes de alojar tu proyecto en Square Cloud, verifica que los archivos del proyecto estén correctamente configurados para el alojamiento.
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.

​
📤 Cómo alojar tu proyecto

Ahora que has preparado todos los archivos para tu proyecto Ruby, el siguiente paso es subirlos a Square Cloud y poner tu aplicación en línea. Hay varias formas de subir, pero cubriremos dos: a través del Dashboard o a través de 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
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

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.
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:
Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:
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:
3

Sube tu proyecto

Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando:
O si creaste el zip manualmente, puedes usar:
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.
¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​
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.