소스코드를 직접 내려 받아서 실행하기#

자신의 입맛에 맛게 코드를 직접 수정해서 작업하거나 코드를 기여하고 싶을 경우에는 코드 저장소로부터 코드를 직접 내려받아서 빌드/실행하는 것도 가능합니다.

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