리눅스 환경에서 Tomcat으로 웹 애플리케이션 배포하기 (CentOS)

필자는 centOS로 진행

1. ftp로 압축 파일들 넣거나 리눅스 내에서 java, was 설치하기

apache-tomcat-8.5.27.tar.gz, jdk-8u241-linux-x64.tar.gz ftp로 집어 넣기

 

디렉토리 생성 명령어

mkdir test → test폴더 디렉토리

 

디렉토리 하위 디렉토리까지 만들기

mkdir -p test/test2 → test폴더 안에 test2폴더 디렉토리

 

---

 

2. 디렉토리 안에서 아파치-톰캣, 자바 압축 해제

압축 해제 명령어 tar zxvf

 

tar 옵션

설명

-c : 파일을 tar로 묶음

-p : 파일 권한을 저장

-v : 묶거나 파일을 풀 때 과정을 화면으로 출력

-f : 파일 이름을 지정

-C : 경로를 지정

-x : tar 압축을 풂

-z : gzip으로 압축하거나 해제함

 

예를 들어

user/test/test2 디렉토리가 있다. user폴더에 있는 압축 파일을 test2에다가 해제하고 싶다면

tar -zxvf 압축파일명 -C test/test2

 

---

3. Tomcat을 실행하기 위해 JDK 또는 JRE가 필요하므로 경로 설정

 

Tomcat은 Java기반의 웹 서버이자 서블릿 컨테이너이다.

 

Tomcat 자체가 Java 기반의 JVM을 사용하여 Java 코드를 실행하므로 Java 설치 없이는 제대로 동작하지 않는다. 따라서 Tomcat을 올바르게 JDK 또는 JRE와 연결하는 것이 중요!

 

---

리눅스에서 Tomcat과 JDK 또는 JRE 연결하는 방법 2가지

첫 번째 방법 : .bashrc에서 PATH로 환경 변수 설정하기

1. 경로를 설정하기 위해 vi ~/.bashrc 명령하기

 

💡
vi
 텍스트 편집기

~
 틸드(~) 기호는 현재 사용자의 홈 디렉토리를 나타낸다.

.bashrc
 bash쉘에서 실행되는 초기화 스크립트 파일. 사용자가 로그인하면 bash쉘이 실행되고, 이 파일은 쉘이 시작될 때 자동으로 로드된다. 수정한 후 변경 내용을 적용하려면 로그아웃하고 다시 로그인하면 된다.

💡

 

2. .bashrc 파일에서 환경 변수 설정 해주기

JAVA_HOME에 jdk 경로를 잡아주고 PATH에다가 JAVA_HOME/bin으로 잡아준다.

 

여기서 PATH 앞에 $를 붙여주는 이유로는 만약 $가 없다면 export PATH=$JAVA_HOME/bin PATH 환경 변수에 디렉터리만 설정하는 것이기 때문에 이렇게 사용하면 기존의 PATH 설정이 모두 덮어써질 수도 있다. 주의해서 설정해야 한다.

 

따라서 export PATH=$PATH:$JAVA_HOME/bin을 사용하여 PATH 환경 변수를 수정하는 것이 올바른 방법이다.

이렇게 하면 기존의 환경 변수 설정을 유지하면서 새로운 디렉토리 경로를 추가할 수 있다.

 

💡

export

 쉘(Shell) 환경에서 사용되는 명령어로, 환경 변수를 선언하거나 값을 할당하는 데 사용한다.

 

$

 리눅스/유닉스 기반 시스템에서 쉘 명령어를 입력하는 터미널에서 사용되는 기호. 변수 이름 앞에 ‘$’를 붙이면 해당 변수의 값을 읽어온다.

 

:

 콜론은 디렉토리 경로들을 구분하는 구분자이다.

💡

 

 

---

두 번째 방법 : Tomcat의 catalina.sh에서 수동으로 연결하기

1. catalina.sh파일 편집

vi apache-tomcat-8.5.27/bin/catalina.sh 명령

 

JAVA_HOME=jdk 경로

 

---

 

4. 웹 브라우저를 사용하여 Tomcat 접속 확인

jdk를 연결 했다면

아파치-톰캣 bin 폴더의 startup.sh로 실행시켜준다.

 

./startup.sh

 

