Windows 환경에서 Tomcat 웹 프로젝트 배포하기

웹 프로젝트를 개발한 후 배포하려면 Tomcat과 같은 웹 애플리케이션 서버를 사용해야 합니다.
이 튜토리얼에서는 Apache Tomcat을 설치하고, WAR 파일을 생성한 후 배포하는 과정을 단계별로 설명합니다.

---

준비

Windows 운영 체제
JDK(Java Development Kit) 설치 및 환경 변수 설정
Eclipse(또는 IntelliJ) + Maven 프로젝트

---

1. Apache Tomcat 설치하기

1-1. Tomcat 다운로드

1. Apache Tomcat 공식 사이트에 접속합니다.
2. **최신 버전의 Tomcat (ZIP 파일)**을 다운로드합니다.

1-2. Tomcat 압축 해제 및 설치

1. 다운로드한 ZIP 파일을 C:\tomcat 경로에 압축 해제합니다.
2. C:\tomcat\bin 폴더로 이동하여 startup.bat을 실행하면 Tomcat이 시작됩니다.

1-3. Tomcat 실행 확인

1. 브라우저에서 아래 URL을 입력합니다.
2. http://localhost:8080
3. Tomcat 기본 페이지가 나타나면 정상적으로 실행된 것입니다. 🎉

---

2. Maven 프로젝트에서 WAR 파일 생성하기

2-1. Eclipse에서 WAR 파일 만들기

1. Eclipse에서 프로젝트 우클릭 → Export → WAR file 선택
2. Destination에서 저장 경로 지정 (예: C:\deploy\myapp.war)
3. Finish 버튼 클릭

2-2. Maven 프로젝트에서 WAR 파일 만들기

1. 프로젝트 우클릭 → Run As → Maven clean 실행
2. 다시 프로젝트 우클릭 → Run As → Maven install 실행
3. target 폴더에 myapp.war 파일이 생성됨

---

3. Tomcat에 WAR 파일 배포하기

3-1. 자동 배포 (webapps 폴더 사용)

1. C:\tomcat\webapps 폴더에 myapp.war 파일을 복사합니다.
2. Tomcat을 재시작하면 webapps 폴더에 myapp 폴더가 자동 생성됩니다.

3-2. 수동 배포 (Tomcat Manager 사용)

1. 브라우저에서 Tomcat Manager 접속 (http://localhost:8080/manager/html)
2. Deploy 섹션에서 WAR 파일 업로드
3. 업로드 후 /myapp URL로 접속하여 확인

---

4. Tomcat 실행 및 배포 확인

4-1. Tomcat 서버 시작

1. C:\tomcat\bin\startup.bat 실행

4-2. 브라우저에서 배포 확인

Tomcat이 실행되었다면 아래 URL로 접속하여 배포된 웹 애플리케이션을 확인할 수 있습니다.

http://localhost:8080/myapp

여기서 **myapp**은 배포한 WAR 파일의 이름입니다.

• 예를 들어, myproject.war 파일을 배포했다면 http://localhost:8080/myproject 로 접속해야 합니다.
• 만약 ROOT.war로 배포하면 기본 주소 (http://localhost:8080/)에서 바로 실행됩니다.

🎉 정상적으로 웹 애플리케이션이 실행되면 배포가 성공적으로 완료된 것입니다!

4-3. Tomcat 종료 (필요 시)

shutdown.bat

---

5. 문제 해결 및 로그 확인

Tomcat 실행 오류 발생 시

• catalina.out 또는 localhost.log 로그 파일 확인 (C:\tomcat\logs)
• 포트 충돌 시 server.xml 파일에서 <Connector port="8080" ...> 부분 수정 (예: 8081)

JDK 오류 발생 시

• 환경 변수에서 JAVA_HOME 설정 확인 (C:\Program Files\Java\jdk-XX.X.X)