배치 Deployment

소스 코드 디렉토리 구성을 어떻게 할 것인가를 설명하기 전에, 웹 어플리케이션의 실행 구성을 시험해 볼 필요가 있습니다. 서블릿 API 스펙 2.2 버전 이전에는 서버 플랫폼 간에 일관성이 거의 없었습니다. 그러나 2.2 버전(또는 이후)의 스펙에서부터 웹 어플리케이션 보관소 Web Application Archive 표준 형식을 따를 것을 요구하기 시작했습니다. 아래에서 살펴보겠습니다.

웹 어플리케이션을 정의한다면 표준 구성으로 된 디렉토리와 파일의 체계라고 할 수 있습니다. 이 체계는 개개의 디렉토리와 파일이 파일시스템에 펼쳐진 "압축되지 않은" 형태와 Web ARchive, 또는 WAR 파일로 알려진 "압축된" 형태로 접근할 수 있습니다. 개발 중에는 전자가 유용하지만, 배포판으로 설치될 경우는 후자가 유리합니다.

웹 어플리케이션 체계의 최상위 디렉토리는 웹 어플리케이션의 문서 루트 document root입니다. 여기에, 웹 어플리케이션의 사용자 인터페이스를 구성하는 HTML 파일과 JSP 페이지가 위치합니다. 시스템 관리자가 웹 어플리케이션을 특정한 서버에 배치할 경우는, 웹어플리케이션에 컨텍스트 경로 context path 를 지정해야 됩니다. (톰캣의 배치에 관해서 뒤 섹션에서 설명합니다). 그러므로, 만약 시스템 관리자가 웹어플리케이션을 컨텍스트 경로 /catalog에 지정했다면, /catalog/index.html 를 호출하는 요청 URI 가 들어 올 경우 문서 루트에 있는 index.html 파일을 응답합니다.

요구되는 형태로 웹 어플리케이션 보관소 생성을 용이하게 하기 위해서, 웹 어플리케이션의 "실행" 파일들(즉, 웹 어플리케이션을 실행할 때 톰캣이 사용하는 파일들)을 WAR 형식에서 요구하는 것과 같은 구성으로 정리하는게 편합니다. 이렇게 하려면, 웹 어플리케이션의 "문서 루트 document root" 디렉토리에 다음 내용으로 구성합니다:

• *.html, *.jsp, 등. - 웹 어플리케이션에서 클라이언트 브라우저로 전송이 되는 HTML 과 JSP 페이지와 다른 파일들 (예를 들면 자바스크립트, 스타일시트, 이미지 같은). 대규모 어플리케이션에서 이 파일들을 서브디렉토리 체계로 나누어 놓을 수 있습니다. 그러나 규모가 작은 어플리케이션이라면 보통은 하나의 디렉토리에서 전체를 관리하는 것이 보다 단순하고 쉽습니다.
  
  
• /WEB-INF/web.xml - 웹 어플리케이션의 웹 어플리케이션 배치 설명자 Web Application Deployment Descriptor. 서블릿과 웹어플리케이션을 구성하는 다른 컴포넌트들을 설명하고, 각종 초기화 파라메터들과 서버 기능을 활용하기 위한 컨테이너가 관리하는 보안 제한 구역을 지정하는 XML 파일입니다. 다음 섹션에서 좀 더 자세히 알아보도록 하겠습니다.
  
  
• /WEB-INF/classes/ - 이 디렉토리에는 웹 어플리케이션에서 사용하는 모든 자바 파일(그리고, 관련 자원)이 들어있습니다. 서블릿과 비서블릿 클래스 파일들이며 jar 형태로 묶여있지 않은 것입니다. 패키지가 선언된 클래스라면 /WEB-INF/classes/ 를 기준으로 패키지의 디렉토리를 만들어 구성하면 됩니다. 예를 들어, 클래스명이 com.mycompany.mypackage.MyServlet 라면 파일의 저장경로는 /WEB-INF/classes/com/mycompany/mypackage/MyServlet.class 이 됩니다.
  
  
• /WEB-INF/lib/ - 이 디렉토리에는 웹어플리케이션에서 사용하는 자바 클래스파일을 포함하는 JAR 파일들이 위치합니다. 외부 클래스 라이브러리나 JDBC 드라이버 같은 것들입니다.