💡

리눅스에서 ./은 현재 작업 디렉토리를 나타낸다. 즉, 현재 작업 중인 디렉토리를 기준으로 파일이나 디렉토리에 접근하거나 실행하려는 것을 의미

💡

 

tomcat이 연결 되면 localhost:8080 확인 (Tomcat의 기본 포트는 8080)

확인 됐으면 다음 단계 진행 !!

 

---

5. Tomcat에서 Context path 설정과 Application 배포

 

Tomcat에서의 웹 애플리케이션을 배포할 때, 컨텍스트 경로에 등록하는 것이 일반적인 방법이다.

 

이 때 Context 경로를 설정하는 이유로는 여러가지가 있다.

 

1. 다중 웹 애플리케이션 호스팅

하나의 Tomcat 서버에서 여러 개의 웹 애플리케이션을 호스팅할 수 있다. 각 웹 애플리케이션은 고유한 컨텍스트 경로를 가져야 하며, 이는 사용자가 해당 애플리케이션에 접근하는 경로를 지정할 수 있다.

 

2. URL 구조

웹 애플리케이션 URL 구조를 조직화하는 데 사용된다. 예를들어 /home, /test, /hello/world 등과 같은 경로를 사용하여 애플리케이션의 다른 섹션에 접근할 수 있다.

 

3. 보안

컨텍스트 경로를 통해 웹 애플리케이션의 URL을 더 안전하게 만들 수 있다. 다른 웹 애플리케이션의 URL과 충돌하지 않으며, 특정 애플리케이션에 대한 요청만이 해당 경로로 접근하도록 보장할 수 있다.

 

💡

보통 웹 애플리케이션은 WAR 파일 형태로 패키징되어 배포된다. WAR 파일에는 웹 애플리케이션의 코드, 리소스, 설정 등이 포함되어 있다.

💡

---

 

컨텍스트 경로 설정 방법

server.xml 파일에 <Context> 요소를 추가한다.

<Context docBase="" path="" reloadable=""/>

docBase : 웹 애플리케이션의 위치를 가리키는 속성

path : 웹 애플리케이션의 컨텍스트 경로를 지정하는 속성, 슬래시로 시작해야 한다.

reloadable : /WEB-INF/classes/ 와 /WEB-INF/lib이 변경되면, 웹 애플리케이션에서 자동으로 재로딩

 

예를들어

<Context docBase="/moms/touch" path="/hello" />

위의 Context 요소로는 /moms/touch 경로 안에 웹 애플리케이션을 배포하는 것.

/moms/touch 폴더 안에 jmt.jsp 파일이 있다고 예시를 들어본다면

url에 http://localhost:8080/hello/jmt.jsp를 요청했을 시 docBase에 설정해둔 경로로 웹 애플리케이션을 배포하면서 웹 브라우저에 보여질 것이다.

 

 

❗❗제일 중요한건 server.xml 변경된 내용이 반영되려면 Tomcat재기동 필수❗❗

 

💡

배포는 WAR 파일도 가능.

올바른 XML 문법을 사용하려면 경로 설정할 때 역슬래시 대신 슬래시(’/’) 또는 이중 역슬래시(’\\’)를 사용해야 한다. 일반적으로 슬래시를 사용하는 것을 권장

💡

 

---

6. Tomcat의 JNDI 데이터베이스 연결 설정

 

<Resource> 요소를 사용하여 웹 애플리케이션에 데이터베이스 연결 설정을 정의하면, Tomcat은 해당 설정을 활용하여 웹 애플리케이션에서 데이터베이스에 접속할 수 있도록 지원한다.

<Resource 
      name="jdbc/hello"
      auth="Container"
      type="javax.sql.DataSource"
      maxActive="100" 
      maxIdle="30"
      maxWait="10000"
      validationQuery="SELECT 1 FROM DUAL"
      validationInterval="30000"
      username="test"
      password="test"
      driverClassName="oracle.jdbc.driver.OracleDriver"
      url="jdbc:oracle:thin:@xxx.xxx.x.xxx:1521:TEST"
/>

