Spring Boot Docker 배포

🛠️ 환경 설정

• 운영 체제: Windows 11
• 프레임워크: Spring Boot
• 프로젝트 빌드 도구: Maven
• Java 버전: 17
• Docker: 설치 및 설정 완료

https://github.com/bytebird96/bata-shop-backEnd.git

---

📌 1. Dockerfile이란?

Dockerfile은 Docker 컨테이너를 만들기 위한 설정 파일입니다.

이 파일을 사용하여 애플리케이션 실행 환경을 정의하고, 컨테이너 이미지를 생성할 수 있습니다.

📌 2. Dockerfile 생성

1️⃣ Dockerfile 생성 위치

Dockerfile은 Ubuntu 임의 디렉토리에서 생성

touch Dockerfile

또는

echo "" > Dockerfile

Windows 환경에서는 메모장으로 직접 만들 수도 있습니다.

(파일 이름을 Dockerfile로 저장, 확장자는 없음)

---

📌 3. Dockerfile 작성

아래는 Spring Boot + Maven 환경에 맞는 기본적인 Dockerfile입니다.

dockerfile
복사편집
# 1️⃣ JDK 17 기반의 가벼운 Docker 이미지 사용
FROM openjdk:17-jdk-slim

# 2️⃣ 컨테이너 내 작업 디렉토리 설정
WORKDIR /app

