이 문서는 Gerrit 코드(Code Review) 설치 가이드 4부인 Gerrit을 기본적으로 사용하기 위해서 설정해야할 부분에 대해서 설명한다.
1. 사용자 등록
먼저 Gerrit을 사용할 사용자를 등록한다. Gerrit을 사용할 사용자는 개발자가 될 수 있고, 단순히 코드를 리뷰하는 리뷰어가 될 수 있다. 두 사용자 모두 HTTP 인증으로 로그인되기 때문에 아래왁 같이 사용자를 추가한다.
사용자 추가
$ htpasswd ~/gerrit/etc/passwords "user"
Gerrit 접속
모든 사용자가 추가되면, http://gerrit.pseg.org 로 접속하여 로그인을 해당 사용자로 로그인을 수행한다.
최초 접속 시, 아래와 같이 Welcom to Gerrit Code Review 창이 나타난다. 아래를 참고하여 정보를 입력해준다.
Please review your contact information :
Full Name과 Preferred Email을 등록하여 이메일 인증을 한다.
이때, Gerrit에 smtp 설정이 잘못되어 있으면, 인증이 되지 않는다.
Register an SSH public key :
SSH Key를 발행하여, 입력한다. 이 SSH key를 통해 Gerrit에 리뷰를 요청할 수 있고, Git에 등록하게 된다.
SSH Key를 생성하는 방법은 Git Bach에서 아래를 수행하면 된다.
$ ssh-keygen
나타나는 key 값을 복사해서 Add SSH Public Key로 붙여 넣는다.
2. 프로젝트 생성
사용자가 생성되면, admin으로 프로젝트를 생성한다.
Project 메뉴에서 Create New Project를 선택하면, Create Project 페이지가 나타나면, 아래와 같이 입력한다.
- Project Name : 프로젝트 이름을 입력.
- Rights Inherit From : Browse 버튼을 선택하여, All-Projects에서 상속 받게 함.
- Create initial empty commit 을 체크.
Create Project 버튼을 선택하여 프로젝트를 생성한다.
3. 프로젝트 그룹 생성
People 메뉴에서 Create New Group 메뉴를 선택한다. TestGroup을 입력하고 Create Group를 클릭한다.
생성된 TestGroup에 프로젝트에서 코드를 수정하고 리뷰를 수행할 Members를 추가한다.
4. 프로젝트 클론 및 작업
TestGroup에 포함된 사용자로 프로젝트를 클론한다. 프로젝트를 클론하기 위한 주소는 프로젝트의 General에서 확인할 수 있다.
다음과 같이 입력하여 소스코드에 작업하고 commit을 수행한다.
$git commit -a -m "Test"
다음과 같이 입력하여 리뷰를 요청한다.
$git review
만약 No '.gitreview' file found in this repository 가 발생하면, 아래와 같이 .gitreview 파일을 생성해준다.
[gerrit]host=gerrit.pseg.orgport=29418project=TestProject.gitdefaultbranch=master
5. Reviewer 설정
Gerrit 사이트에 접속을 하면, All > Open에서 방금 남긴 Review를 확인할 수 있다.
아래 화면과 같이 리뷰를 수행할 리뷰어를 선택하고, Add Reviewer를 클릭한다.
리뷰를 수행하기 위해서는 하단의 소스코드 리스트를 보고, 클릭해가며 확인할 수 있다.
최종적인 리뷰는 Patch Set 아래의 Review 버튼을 클릭한다. 코드 리뷰에 대한 점수를 선택하면 된다.
이때 2점이 되게되면, 코드는 Git으로 Commit 되게 된다.
이로써, Gerrit을 사용할 기본적인 설정에 대한 설명은 끝났다. 이 게시물을 통해 수행하는데 발생하는 문제나 추가적인 질문이 있을 경우에는 댓글이나 Community에 남겨주기를 바란다.