톰캣(또는 다른 2.2/2.3 호환 서버)에 어플리케이션을 설치할 때, WEB-INF/classes/ 에 있는 클래스들과 WEB-INF/lib/ 디렉토리에 있는 JAR파일에 있는 모든 클래스들은 같은 웹 어플리케이션에서 사용하는 모든 클래스가 접근가능하게 되어있습니다. 따라서, 만일 이 디렉토리 안에 사용하는 모든 라이브러리 클래스들을 몰아 넣으면 (외부 라이브러리를 사용하는 경우 재배포 권한에 관한 라이센스를 확인하길 바랍니다.), 웹 어플리케이션의 설치가 간단히 끝날 수 있습니다 -- 시스템 클래스패스에 대한 조정(또는 서버에 있는 전체 라이브러리의 설치)도 필요 없습니다.

이 장의 많은 부분은 버전 2.3의 서블릿 API 스펙에서 발췌했다. 자세한 내용이 궁금 하다면 꼭 살펴보길 바랍니다.

대부분의 서블릿 컨테이너처럼, 톰캣 4 도 라이브러리 JAR 파일(또는 클래스 파일들)을 하나만 설치해서 모든 웹 어플리케이션에 각각 설치하지 않아도 접근해서 사용할 수 있는 기능을 지원합니다. 톰캣이 그런 클래스들을 어떻게 위치하고 공유하는지는 Class Loader HOW-TO 문서에서 자세히 설명 해 놓았습니다. 우리의 논의할 바는, 톰캣 4 설치에 공유할 목적으로 공통으로 사용되는 두 개의 위치에 관한 것입니다:

• $CATALINA_HOME/common/lib - 여기에 놓인 JAR 파일들은 웹 어플리케이션과 내부 톰캣 코드 모두 접근할 수 있습니다. 웹 어플리케이션과 톰캣 내부(JDBCRealm 같은)에서 사용하는 JDBC 드라이버를 놓을 최적의 장소입니다.
  
  
• $CATALINA_HOME/shared/lib - 여기에 놓인 JAR 파일들은 웹 어플리케이션에서는 접근할 수 있지만 톰캣 내부 코드와는 격리됩니다. 웹 어플리케이션에 특별히 지정된 공유라이브러리를 놓을 적당한 장소입니다.
  
  

박스를 열어보면, 표준 톰캣 설치판은 다양한 공유 라이브러리 파일들을 포함하고 있습니다. 다음과 같습니다:

• 자바메일 JavaMail 1.2 (그리고 연관된 자바빈즈 액티베이션 프레임워크 JavaBeans Activation Framework) API, 따라서 메일을 발송할 수 있는 웹 어플리케이션을 만들 수 있습니다.
  
  
• JDBC 2.0 선택 패키지 Optional Package API, javax.sql.DataSource 같은 것들을 정의합니다.
  
  
• 서블릿 Servlet 2.3 과 JSP 1.2 API, 서블릿과 JSP 작성시 중요한 역할을 담당합니다.
  
  
• XML 파서 Parser JAXP (version 1.1) API 호환, 따라서 어플리케이션은 DOM-기반 또는 SAX-기반의 XML 문서처리가 가능합니다.
  
  

아래 설명에서 사용하는 환경변수 $CATALINA_HOME 은 톰캣 4 가 설치된 디렉토리를 가리킵니다. 대부분의 상대경로는 이것을 기준으로 풀이됩니다. 그러나, 만약 톰캣 4 여러개의 인스턴스를 $CATALINA_BASE 디렉토리에 설치 했다면 $CATALINA_HOME 대신 각각의 참조를 위해 $CATALINA_BASE를 사용해야 됩니다.

위에서 언급한대로, /WEB-INF/web.xml 파일은 웹 어플리케이션에 대한 웹 어플리케이션 배치 설명서를 포함합니다. 파일 확장자가 뜻하는 것처럼, 이 파일은 XML 문서이고, 서버에 전달할 웹 어플리케이션의 모든 정보(예외 컨텍스트 경로 context path , 이 항목은 시스템 관리자가 어느곳에 배치할지를 결정하는 것입니다.)를 정의합니다.

배치 설명서의 완전한 문법과 의미에 대해서는 버전 2.3 서블릿 API 스펙 13장에 정의되어 있습니다. 시간이 지날수록, 더 많은 개발툴들이 자동으로 배치 설명서를 생성하고 수정하는 기능을 제공하게 될 것입니다. 이제, 입문서 역할을 하는, 기본 web.xml 파일 를 보여드리겠습니다. 이 파일은 각 엘리먼트의 목적이 무엇인지 설명하고 있습니다.

