Dynamic web project

Dynamic web project 설정

이 문서에서는 Eclipse IDE를 이용하여 Github team project를 진행할 때 알아야 할 내용들에 대해서 다룬다.

Github 프로젝트 생성

팀 프로젝트를 하려면 Github Repository를 생성하고 팀원들을 Collaborator로 초대해야 한다. 해당 내용은 다음 링크를 참고하여 진행하도록 한다.

Github 저장소 관리 Collaborators

Eclipse 프로젝트 생성

Github 프로젝트에 등록하기 위한 Eclipse 프로젝트를 생성한다. 예시에서는 dynamic web project를 사용한다.

프로젝트 공유

프로젝트를 우클릭하고 Team 메뉴의 Share project를 눌러서 프로젝트를 Github와 연동한다.

Gitignore 추가

Git ignore 설정

위의 Git ignore 생성 방법을 읽고 다음을 적용하여 생성한다.

java
eclipse
intellij
macos
windows
linux
maven
gradle

팀 프로젝트를 진행할 때 팀원들의 OS나 IDE는 프로젝트에 포함될 필요가 없으므로 배제한다. 단, jar 파일이 필요할 경우 *.jar를 삭제한다.

프로젝트를 우클릭하여 File 생성 메뉴를 선택하고 이름을 .gitignore로 설정한 뒤 홈페이지에서 생성한 내용을 추가한다. project explorer에서는 .으로 시작하는 파일이 보이지 않으므로 navigator 또는 OS의 파일 탐색기를 사용한다.

.gitignore에 내용을 작성하고 나면 불필요한 파일들이 대상에서 제외되는 것을 볼 수 있다.

더미 파일 추가

프로젝트에서 사용하는 폴더들 중 파일이 없는 폴더는 업로드가 안되는 경우가 발생한다. 이럴 때 .keep 또는 .gitkeep 파일을 만들어서 해당 폴더를 유지하도록 설정할 수 있다. 물론 다른 파일을 만들어도 무방하다.

dynamic web project에서는 다음 폴더에 .keep 파일을 추가한다.

src/main/java
src/main/webapp/WEB-INF/lib

저장소에 폴더가 정상적으로 표시되며, Eclipse에서는 .keep 파일들이 보이지 않는 것을 확인할 수 있다.

프로젝트 내려받기 및 설정

프로젝트의 업로드가 끝났다면 프로젝트를 내려받아 설정할 수 있어야 한다. Eclipse에 Github 저장소를 연동하고 import project를 누르면 업로드해둔 프로젝트가 사용 가능한 저장소로 표시되지 않는다. IDE나 OS에 관련된 파일을 모두 제외하여 정상적인 프로젝트로 인식되지 않기 때문이며, 수동으로 설정해야 한다. Working Tree에 표시된 프로젝트를 우클릭하여 import project 한다.

Finish를 누르면 프로젝트가 로드되어 목록에 표시되지만, 설정이 없어 정상적으로 인식되지 않는 것을 확인할 수 있다.

Eclipse에서 정상적인 웹 프로젝트로 설정하기 위해 프로젝트 속성에서 Project Facets 설정을 한다.

maven이나 gradle 같은 빌드 도구가 있다면 이 설정을 할 일이 없지만 상황에 따라 해당 도구가 없는 지금과 같은 상황이 있을 수 있으므로 설정 방법에 대해서 알아본다.

설정할 항목은 다음과 같다.