소스코드를 직접 내려 받아서 실행하기#
자신의 입맛에 맛게 코드를 직접 수정해서 작업하거나 코드를 기여하고 싶을 경우에는 코드 저장소로부터 코드를 직접 내려받아서 빌드/실행하는 것도 가능합니다.
JDK version 확인#
java -version
javac -version
JDK 8(1.8) 이상이어야 합니다.
Play Activator 내려 받기#
curl -O http://downloads.typesafe.com/typesafe-activator/1.2.10/typesafe-activator-1.2.10-minimal.zip
혹은
wget http://downloads.typesafe.com/typesafe-activator/1.2.10/typesafe-activator-1.2.10-minimal.zip
웹 브라우저에서 (이를테면, MS윈도우즈 사용자일 경우)
http://downloads.typesafe.com/typesafe-activator/1.2.10/typesafe-activator-1.2.10-minimal.zip
압축 풀기#
unzip typesafe-activator-1.2.10-minimal.zip
압축을 푼 다음 하위 디렉터리로 이동#
cd typesafe-activator-1.2.10-minimal
Yona 소스 내려 받기#
case1. git 클라이언트를 이용한 다운로드 (추천)
git clone https://github.com/yona-projects/yona.git
case2. 단순히 최신 안정버전을 내려받고자 할 때는 아래 링크를 이용해서 압축파일을 내려받은 다음 yona를 폴더이름으로 해서 해제합니다.
git pull https://github.com/yona-projects/yona.git master
주의! case2의 경우, 업그레이드 할 때 문제가 생길 수 있습니다.
임의의 장소에 Yona 디렉터리를 위치시킬 경우에는 activator 실행파일이 있는 Play Activator 디렉터리를 $PATH 환경변수에 추가해 주세요.
clone 받은 Yona 디렉터리로 이동#
(혹은 압축을 해제한 디렉터리로 이동)
cd yona
상단에 있는 activator 실행파일 실행#
../activator
혹은 (윈도우 사용자일 경우)
..\activator
실행하면 필요한 파일들을 web에서 내려받습니다. 첫 실행 시 네트워크 상황에 따라 10여 분 가까이 소요될 수 있습니다.
만약 HTTPS 관련 오류가 발생한다면 ~/.sbt/repositories 파일에 https 주소의 maven central url을 아래 내용처럼 추가해주세요
[repositories]
maven-central: https://repo1.maven.org/maven2
콘솔이 뜨면 start 명령어로 기동#
start
추가로 필요한 파일들을 web에서 내려받은 다음 소스 파일들을 컴파일 후 운영 모드(production mode)로 실행합니다.
개발 모드(development mode)로 실행하고자 할 경우에는 start 명령어 대신에 run 명령어로 실행합니다.
주의사항: 설정 파일 및 데이터가 기본적으로 target/universal/stage 디렉터리에
저장됩니다. 이 디렉터리는 activator clean 실행 시 모두 삭제되므로, 아래의 옵션
설정방법을 보고 데이터가 저장될 디렉터리를 설정하시는 것이 좋습니다
브라우저로 접속#
http://127.0.0.1:9000
80 포트 등으로 포트를 변경하고 싶을 경우에는 해당 포트가 사용 가능한지 확인한 다음 80 포트를 사용할 수 있는 계정으로 실행합니다. 포트 변경 방법에 대해서는 '옵션' 문단을 읽어주세요.
업그레이드하기#
case1. git 클라이언트를 이용 (추천)
설치된 디렉터리에서, 아래와 같은 git 명령어를 이용합니다
git pull https://github.com/yona-projects/yona.git master
case2. 압축파일을 내려받을 경우
설치된 디렉터리에서, 최신 릴리즈의 압축파일을 내려받아 Yona가 설치된 디렉터리에 압축파일을 풉니다.
https://github.com/yona-projects/yona/archive/master.zip
주의사항! yona.h2.db
파일, repo
와 uploads
디렉터리를 삭제하거나 덮어쓰지 않도록 주의하세요!
윈도에서 업그레이드하는 경우, -DapplyEvolutions.default=true 설정이 필요할
수 있습니다. 자세한 것은 아래 옵션 설정 설명을 보세요
옵션#
배포버전 만들기#
activation dist
를 실행하시면 현재 소스를 기준으로 target/universal 폴더에 build.sbt 에 지정한 version 이름으로 배포용 zip 파일이 생성됩니다.
- 해당 파일은 linux/unix 용으로는 바로 압축 해제하셔서 사용할 수 있습니다.
- 단 윈도우용 배포파일은 조금 더 단계가 필요합니다.
- 압축을 푼다.
- bin/yona.bat 을 에디터로 연다
- APP_CLASSPATH 가 표시되어 있는 150번째 줄을 지운다 (실행파일 아래쪽에 한 번 더 나오기때문에 지워도 무방합니다.)
- 다시 압축을 해서 배포한다.
참고: https://www.playframework.com/documentation/2.3.x/ProductionDist