[Deprecated]
์ด ํ๋ก์ ํธ๋ ๋ ์ด์ ์ ์ง๋ณด์ ๋๊ฑฐ๋ ์ง์์ด ์ ๊ณต๋์ง ์์ต๋๋ค.
์๋ก์ด ์ด์๋ pull request๋ฅผ ๋ฐ์ง ์์ต๋๋ค.
This project will no longer be maintained or supported.
Please do not file issues or pull-requests against this repo.
Yobi fork version์ธ Yona๊ฐ ๊ฐ์ธ ํ๋ก์ ํธ๋ก ์ด์ด์ ์ด์๋๊ณ ์์ผ๋ ์ฐธ๊ณ ๋ถํ๋๋ฆฝ๋๋ค.
[ํ๊ตญ์ด] Yobi
===Yobi is a web-based project hosting software.
What is Yobi?
Yobi is a web-based project hosting software. To increase productivity and quality of your software Yobi offers many features including
- Issue tracker to manage bugs and issues
- Bulletin board to share documents
- Git/SVN support embedded
- Pull-request for collaborative coding
License
Copyright 2015 NAVER Corp. under the Apache License, Version 2.0
How to install
Install from binary
Install
Download the latest version of Yobi from http://yobi.io/yobi.zip and unzip it. If you have wget and unzip:
wget http://yobi.io/yobi.zip
unzip yobi.zip
Start
Go the directory and start Yobi. If the directory is yobi-1.0.0:
cd yobi-1.0.0
bin/yobi
Note: If you are using Windows, run "bin/yobi.bat" instead of "bin/yobi".
Open http://127.0.0.1:9000 with your web browser then you can see the welcome page.
Upgrade
Download the latest version of Yobi and unzip it.
Note: Don't overwrite or delete yobi.h2.db
file, repo
& uploads
directory!
Build from source
Check JDK version
java -version
javac -version
JDK version 7(1.7) or 8(1.8) is required.
Download Play Activator
curl -O http://downloads.typesafe.com/typesafe-activator/1.2.10/typesafe-activator-1.2.10-minimal.zip
or
wget http://downloads.typesafe.com/typesafe-activator/1.2.10/typesafe-activator-1.2.10-minimal.zip
or using web browser (for windows)
http://downloads.typesafe.com/typesafe-activator/1.2.10/typesafe-activator-1.2.10-minimal.zip
Unzip
unzip typesafe-activator-1.2.10-minimal.zip
Change directory to unzipped directory
cd activator-1.2.10-minimal
Download Yobi
Case1. using git client (recommended)
git clone https://github.com/naver/yobi.git
or
Case2. Just download latest stable release If you want to download one of the stable releases, you can download a compressed file by clicking the URL below. And then name it a yobi and unzip it.
https://github.com/naver/yobi/archive/master.zip
Caution! in case2, You might come across troubles when you try to upgrade Yobi.
You can locate your own Yobi directory in any other place. Please note that you must add Play Activator home path to $PATH environment in that case.
Change directory to cloned Yobi directory (or cd to your unzipped file directory)
cd yobi
Run Play Activator
../activator
or (for windows)
..\activator
Required files will be download automatically. In the first time, it may take about 10 min or more.
Type start command in console
start
It will downloaded addtional files and compile sources.
If you want to run Yobi in development mode, use run. You can see more detailed errors and can use dynamic compilation.
Connect with browser
http://127.0.0.1:9000
If you want to change port, check your permission to use 80 port. See 'Options' section for more information.
Upgrade Yobi
Case1. using git client (recommended) In installed directory, just type git update command.
git pull https://github.com/naver/yobi.git master
Case2. download zip file
In installed directory, download latest release file and unzip it.
https://github.com/naver/yobi/archive/master.zip
Be careful! Don't overwrite or delete yobi.h2.db
file, repo
& uploads
directory!
If you are installing Yobi in Windows system, you may need set applyEvolutions.default
Java property to true. See 'Options' section for more information
Options
When start yobi, You can specify the home directory to contain data for Yobi.
If you want to use /home/user/.yobi
as the home directory, set 'yobi.home'
property as follows:
bin/yobi -Dyobi.home=/home/user/.yobi
Note: Yobi doesn't load the configuration files from the home directory. If you want to do that, specify the path to the config files as follows:
bin/yobi -Dyobi.home=/home/user/.yobi -Dconfig.file=/home/user/.yobi/conf/application.conf -Dlogger.file=/home/user/.yobi/conf/application-logger.xml
You can also specify Java options with _JAVA_OPTIONS
environment variable. If
the memory of your system equals to or greater than 4GB, we recommend to start
Yobi as follows:
_JAVA_OPTIONS="-Xmx2048m -Xms2048m" activator "start -DapplyEvolutions.default=true -Dhttp.port=9000"
Linux and OSX
When start yobi, you can specify the home directory to contain data, the
database file and configiuration files for Yobi. For example, if you want to
use /home/user/.yobi
as the home directory, set YOBI_HOME as follows:
YOBI_HOME=/home/user/.yobi bin/yobi
You can also specify Java options with _JAVA_OPTIONS
environment variable. If
the memory of your system equals to or greater than 4GB, we recommend to start
Yobi as follows:
_JAVA_OPTIONS="-Xmx2048m -Xms2048m" bin/yobi
Yobi use 9000 port for HTTP connection by default. If you want to use another port, set http.port Java property.
_JAVA_OPTIONS="-Dhttp.port=80" bin/yobi
Windows
When start yobi, you can specify the data directory, the config file, the config file for logger with yobi.home, config.file and logger.file as follows:
SET JAVA_OPTS=-Dyobi.home=/home/user/.yobi -Dconfig.file=/home/user/.yobi/conf/application.conf -Dlogger.file=/home/user/.yobi/conf/application-logger.xml
bin\yobi.bat
You can specify the database file in application.conf
as follows:
db.default.url="jdbc:h2:file:/home/nori/.yobi/yobi"
You can also specify Java options with _JAVA_OPTIONS
environment variable. If
the memory of your system equals to or greater than 4GB, we recommend to start
Yobi as follows:
SET JAVA_OPTS=-Xmx2048m -Xms2048m
bin\yobi.bat
Yobi use 9000 port for HTTP connection by default. If you want to use another port, set http.port Java property.
_JAVA_OPTIONS=-Dhttp.port=80
bin\yobi.bat
If you are upgrading Yobi from the previous version, the upgrade may fail with a warning message that says you need migration as follows:
[warn] play - Your production database [default] needs evolutions!
In such case, set applyEvolutions.default
Java property to true and restart
Yobi.
SET JAVA_OPTS=-DapplyEvolutions.default=true
bin\yobi.bat
For more information about options
See http://www.playframework.com/documentation/2.3.6/Production.
Backup
Copy the below file and directories to another place.
file: yobi.h2.db
directory: repo, uploads
for korean
Yobi
ํ์ ๊ฐ๋ฐ ํ๋ซํผ
Official Site: http://yobi.io
Yobi ์๊ฐ
Yobi (๊ตฌ nFORGE)๋ ํ์ ๊ฐ๋ฐ์ ์ํ ํ๋ก์ ํธ ํธ์คํ SW์ ๋๋ค.
- ๋ฒ๊ทธ๋ ์ด์์ ๊ด๋ฆฌํ ์ ์๋ ์ด์ ํธ๋์ปค
- ๊ฐ์ข ๋ฌธ์์ ์ ๋ณด๋ฅผ ๊ฐํธํ๊ฒ ๊ณต์ ํ ์ ์๋ ๊ฒ์ํ
- ์์ค์ฝ๋์ ๋ณ๊ฒฝ๋ด์ญ์ ํธ๋ฆฌํ๊ฒ ๊ด๋ฆฌํ ์ ์๋ ํ์๊ด๋ฆฌ ๋๊ตฌ git/svn ๊ธฐ๋ณธ ๋ด์ฅ
- ํ์ ๊ฐ๋ฐ์ ์ํ ์ฝ๋ ์ฃผ๊ณ ๋ฐ๊ธฐ
๋ฑ์ ๋น๋กฏํ์ฌ ํ ๊ฐ๋ฐ์ ์ํ ๋ค์ํ ๊ธฐ๋ฅ์ ํฌํจํ๊ณ ์์ต๋๋ค.
๋ผ์ด์ ์ค
Yobi๋ Apache 2.0 ๋ผ์ด์ ์ค๋ก ์ ๊ณต๋ฉ๋๋ค.
์ค์นํ๊ธฐ
๋ค์ด๋ฐ์ ์ค์นํ๊ธฐ
์ค์น
Yobi ์ต์ ๋ฒ์ ์ http://yobi.io/yobi.zip ์์ ๋ค์ด๋ฐ์ ์์ถ์ ํ๋๋ค. ์๋ฅผ ๋ค์ด wget์ผ๋ก ๋ฐ์์ unzip์ผ๋ก ์์ถ์ ํผ๋ค๋ฉด:
wget http://yobi.io/yobi.zip
unzip yobi.zip
์คํ
์์ถ์ด ํ๋ฆฐ ๋๋ ํ ๋ฆฌ๋ก ์ด๋ํด์ yobi๋ฅผ ์คํํฉ๋๋ค. ๋๋ ํ ๋ฆฌ๊ฐ yobi-1.0.0 ์ด๋ผ๋ฉด:
cd yobi-1.0.0
bin/yobi
์ฃผ์: ์๋์ฐ ์ฌ์ฉ์๋ bin/yobi ๋์ bin/yobi.bat์ ์คํํด์ผํฉ๋๋ค.
์ด์ ์น ๋ธ๋ผ์ฐ์ ๋ก http://127.0.0.1:9000 ์ ์ ์ํ๋ฉด ํ์ ํ์ด์ง๋ฅผ ๋ณด์ค ์ ์์ต๋๋ค.
์ ๊ทธ๋ ์ด๋
์ค์นํ ๋์ ๋๊ฐ์ด, ์ต์ ๋ฒ์ ์ ๋ด๋ ค๋ฐ์ Yobi๊ฐ ์ค์น๋ ๋๋ ํฐ๋ฆฌ์ ์์ถํ์ผ์
ํ๋๋ค. ์ฃผ์์ฌํญ! yobi.h2.db
ํ์ผ, repo
์ uploads
๋๋ ํฐ๋ฆฌ๋ฅผ ์ญ์ ํ๊ฑฐ๋
๋ฎ์ด์ฐ์ง ์๋๋ก ์ฃผ์ํ์ธ์!
์์ค ์ฝ๋์์ ๋น๋ํ๊ธฐ
JDK version ํ์ธ
java -version
javac -version
JDK 7(1.7) ํน์ 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 activator-1.2.10-minimal
Yobi ์์ค ๋ด๋ ค ๋ฐ๊ธฐ
case1. git ํด๋ผ์ด์ธํธ๋ฅผ ์ด์ฉํ ๋ค์ด๋ก๋ (์ถ์ฒ)
git clone https://github.com/naver/yobi.git
case2. ๋จ์ํ ์ต์ ์์ ๋ฒ์ ์ ๋ด๋ ค๋ฐ๊ณ ์ ํ ๋๋ ์๋ ๋งํฌ๋ฅผ ์ด์ฉํด์ ์์ถํ์ผ์ ๋ด๋ ค๋ฐ์ ๋ค์ yobi๋ฅผ ํด๋์ด๋ฆ์ผ๋กํด์ ํด์ ํฉ๋๋ค.
git pull https://github.com/naver/yobi.git master
์ฃผ์! case2์ ๊ฒฝ์ฐ, ์ ๊ทธ๋ ์ด๋๋ฅผ ํ ๋ ๋ฌธ์ ๊ฐ ์๊ธธ ์ ์์ต๋๋ค.
์์์ ์ฅ์์ Yobi ๋๋ ํฐ๋ฆฌ๋ฅผ ์์น์ํฌ ๊ฒฝ์ฐ์๋ activator ์คํํ์ผ์ด ์๋ Play Activator ๋๋ ํฐ๋ฆฌ๋ฅผ $PATH ํ๊ฒฝ๋ณ์์ ์ถ๊ฐํด ์ฃผ์ธ์.
clone ๋ฐ์ Yobi ๋๋ ํฐ๋ฆฌ๋ก ์ด๋
(ํน์ ์์ถ์ ํด์ ํ ๋๋ ํฐ๋ฆฌ๋ก ์ด๋)
cd yobi
์๋จ์ ์๋ activator ์คํํ์ผ ์คํ
../activator
ํน์ (์๋์ฐ ์ฌ์ฉ์์ผ ๊ฒฝ์ฐ)
..\activator
์คํํ๋ฉด ํ์ํ ํ์ผ๋ค์ web์์ ๋ด๋ ค๋ฐ์ต๋๋ค. ์ฒซ ์คํ์ ๋คํธ์ํฌ ์ํฉ์ ๋ฐ๋ผ 10์ฌ๋ถ ๊ฐ๊น์ด ์์๋ ์ ์์ต๋๋ค.
์ฝ์์ด ๋จ๋ฉด 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/naver/yobi.git master
case2. ์์ถํ์ผ์ ๋ด๋ ค๋ฐ์ ๊ฒฝ์ฐ
์ค์น๋ ๋๋ ํฐ๋ฆฌ์์, ์ต์ ๋ฆด๋ฆฌ์ฆ์ ์์ถํ์ผ์ ๋ด๋ ค๋ฐ์ Yobi๊ฐ ์ค์น๋ ๋๋ ํฐ๋ฆฌ์ ์์ถํ์ผ์ ํ๋๋ค.
https://github.com/naver/yobi/archive/master.zip
์ฃผ์์ฌํญ! yobi.h2.db
ํ์ผ, repo
์ uploads
๋๋ ํฐ๋ฆฌ๋ฅผ ์ญ์ ํ๊ฑฐ๋ ๋ฎ์ด์ฐ์ง ์๋๋ก ์ฃผ์ํ์ธ์!
์๋์์ ์ ๊ทธ๋ ์ด๋ํ๋ ๊ฒฝ์ฐ, -DapplyEvolutions.default=true ์ค์ ์ด ํ์ํ ์ ์์ต๋๋ค. ์์ธํ ๊ฒ์ ์๋ ์ต์ ์ค์ ์ค๋ช ์ ๋ณด์ธ์
์ต์
Linux, OSX์ ๊ฒฝ์ฐ
YOBI_HOME
์์ฑ์ ํตํด Yobi๊ฐ ๋ฐ์ดํฐ, ๋ฐ์ดํฐ๋ฒ ์ด์ค, ์ค์ ํ์ผ์ ๋ถ๋ฌ์ค๊ณ ์ ์ฅํ
ํ ๋๋ ํ ๋ฆฌ๋ฅผ ์ง์ ํ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค์ด, /home/user/.yobi๋ฅผ ํ ๋๋ ํ ๋ฆฌ๋ก
์ฌ์ฉํ๋ ค๋ฉด Yobi๋ฅผ ์์ํ ๋ ๋ค์๊ณผ ๊ฐ์ด ์ง์ ํฉ๋๋ค.
YOBI_HOME=/home/user/.yobi bin/yobi
_JAVA_OPTIONS
ํ๊ฒฝ๋ณ์๋ฅผ ์ด์ฉํด ์๋ฐ ํ๊ฒฝ ๋ณ์๋ฅผ ์ง์ ํ ์๋ ์์ต๋๋ค. ์์คํ
๋ฉ๋ชจ๋ฆฌ๊ฐ 4๊ธฐ๊ฐ ์ด์์ด๋ผ๋ฉด, ๋ค์๊ณผ ๊ฐ์ ์ต์
์ผ๋ก ์คํํ๋๊ฑธ ๊ถ์ฅํฉ๋๋ค.
_JAVA_OPTIONS="-Xmx2048m -Xms2048m" bin/yobi
๊ธฐ๋ณธ์ ์ผ๋ก 9000๋ฒ ํฌํธ๋ฅผ ์ฌ์ฉํ์ง๋ง, ๋ค๋ฅธ ํฌํธ๋ฅผ ์ฌ์ฉํ๊ณ ์ถ๋ค๋ฉด http.port ์๋ฐ ํ๊ฒฝ๋ณ์๋ฅผ ์์ ํฉ๋๋ค.
_JAVA_OPTIONS="-Dhttp.port=80" bin/yobi
Windows์ ๊ฒฝ์ฐ
Yobi๋ฅผ ์์ํ ๋, ๋ฐ์ดํฐ ๋๋ ํ ๋ฆฌ, ์ค์ ํ์ผ, ๋ก๊ทธ ์ค์ ํ์ผ์ ์์น๋ฅผ ๊ฐ๊ฐ yobi.home, config.file, logger.file ์๋ฐ ํ๋กํผํฐ๋ก ์ง์ ํ ์ ์์ต๋๋ค.
SET JAVA_OPTS=-Dyobi.home=/home/user/.yobi -Dconfig.file=/home/user/.yobi/conf/application.conf -Dlogger.file=/home/user/.yobi/conf/application-logger.xml
bin\yobi.bat
๋ฐ์ดํฐ๋ฒ ์ด์ค๊ฐ ์ ์ฅ๋ ํ์ผ์ ๋ค์๊ณผ ๊ฐ์ด application.conf ์ค์ ํ์ผ์์ ์ง์ ํ ์ ์์ต๋๋ค.
db.default.url="jdbc:h2:file:/home/nori/.yobi/yobi"
_JAVA_OPTIONS
ํ๊ฒฝ๋ณ์๋ฅผ ์ด์ฉํด ์๋ฐ ํ๊ฒฝ ๋ณ์๋ฅผ ์ง์ ํ ์๋ ์์ต๋๋ค. ์์คํ
๋ฉ๋ชจ๋ฆฌ๊ฐ 4๊ธฐ๊ฐ ์ด์์ด๋ผ๋ฉด, ๋ค์๊ณผ ๊ฐ์ ์ต์
์ผ๋ก ์คํํ๋๊ฑธ ๊ถ์ฅํฉ๋๋ค.
SET JAVA_OPTS=-Xmx2048m -Xms2048m
bin\yobi.bat
๊ธฐ๋ณธ์ ์ผ๋ก 9000๋ฒ ํฌํธ๋ฅผ ์ฌ์ฉํ์ง๋ง, ๋ค๋ฅธ ํฌํธ๋ฅผ ์ฌ์ฉํ๊ณ ์ถ๋ค๋ฉด http.port ์๋ฐ ํ๊ฒฝ๋ณ์๋ฅผ ์์ ํฉ๋๋ค.
_JAVA_OPTIONS=-Dhttp.port=80
bin\yobi.bat
์ ๊ทธ๋ ์ด๋๋ฅผ ํ๋ ๊ฒฝ์ฐ ๋ค์๊ณผ ๊ฐ์ด ๋ฐ์ดํฐ๋ฒ ์ด์ค ์คํค๋ง ๋ง์ด๊ทธ๋ ์ด์ ์ด ํ์ํ๋ค๋ ๊ฒฝ๊ณ ๋ฉ์์ง์ ํจ๊ป ์คํ์ด ๋์ง ์๋ ์ํฉ์ ๊ฒช์ ์ ์์ต๋๋ค.
[warn] play - Your production database [default] needs evolutions!
๊ทธ๋ฐ ๊ฒฝ์ฐ์๋ ์๋์ผ๋ก ๋ง์ด๊ทธ๋ ์ด์ ์ด ๋๋๋ก ๋ค์๊ณผ ๊ฐ์ด applyEvolutions.default ์๋ฐ ํ๋กํผํฐ๋ฅผ true๋ก ์ค์ ํฉ๋๋ค.
SET JAVA_OPTS=-DapplyEvolutions.default=true
bin\yobi.bat
์ต์ ์ ๋ํ ๋ ์์ธํ ์ค๋ช
http://www.playframework.com/documentation/2.3.6/Production ๋ถ๋ถ์ ํ์ธํด ์ฃผ์ธ์.
๋ฐฑ์ ํ๊ธฐ
ํน๋ณํ ์ธ๋ถ DB๋ฅผ ์ฌ์ฉํ์ง ์๋๋ค๋ฉด ์๋ ๋ด์ฉ์ ์ ๋ฐฑ์ ํด์ ๋ณด๊ดํด ์ฃผ์๋ฉด ๋ฉ๋๋ค.
file: yobi.h2.db
directory: repo, uploads