Despliegue de aplicación Java en VPS: guía paso a paso de la A a la Z

Despliegue de aplicación Java en VPS: guía paso a paso de la A a la Z

Desarrollar una aplicación Java es solo la mitad del trabajo. La segunda parte, igualmente importante, es su despliegue en un servidor de producción. En esta guía, recorreremos el ciclo completo de despliegue de una aplicación Java (Spring Boot) en un servidor virtual privado (VPS) con sistema operativo Ubuntu 22.04. Aprenderá a configurar el servidor, compilar el proyecto, ejecutarlo como un servicio del sistema y garantizar el acceso seguro a través de un servidor web.

1. Preparación del VPS e instalación del software necesario

El primer paso es conectarse a su VPS mediante SSH e instalar Java Runtime Environment (JRE) y Git.

Conexión al servidor

ssh root@su-ip-del-servidor

Actualización de paquetes e instalación de Java (OpenJDK 17)

Para Spring Boot 3.x se recomienda Java 17. Instalaremos OpenJDK.

apt update && apt upgrade -y\napt install openjdk-17-jdk git -y\njava -version

Debería ver información sobre la versión de Java 17.

Instalación de Nginx (para reverse proxy)

apt install nginx -y\nsystemctl start nginx\nsystemctl enable nginx

2. Compilación de la aplicación Java (Maven/Gradle)

En su máquina local (o directamente en el servidor, si clona el repositorio) debe compilar el archivo JAR. Consideraremos ambas opciones.

Opción A: Compilación local y copia al servidor

Supongamos que tiene un proyecto Spring Boot con Maven.

# En la máquina local\nmvn clean package -DskipTests\n# El archivo aparecerá en target/my-app-0.0.1-SNAPSHOT.jar

Luego lo copiamos al servidor mediante SCP:

scp target/my-app-0.0.1-SNAPSHOT.jar root@su-ip:/opt/myapp/

Opción B: Compilación directamente en el servidor

Clonamos el repositorio y compilamos el proyecto:

cd /opt\ngit clone https://github.com/su-usuario/su-repositorio.git myapp\ncd myapp\n./mvnw clean package -DskipTests\n# O, si Maven está instalado globalmente:\nmvn clean package -DskipTests

3. Configuración de producción y creación del servicio systemd

Para que la aplicación se inicie automáticamente al arrancar el sistema y se reinicie en caso de fallo, crearemos un archivo unit de systemd.

Creación del script de inicio

Cree el directorio para la aplicación (si aún no lo ha creado):

mkdir -p /opt/myapp\n# Mueva el archivo JAR a este directorio si aún no está allí

Creación del servicio systemd

Cree el archivo /etc/systemd/system/myapp.service:

nano /etc/systemd/system/myapp.service

Inserte el siguiente contenido (reemplace las rutas y parámetros según su proyecto):

[Unit]\nDescription=My Java Spring Boot Application\nAfter=syslog.target network.target\n\n[Service]\nUser=root\nWorkingDirectory=/opt/myapp\nExecStart=/usr/bin/java -Xms256m -Xmx512m -jar /opt/myapp/my-app-0.0.1-SNAPSHOT.jar --server.port=8080\nSuccessExitStatus=143\nRestart=always\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target

Explicación de los parámetros:

\n
• -Xms256m -Xmx512m — tamaño inicial y máximo del heap de Java.
\n
• --server.port=8080 — puerto en el que funcionará la aplicación.
\n
• Restart=always — reinicio automático en caso de caída.
\n

Inicio y verificación del servicio

systemctl daemon-reload\nsystemctl start myapp\nsystemctl status myapp\nsystemctl enable myapp  # Inicio automático al arrancar

Verifique que la aplicación responda localmente:

curl http://localhost:8080/actuator/health

Debería recibir una respuesta JSON con el estado UP.

4. Configuración de Reverse Proxy mediante Nginx

El acceso directo a la aplicación a través del puerto 8080 no es seguro. Configuraremos Nginx como servidor proxy, que recibirá las solicitudes en