Implantação de aplicação Java em VPS: guia passo a passo do início ao fim

Implantação de aplicação Java em VPS: guia passo a passo do início ao fim

Desenvolver uma aplicação Java é apenas metade do trabalho. A segunda parte, igualmente importante, é sua implantação (deploy) em um servidor de produção. Neste guia, percorreremos o ciclo completo de implantação de uma aplicação Java (Spring Boot) em um Servidor Virtual Privado (VPS) com sistema operacional Ubuntu 22.04. Você aprenderá como configurar o servidor, compilar o projeto, executá-lo como um serviço do sistema e garantir acesso seguro através de um servidor web.

1. Preparação do VPS e instalação do software necessário

O primeiro passo é conectar-se ao seu VPS via SSH e instalar o Java Runtime Environment (JRE) e o Git.

Conexão ao servidor

ssh root@seu-ip-do-servidor

Atualização de pacotes e instalação do Java (OpenJDK 17)

Para o Spring Boot 3.x, recomenda-se Java 17. Vamos instalar o OpenJDK.

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

Você deve ver as informações da versão do Java 17.

Instalação do Nginx (para reverse proxy)

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

2. Compilação da aplicação Java (Maven/Gradle)

Na sua máquina local (ou diretamente no servidor, se você clonar o repositório), é necessário compilar o arquivo JAR. Vamos considerar ambas as opções.

Opção A: Compilação local e cópia para o servidor

Suponha que você tenha um projeto Spring Boot com Maven.

# Na máquina local\nmvn clean package -DskipTests\n# O arquivo aparecerá em target/my-app-0.0.1-SNAPSHOT.jar

Em seguida, copie-o para o servidor via SCP:

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

Opção B: Compilação diretamente no servidor

Clone o repositório e compile o projeto:

cd /opt\ngit clone https://github.com/seu-usuario/seu-repositorio.git myapp\ncd myapp\n./mvnw clean package -DskipTests\n# Ou, se o Maven estiver instalado globalmente:\nmvn clean package -DskipTests

3. Configuração da configuração de produção e criação do serviço systemd

Para que a aplicação inicie automaticamente na inicialização do sistema e seja reiniciada em caso de falha, criaremos um arquivo unit do systemd.

Criação do script de inicialização

Crie um diretório para a aplicação (se ainda não o fez):

mkdir -p /opt/myapp\n# Mova o arquivo JAR para este diretório, se ainda não estiver lá

Criação do serviço systemd

Crie o arquivo /etc/systemd/system/myapp.service:

nano /etc/systemd/system/myapp.service

Insira o seguinte conteúdo (substitua os caminhos e parâmetros conforme seu projeto):

[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

Explicação dos parâmetros:

\n
• -Xms256m -Xmx512m — tamanho inicial e máximo da heap do Java.
\n
• --server.port=8080 — porta na qual a aplicação será executada.
\n
• Restart=always — reinicialização automática em caso de falha.
\n

Inicialização e verificação do serviço

systemctl daemon-reload\nsystemctl start myapp\nsystemctl status myapp\nsystemctl enable myapp  # Inicialização automática na inicialização

Verifique se a aplicação responde localmente:

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

Você deve receber uma resposta JSON com o status UP.

4. Configuração do Reverse Proxy via Nginx

O acesso direto à aplicação pela porta 8080 não é seguro. Vamos configurar o Nginx como servidor proxy, que receberá as requisições na