Cómo alojar aplicaciones Spring en Square Cloud

Spring Boot facilitó la vida de los desarrolladores Java al integrar el servidor (como Tomcat) directamente en el archivo de ejecución. Para ejecutar tu aplicación en Square Cloud, el foco debe estar en la configuración de red y en la generación del artefacto correcto.

1. Configurando el puerto (Puerto 80)

A diferencia del entorno local, donde generalmente usamos el puerto 8080, Square Cloud exige que tu aplicación escuche en el puerto 80.

Puedes configurarlo de dos formas:

Vía archivo de propiedades:

En tu archivo src/main/resources/application.properties:

server.port=80

O, si prefieres YAML (application.yml):

server:
  port: 80

Vía variables de entorno (Recomendado):

También puedes dejar el puerto por defecto en el código y definir una ENV en el dashboard de Square Cloud:

• Nombre: SERVER_PORT
• Valor: 80

2. Empaquetando la aplicación (JAR)

Square Cloud ejecuta aplicaciones Java a partir de un artefacto que reúne tu código y todas las dependencias necesarias dentro de un único archivo.

Usando Maven:

Ejecuta el comando en la raíz del proyecto:

./mvnw clean package

Usando Gradle:

Ejecuta el comando en la raíz del proyecto:

./gradlew build

El archivo generado estará en la carpeta target/ (Maven) o build/libs/ (Gradle).

3. Preparando el deploy

Para el envío, recomendamos crear un archivo .zip que contenga:

1. Tu archivo .jar (ej.: mi-api-1.0.0.jar).
2. Archivos de configuración externos (si los hay).

Nota: No es necesario enviar el código fuente (src/), solo el artefacto compilado.

4. Consejos de monitoreo

• Logs: Spring Boot genera logs detallados. Síguelos en la terminal de Square para identificar errores de inyección de dependencias o fallas en la conexión con la base de datos.
• Health Checks: Si usas Spring Boot Actuator, puedes monitorear la salud de tu aplicación en tiempo real.

Actualizado el: 13/06/2026