주의 - 서블릿 스펙은 웹 어플리케이션 배치 설명서의 Document Type Descriptor (DTD)를 포함합니다. 그리고, 톰캣 4는 웹 어플리케이션의 /WEB-INF/web.xml 파일을 처리할 때 여기서 정의된 규칙을 따르게 됩니다. 특별히, 반드시 설명서 엘리먼트들(예를 들면 <filter>, <servlet>, <servlet-mapping> 같은)을 DTD 에 정의된 순서(Section 13.3에 있는)에 따라서 입력해야 됩니다.

실행하기 전에 웹 어플리케이션을 서블릿 컨테이너에 배치해야됩니다. 개발시에도 마찬가지입니다. 실행환경을 만들기 위해 어떻게 톰캣4를 사용하는지 설명하겠습니다. 다음의 여러방법 중 하나를 선택해서 톰캣에 웹 어플리케이션을 배치할 수 있습니다:

• 압축을 푼 디렉토리 체계 전체를 $CATALINA_HOME/webapps/ 디렉토리 아래의 서브 디렉토리에 복사합니다.. 서브디렉토리 이름에 따라서 톰캣에서 컨텍스트 경로를 할당하게 됩니다. 우리가 만들 build.xml 파일에서 이러한 방식을 사용하려고 합니다. 왜냐하면 이 방법이 개발기간동안 제일 빠르고 쉬운 접근방법이기 때문입니다. 설치 또는 웹 어플리케이션 업데이트 를 한 후에는 톰캣을 재시동해야합니다.
  
  
• $CATALINA_HOME/webapps/ 디렉토리에 웹 어플리케이션 압축(WAR) 파일을 복사합니다. 톰캣이 시작할 때, 자동으로 압축을 풀어서 펼쳐 놓고, 즉시 어플리케이션을 실행합니다. 이 방법은 전형적으로 추가 어플리케이션을 설치 할 때 사용하는데, 기존 톰캣 설치된 것에 다른 벤더나 내부 개발 스태프가 제공한 것을 설치할 경우입니다. 주의 - 이 방법을 사용하고 나중에 어플리케이션을 업그레이드 하려면, 웹 어플리케이션 압축 파일을 바꾼 뒤 이전에 톰캣이 풀어놓은 디렉토리를 반드시 삭제하고, 톰캣을 재시작해야됩니다. 그래야 변경사항이 반영됩니다.
  
  
• 톰캣 4의 "Manager" 웹 어플리케이션을 설치하고 제거하는 데 사용합니다.. 톰캣 4는 기본적으로 /manager 컨텍스트에 설치된 웹 어플리케이션이 있습니다. 이것은 운영중인 톰캣 서버에 재시동하지 않고도 웹 어플리케이션을 설치하고 제거할 수 있는 기능이 있습니다. Manager 웹 어플리케이션 사용에 관한 더 자세한 정보는 관리자 문서를 참고하십시오.
  
  
• 빌드 스크립트에서 "Manager" 앤트 작업. 톰캣 4 에는 Ant 빌트 도구를 사용해서 "Manager" 웹 어플리케이션의 명령실행을 자동화시킨 사용자 작업 명령들을 포함하고 있습니다. 나중에 설명할 예제 빌드 스크립트에 포함되어 있고, 그때 설명하도록 하겠습니다.
  
  
• $CATALINA_HOME/conf/server.xml 환경 설정 파일에 <Context> 엔트리 추가. 이 방법은 아래 간략하게 설명할 것이고, $CATALINA_HOME/webapps/ 디렉토리가 아닌 가른 곳에 웹 어플리케이션을 위치할 수 있는 방법입니다. 변경사항이 반영되려면 톰캣을 재시작해야 됩니다. 이 방법으로 새로운 컨텍스트를 추가하는 것에 대한 자세한 정보는 관리자 문서를 참고하십시오.

다른 서블릿 컨테이너에 웹 어플리케이션을 배치하는 것은 가지각각이겠지만, 서블릿 스펙 2.2 이상을 따르는 모든 컨테이너들은 웹 어플리케이션 압축(WAR) 파일을 사용할 수 있도록 되어있습니다. 어떤 컨테이너는 (톰캣처럼) 압축이 풀린 디렉토리 구조를 사용하지 못할 수도 있고, 또는 공유된 라이브러리 파일들에 대한 기능을 제공하지 못할 수 도 있지만, 이러한 기능들은 대부분의 컨테이너에서 지원됩니다.