• name=”” : DataSource를 식별하기 위한 이름
• auth=”” : DataSource 인증 유형을 지정
• type=”” : DataSource의 유형을 지정
• maxActive=””, maxIdle=””, maxWait=”” : Connection Pool의 최대 활성 연결 수, 최대 비활성 연결 수, 최대 대기 시간을 설정
• validationQuery : “” : Connection Pool에서 연결 유효성을 검사할 SQL 쿼리를 지정
• validationInterval : “” : Connection Pool의 연결 유효성을 검사하는 주기를 지정(밀리초 단위)
• username=””, password=”” : 데이터베이스에 접속하기 위한 사용자 이름과 암호를 설정
• driverClassName=”” : xxx데이터베이스에 접속하기 위한 JDBC 드라이버 클래스를 지정
• url=”” : xxx데이터베이스에 접속하기 위한 JDBC URL을 지정

위의 설정을 사용하면 jdbc/hello 라는 이름으로 데이터베이스에 접속할 수 있게 된다.

 

데이터베이스 연결 정보는 <Resource> 요소에 포함되어 있으며, 웹 애플리케이션의 Java코드에서 이 정보를 참조하여 데이터베이스와 상호작용을 할 수 있다.

---

Tomcat의 JNDI 데이터베이스 연결 방법으로 크게 2가지 접근 방식

 

첫 번째 방법 : <Context> 요소 안에 개별적으로 데이터베이스 연결 관리

 

독립성이 필요하거나 보안 강화가 필요한 경우나 웹 애플리케이션의 설정 관리를 간편하게 하고 싶은 경우 보통 사용한다.

 

server.xml <Context>요소 안에 <Resource>를 설정하는 것은 웹 애플리케이션의 독립성과 보안성을 강화하는 데 도움이 된다.

<Context docBase="/moms/touch" path="/hello">
        <Resource
          name="jdbc/hello"
          auth="Container"
          type="javax.sql.DataSource"
          maxActive="100" 
          maxIdle="30"
          maxWait="10000"
          validationQuery="SELECT 1 FROM DUAL"
          validationInterval="30000"
          username="test"
          password="test"
          driverClassName="oracle.jdbc.driver.OracleDriver"
          url="jdbc:oracle:thin:@xxx.xxx.x.xxx:1521:TEST"
        />
</Context>

단, 해당 웹 애플리케이션만이 사용할 수 있도록 하는 것이기 때문에, 여러 웹 애플리케이션에서 동일한 데이터베이스 연결 정보를 공유해야 하는 경우에는 전역 리소스 설정을 사용하는 것이 더 적합하다.

 

💡

전역 리소스가 무엇일까?

웹 애플리케이션이 아닌, 웹 서버 전체에서 사용되는 리소스 웹 서버의 설정 파일에 등록되며, 여러 웹 애플리케이션에서 공유하여 사용할 수 있다.

💡

---

두 번째 방법 : 전역 리소스를 사용한 데이터베이스 연결 관리

웹 애플리케이션 간에 공통으로 사용되는 데이터베이스 연결 정보를 중앙에서 편리하게 관리하기 위함이다. 이를 통해 웹 애플리케이션들이 동일한 데이터베이스에 접속할 수 있고, 데이터베이스 연결 정보를 중복해서 각각의 웹 애플리케이션에서 설정할 필요가 없어진다.

 

순서

 

1. server.xml에 전역 리소스 등록

<GlobalNamingResources>
        <Resource 
            name="jdbc/hello"
            auth="Container" 
            type="javax.sql.DataSource"
            maxActive="100" maxIdle="30" 
            maxWait="10000" 
            validationQuery="SELECT 1 FROM DUAL"
            validationInterval="30000" 
            username="test" password="test" 
            driverClassName="oracle.jdbc.driver.OracleDriver"
            url="jdbc:oracle:thin:@xxx.xxx.x.xxx:1521:TEST"
         />
</GlobalNamingResources>

 

2. context.xml에서 리소스 추가

<Context>
  <ResourceLink name="jdbc/hello" global="jdbc/hello" type="javax.sql.DataSource"/>
</Context>

 

💡

server.xml에 등록한 <Resource>요소의 name속성과 context.xml에 등록한 <ResuorceLink>요소의 name속성과 global속성은 같아야 한다.

💡

 

---

2가지 접근 방식 모두 데이터베이스 연결에 성공한 걸 확인할 수 있다.

---