# 3️⃣ JAR 파일을 컨테이너로 복사
COPY target/*.jar app.jar

//명령어 따로 수정해 주기 귀찮으니까 app.jar로 이름을 변경하든 합시다.

# 4️⃣ 컨테이너가 실행될 때 실행할 명령어
ENTRYPOINT ["java", "-jar", "app.jar"]

---

📌 4. Dockerfile 설명

명령어	설명
FROM openjdk:17-jdk-slim	기본 이미지로 JDK 17을 사용 (Slim 버전으로 가볍게)
WORKDIR /app	컨테이너 내에서 /app 디렉토리를 작업 디렉토리로 설정
COPY target/*.jar app.jar	로컬의 target/ 폴더에 있는 JAR 파일을 컨테이너의 /app.jar로 복사
ENTRYPOINT ["java", "-jar", "app.jar"]	컨테이너가 실행되면 java -jar app.jar를 실행

---

🏗 IntelliJ IDEA에서 Spring Boot JAR 파일 생성 방법 (Maven 사용)

IntelliJ IDEA에서 Maven 기반 Spring Boot 프로젝트의 JAR 파일을 생성하는 방법을 설명하겠습니다.

현재 pom.xml을 확인한 결과, Spring Boot 3.4.1 + Maven 기반 프로젝트입니다.

이제 JAR 파일을 생성하여 실행 가능하게 만들고, Docker 배포까지 연결할 수 있도록 준비하겠습니다. 🚀

---

📌 1. IntelliJ에서 Maven 패널 확인

1️⃣ IntelliJ IDEA 실행

2️⃣ 우측 Maven 패널 열기 (View → Tool Windows → Maven)

3️⃣ 프로젝트 루트의 beta-shop 아래 Lifecycle 클릭

4️⃣ clean → package 순서대로 실행

✅ 이렇게 실행하면 자동으로 target/ 폴더에 JAR 파일이 생성됩니다!

✅ 테스트를 건너뛰려면 package 실행 시 -DskipTests 옵션을 추가하면 됩니다.

---

📌JAR 파일을 Ubuntu 서버로 전송

Windows에서 SCP(Secure Copy) 또는 WinSCP를 사용하여 JAR 파일을 전송합니다.

▶ 1️⃣ PowerShell(SCP) 사용

scp target/beta-shop-0.0.1-SNAPSHOT.jar ubuntu@<Ubuntu 서버 IP>:/home/ubuntu/

✅ 설명

• scp → Secure Copy(보안 복사) 명령어
• target/beta-shop-0.0.1-SNAPSHOT.jar → Windows에서 생성된 JAR 파일
• ubuntu@<Ubuntu 서버 IP>:/home/ubuntu/ → Ubuntu 서버의 /home/ubuntu/로 전송

📌 예제 (Ubuntu 서버 IP가 XXX.XXX.1.XXX인 경우)

scp target/beta-shop-0.0.1-SNAPSHOT.jar ubuntu@XXX.XXX.1.XXX:/home/ubuntu

---

▶ 2️⃣ WinSCP 사용 (GUI 방식)

1. WinSCP 다운로드 (알아서..ㅎㅎ)
2. SFTP 연결 후 /home/ubuntu/ 디렉토리에 beta-shop-0.0.1-SNAPSHOT.jar 파일 업로드

---

📌 1. Ubuntu 서버의 IP 주소 확인

Ubuntu 서버에 SSH 접속한 후 아래 명령어를 실행하세요.

hostname -I

✅ 출력 예시:

1XX.1XX.X.XXX

➡ 이 IP 주소가 Ubuntu 서버의 내부 IP(로컬 네트워크)입니다.

➡ 만약 공인 IP(외부에서 접근 가능한 IP) 가 필요하다면:

curl ifconfig.me

✅ 출력 예시:

2XX.X.XXX.XX

➡ 이 IP 주소가 공인 IP(외부 접속 가능) 입니다.

---

📌 2. Windows에서 Ubuntu로 파일(JAR) 전송

▶ 1️⃣ PowerShell(SCP) 사용

Windows에서 PowerShell을 열고 아래 명령어를 실행하세요.

scp target/beta-shop-0.0.1-SNAPSHOT.jar 계정명@XXX.XXX.X.XXX:경로

✅ 설명

• scp → 파일을 안전하게 복사(Secure Copy)
• target/beta-shop-0.0.1-SNAPSHOT.jar → Windows에서 복사할 JAR 파일 위치
• ubuntu@XXX.XXX.X.XXX:/home/ubuntu/ → Ubuntu 서버의 /home/ubuntu/ 폴더에 저장(IP XXX.XXX.X.XXX은 위에서 확인한 Ubuntu 서버의 IP로 변경)

📌 예제 (Ubuntu 서버 IP가 XXX.X.XXX.XX라면)

scp target/beta-shop-0.0.1-SNAPSHOT.jar ubuntu@**XXX.X.XXX.XX**:/home/ubuntu/

---

Docker 이미지 빌드 (Ubuntu에서 실행)

이제 Dockerfile을 기반으로 Docker 이미지를 빌드합니다.

▶ 1️⃣ JAR 파일과 Dockerfile 확인

ls /home/ubuntu/

✅ 출력 예시

Dockerfile
beta-shop-0.0.1-SNAPSHOT.jar

---

▶2️⃣ Docker 이미지 빌드

docker build -t beta-shop-app .

✅ 빌드 완료 후 확인

docker images

✔ 출력 예시

REPOSITORY        TAG       IMAGE ID       CREATED         SIZE
beta-shop-app     latest    123456789abc   2 minutes ago   120MB

---

📌 5. Docker 컨테이너 실행

이제 빌드한 이미지를 컨테이너로 실행합니다.

docker run -d -p 8080:8080 --name beta-shop-container beta-shop-app

✅ 아래 방법의 장점:

컨테이너를 삭제하지 않고도 새로운 JAR 파일을 쉽게 업데이트 가능

// JAR 파일 볼륨 마운트 (-v)
docker run -d -p 8080:8080 --name beta-shop-container \
  -v /경로/beta-shop-0.0.1-SNAPSHOT.jar:/app/app.jar \
  beta-shop-app

✅ 설명

• d → 백그라운드 실행
• p 8080:8080 → Ubuntu 서버의 8080 포트를 컨테이너의 8080 포트에 매핑
• -name beta-shop-container → 컨테이너 이름을 beta-shop-container로 지정
• beta-shop-app → 빌드한 Docker 이미지를 실행

✅ 컨테이너 실행 확인

docker ps

✔ 출력 예시

CONTAINER ID   IMAGE           PORTS                    NAMES
abc123456789   beta-shop-app   0.0.0.0:8080->8080/tcp   beta-shop-container

---