Linux Spring 설정

Linux에서 Spring Boot 애플리케이션을 설정하는 과정은 크게 다음과 같은 단계로 진행됩니다. 1. JDK 설치 및 환경 변수 설정 Spring Boot는 Java 기반이므로, 먼저 JDK가 설치되어 있어야 합니다. JDK 설치 (예: OpenJDK 17) sudo apt update # Debian/Ubuntu sudo apt install openjdk-17-jdk -y sudo yum install java-17-openjdk -y # RHEL/CentOS Java 버전 확인 java -version "openjdk version '17.0.x'" 등이 출력되면 정상적으로 설치된 것입니다. 환경 변수 설정 (필요할 경우) echo 'export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64' >> ~/.bashrc echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc source ~/.bashrc 2. Spring Boot 애플리케이션 실행 JAR 파일 실행 Spring Boot 프로젝트를 빌드하면 target/ 폴더 아래에 .jar 파일이 생성됩니다. 이를 실행하는 방법입니다. java -jar my-spring-app.jar 백그라운드 실행 (nohup) Linux에서 서버가 종료되어도 실행되도록 nohup을 사용합니다. nohup java -jar my-spring-app.jar > output.log 2>&1 & - output.log: 로그를 저장할 파일 - &: 백그라운드 실행 - 실행 중인 프로세스 확인: ps aux | grep java 포트 변경 (application.properties) 기본적으로 Spring Boot는 8080 포트를 사용합니다. 변경하려면 다음 설정을 추가합니다. src/main/resources/application.properties server.port=9090 또는 server: port: 9090 3. Systemd 서비스 등록 (자동 실행) Spring Boot 애플리케이션을 시스템 부팅 시 자동으로 실행되도록 systemd 서비스로 등록할 수 있습니다. 서비스 파일 생성 sudo nano /etc/systemd/system/spring-app.service 파일 내용 작성 [Unit] Description=Spring Boot Application After=network.target [Service] User=ubuntu # 실행할 사용자 WorkingDirectory=/home/ubuntu/myapp # 애플리케이션 경로 ExecStart=/usr/bin/java -jar /home/ubuntu/myapp/my-spring-app.jar SuccessExitStatus=143 Restart=always RestartSec=10 [Install] WantedBy=multi-user.target 서비스 등록 및 실행 sudo systemctl daemon-reload sudo systemctl enable spring-app sudo systemctl start spring-app sudo systemctl status spring-app 4. 방화벽 설정 Spring Boot 애플리케이션이 특정 포트에서 외부 접속을 허용하도록 방화벽을 설정해야 합니다. UFW (Ubuntu) sudo ufw allow 9090/tcp sudo ufw reload Firewalld (CentOS) sudo firewall-cmd --zone=public --add-port=9090/tcp --permanent sudo firewall-cmd --reload 5. Reverse Proxy (Nginx) 설정 Spring Boot를 8080 포트에서 실행할 경우, Nginx를 통해 80 포트로 프록시할 수 있습니다. Nginx 설치 sudo apt install nginx -y # Ubuntu/Debian sudo yum install nginx -y # CentOS/RHEL Nginx 설정 파일 수정 sudo nano /etc/nginx/sites-available/spring-app server { listen 80; server_name mydomain.com; location / { proxy_pass http://127.0.0.1:9090; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } 설정 적용 sudo ln -s /etc/nginx/sites-available/spring-app /etc/nginx/sites-enabled/ sudo systemctl restart nginx 6. 로그 관리 및 모니터링 Spring Boot 애플리케이션의 로그는 기본적으로 logs/ 디렉터리에 저장됩니다. 로그 실시간 확인 tail -f logs/application.log CPU 및 메모리 사용량 확인 top htop # 설치 필요 (sudo apt install htop) 애플리케이션 종료 sudo systemctl stop spring-app # systemd 사용 시 kill $(pgrep -f 'my-spring-app.jar') # 프로세스 직접 종료