eungjun-yi / yona

Project Hosting SW

[English]

Yona

21세기 협업 개발 플랫폼

DEMO: http://repo.yona.io

Official Site: http://yona.io

Yona?

Yona는 팀이 업무와 개발을 진행하는데 그 속도와 효율을 증가시키기 위해 만들어졌습니다.

• 이슈 트래커: 기간이나 마일스톤과 함께 업무를 관리할 수 있는 이슈 트래커
  • 특히 내 이슈 기능은 업무처리를 통합된 화면에서 보고, 해야 할 일 / 언급된 일 등에 집중해서 쉽고 편하게 관리할 수 있습니다.
• 게시판: 각종 문서나 파일을 쉽게 공유할 수 있는 게시판
• 코드 저장소: 코드 개발에 필요한 Git / SVN 저장소 기능
• 코드 주고받기(Pull request): 협업 개발을 위한 코드 주고받기(Pull request)
• 코드 리뷰: 블럭 단위로 코멘트를 남길 수 있으며 리뷰 진행 여부를 확인 가능한 강력한 코드 리뷰 기능
• 그룹(Organization): 일정 멤버들이 여러개의 프로젝트를 그룹으로 관리 수 있게 도와주는 강력한 그룹(Organization) 기능
• 메일 연동: 각종 이벤트들을 설정에 따라 메일로 받을 수 있으며 또한 메일로 이슈나 댓글을 등록할 수 있습니다.

등을 비롯하여 일상적인 업무에서 개발 전반에 이르는 다양한 기능을 포함하고 있습니다.

왜 Yona를 써야 하나요? (Why Yona?)

• 왜 Yona를 써야 하나요? (Why Yona?)
• 기본 워크플로우

라이선스

Yona는 Apache 2.0 라이선스로 제공됩니다.

이어지는 설치 및 실행, 백업 등등에 대한 자세한 설명은 Wiki에 따로 세분화되어 정리되어 있습니다.

Yona 설치 및 실행

Yona 배포판

현재 Yona는 버전별로 두 개의 배포판을 릴리즈 메뉴를 통해 제공하고 있습니다.

• MariaDB 버전
  • 기본 권장 버전
  • yona-v1.3.0-bin.zip 같은 형식으로 파일로 배포
  • DB 설치에 약간의 시간이 필요하지만 안정적으로 운영이 가능
• H2 DB 내장형
  • DB 설정없이 내려받아서 바로 실행해서 쓸 수 있는 버전
  • yona-h2-v1.3.0-bin.zip 같은 형식으로 파일로 배포
  • USB 등에 담아서 이동해가면서 사용하거나 작업후 통째로 zip으로 묶어서 들고 다니는 것이 가능함
  • 대규모 사이트에서 사용하기에는 적합하지 않음. 참고: Yona가 MariaDB를 기본 DB로 사용하게 된 이유

Yona 설치

Yona는 기본적으로 다음 2단계로 설치됩니다.

• MariaDB 설치
• Yona 설치

만약 Docker를 이용해 설치하실분은 pokev25 님의 https://github.com/pokev25/docker-yona 를 이용해주세요

Yona 실행 및 업그레이드/백업 및 복구/문제 해결

• 실행 및 재시작 방법
• 안정적인 운영을 위한 실행 옵션들
• 업그레이드
• 백업 및 복구
• 알림메일 발송 기능 설정
• 발생 가능한 문제상황들과 해결방법

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

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

서버 관련 설정들

• application.conf 설명
• 소셜 로그인 설정

[[한국어]](#korean) Yona ======= Yona is a web-based project hosting software.

What is Yona?

Yona is designed to increase the speed and efficiency of your team's work and development.

• Issue tracker to manage bugs and issues
• Bulletin board to share documents
• Git/SVN support embedded
• Pull-request for collaborative coding
• Block based code review

Yona Distribution

Currently, Yona offers two distributions per version.

MariaDB Version

• Recommended version.
• Distributed as a file in the similar format as yona-v1.3.0-bin.zip
• It takes a little effort to install DB, but it can be operated stably.

Embedded H2 DB Version

• Portable version that can be downloaded and run immediately. No need to setting a DB.
• Distributed as a file in the similar format as yona-h2-v1.3.0-bin.zip
• It can be used portable. For example, along with USB etc. And it can be carried around with zip as a whole of work.  - Not suitable for large-scale team. (over 500 people)

How to install

Basically, Yona installation is in two steps:

• MariaDB install
• Yona install

If you want to use Docker, See https://github.com/pokev25/docker-yona by pokev25

Yona Start/Upgrade/Backup/Trouble Shootings

• Start and Restart
• Start Options for stable operation
• Upgrade
• Backup/Restore
• Mail settings for Notification
• Trouble Shootings

Server Settings

• application.conf Settings
• Social Login Settings

Contribution

Welcome anytime!

License

Copyright Yona Authors and NAVER Corp. under the Apache License, Version 2.0