머가필요해

Nginx 환경에서 gitweb 구동은 아직 성공은 못했다.
누군가 성공하신 분이 계시면 알려주시면 대단히 감사하겠다는....

일단 기본적인 사항에 대해서는 지난 포스팅을 참고하길 바란다.
     - http://whatwant.tistory.com/397


1. Git 준비 (gitweb 준비)

     - Git을 소스코드 설치를 하셨다면 기본적인 준비는 모두 되어있는 것이다.
     - http://whatwant.tistory.com/289



2. Apache2 준비

     - 간단하게 그냥 패키지로 설치하자.




3. 경로 정리

     - 개인적인 취향이 반영된 부분이지만... 여하튼 경로를 정리해보자.
     - git 을 소스설치한 경로는 다음과 같다. [ /srv/install/git/git-1.7.11.2 ]




4. VirtualHost 생성

     - default 사이트는 삭제하고, 포트 변경해서 생성해보자.



     - 위 설정과 같이 8080 포트로 gitweb을 구동하고자 한다.



     - sites 설정을 맞추자




5. gitweb.conf

     - gitweb 환경설정을 해보자.





6. gitweb + gitolite

     - 기본적으로 gitolite를 적용한 환경에서 그냥 gitweb을 연결하면 testing.git repository밖에 안보인다.
     - 그래서 별도의 과정을 추가로 진행하여야 한다.


     - UMASK 기본 값을 변경해야 한다.
     - 이와 관련된 설정 파일은 gitolite를 설치한 repository를 관리하기 위한 계정에 있다.




이제 8080 포트로 웹사이트 접속을 하면 된다~!!!

Git을 사용하게 되면 따라오는 가장 유명한 도구들이 두 가지가 있다.
하나는 앞에서 살펴본 계정 관리를 위한 Gitolite,
다른 하나는 코드 리뷰를 위한 Gerrit 이다.

특징은 Gitolite, Gerrit 두 가지 모두 Git 전용의 도구들이다.

Google에서 사용하고 있는 코드 리뷰 도구라고 해서 Git의 인기와 함께 각광을 받고 있는 Gerrit !!!

"코드 리뷰" 도구 시장에는 아직 세상을 통일한 절대 막강 도구가 마땅히 없다.
야후에서 사용한다고 하여 유명한 "리뷰 보드(Review Board)"가 있지만, Git 지원은 아직 기본적인 수준이다.

현재 현장 분위기는 Git을 사용한다면 코드 리뷰는 당연히 Gerrit을 사용한다고 생각하고 있다.



이번 포스팅을 위해서 몇 일을 날려가며 엄청 고생을 했다.
아무리 생각해도 이런 빈약한 자료들을 가지고도 Gerrit을 셋팅해서 잘 사용하시는 분들은 전부 고수들인가보다.
범인 수준인 필자는 정말 엄청 개고생(?)을 해서야 겨우 Gerrit 화면을 볼 수 있었다.

하지만, 언제나 그렇지만 성공하고나서 보면... 별것도 아닌 수준이었는데....라는 생각이 든다 ^^



1. Ready

     - Gerrit을 사용하기 위해서는 다음의 조건이 필요하다.
          ▷ JDK          : version 1.6 이상
          ▷ Database  : Gerrit 내장 H2, 또는 MySQL, PostgreSQL

     - JDK 설치는 다음의 포스팅으로 따라하면 된다.
     - http://whatwant.tistory.com/438

     - Gerrit 자체도 두 가지 방식으로 다운로드 받을 수 있다.
          ▷ Binary  : Jenkins와 같이 *.war 파일로 다운로드 받을 수 있다.
          ▷ Source : 빌드하여 바이너리로 직접 만들 수 있다. Apache Maven으로 빌드할 수 있다.

     - 좋은건지 나쁜건지 모르겠지만, 버전업이 상당히 빠른 Gerrit이다.
     - 안전성을 올리기 위한 것이라면 그나마 괜찮은데, 기능적인 면까지 많이 바뀌는 버전업이라 부담스럽기도 하다.



2. Download

     - 굳이 빌드를 수행할 필요없이 *.war 파일로 다운로드 받자.

     - 포스팅을 하던 중에 업그레이드가 계속 되어 결국 스크린샷도 새로 만들어야 했다는... ^^



3. PostgreSQL

     - 이 블로그를 계속 봐오신 분들이라면 아시겠지만, 개인적으로 PostgreSQL을 사랑하는 것을 아실것이다!
     - postgresql이 설치되어있지 않은 경우엔, 그냥 [ sudo apt-get install postgresql ] 실행하면 된다.

     - Gerrit을 위한 PostgreSQL 계정과 db를 만들어줘야 한다.

     - 위와 같이 깔끔하게 끝~



4. Gerrit User

     - 참고로 Gerrit의 현재 버전은 version 2.4.1 이다. 그래서 그런지 Gerrit도 그냥 부르지 않고, Gerrit2 라고 한다.
     - Gerrit2를 위한 계정을 하나 만들고 그 계정에 모두 맞추자.

     - "gerrit2" 계정을 만들고 gerrit-2.4.1.war 파일을 해당 계정 소유로 만든 후 gerrit2 계정으로 su하자.




5. apache

     - 이번에는 웹서버로 apache로 셋팅을 해보겠다.
     - 나중에 시간이 잠시나면 꼭 nginx 환경에서 다시 해보도록 하겠다.

 

     - 설치를 했으면 확인을 하자.

     - Gerrit에서는 웹서버의 proxy 기능을 요구한다.

 

     - apache2의 proxy 모듈을 추가로 설치를 해주고,

     - 웹서버 준비는 여기까지 끝~



6. Gerrit Install

     - 이제 준비 작업은 모두 끝났다. 설치를 진행하면 된다.

     - Gerrit의 기본적인 구성은 Jenkins와 같은 *.war 파일 구동방식이다.
     - 차이가 있다면, init 과정이 있다는 점 정도?!

 

     - 설치과정을 진행하기 전에 권한을 맞추기 위한 선행 준비를 먼저 하자.

     - 위에서 명시한 디렉토리는 gerrit2 계정 권한으로 미리 만들어 두었다.

     - 이어서 계속 진행하자.

     - 인증 방식은 [ http ]로 정했다.
     - SMTP 설정은 gmail을 활용하기로 정했다. (이메일 주소는 살짝 지웠다 ^^ 다 알겠지만서도...)

 

     - 나중에 설정 내용은 변경할 수 있으므로 최대한 기본값으로 정했다.

     - 그런데, 마지막 줄이 마음에 걸린다. [ No protocol specified ]




7. Configuration

     - 여기에서 바로 Gerrit이 실행되면 좋겠는데, 몇 가지 더 설정할 것들이 많다.

     - 앞에서도 언급을 했지만, 우리는 Apache의 Proxy를 활용하여 Gerrit을 띄울 것이다.
     - 그리고 Apache의 http authentication을 적용할 것이다.

     - 우선 관리자 계정 하나를 만들어 넣자.

     - 앞의 설치 과정을 통해 만들어진 gerrit site 의 etc 디렉토리에 passwords 파일을 생성하는 것이다.
     - 앞으로 Gerrit 웹페이지는 이 파일을 이용하여 인증을 하게 된다.

     - Apache의 VirtualHost도 설정을 해주자.

     - 위에서 각 포트가 중요한데, VirtualHost 에서는 8081 포트를 사용하고
     - Proxy에서는 8080 포트를 사용한다.

     - 추가로 sites-enabled 디렉토리에 동적링크도 만들어주자.

     - 위와 같이 설정을 하였으면 Apache의 port 설정에도 추가해줘야 한다.

     - 위와 같이 8081 포트에 대해서 설정을 추가로 적어주면 된다.

     - gerrit 의 설정값도 다시 한 번 살펴봐야 한다.

     - 위에서 빨간색으로 표시한 부분만 수정, 추가하면 된다.



8. restart

     - 재시작을 한 번 해보자.

     - 이제 웹으로 확인을 해보자.

     - [ http://localhost:8081 ] 주소로 접속을 하면 위와 같이 이름과 암호를 물어본다.
     - 앞에서 "htpasswd"로 만든 계정을 이용해서 로그인하면 된다.

     - 드디어 길고 긴 과정을 거쳐서 gerrit의 화면이 나왔다.



9. Sign Out

     - 이렇게 설치를 했는데, 가장 원초적인 문제가 있다. 바로 [ Sign Out ]이 동작하지를 않는다.

     - 앞에서 [ gerrit.conf ] 파일을 수정할 때 넣은 [ canonicalWebUrl = http://localhost:8081/ ] 때문에 발생했다.
     - 하지만, 그 부분을 없애면 기본적인 동작도 하지 않는다.

     - 이 부분에 대한 해결책은 아직 찾지 못했다.
     - 찾게 되는 즉시 업데이트하도록 하겠다.

나름의 목적을 가지고 열심히 포스팅을 하고 있는 블로그이지만,
댓글 하나 없이 몇 날 몇 일이 흐르면 조금 외롭게 되는데, 최근 댓글을 잘 달아주시는 분들이 생겨서 너무 좋다.
그런 감사한 분들 중 한 분이 알고 싶으시다는 내용이기도 하고 내가 하려고 했던 내용이기도 하다.


EGit에 대한 정보는 다음을 참조했다.
     - http://wiki.eclipse.org/EGit/User_Guide


여기에서 알아보고자 하는 내용은 바로 "Eclipse"에서 Git 사용하기!!!



01. Eclipse

     - 개발 환경으로 가장 유명한 도구 중 하나임은 다시 설명할 필요가 없을 것이다.
     - Java 기반의 프로그램으로써 한계를 고스란히 안고 있는 것 또한 사실이다. 무겁다는 말이다.

     - JDK 설치 먼저 해야하는 것은 당연하고...
        → http://www.oracle.com/technetwork/java/javase/downloads/index.html
     - Eclipse 역시 다운 받아서 설치, 아니 압축을 풀어주면 된다.
        → http://www.eclipse.org/downloads/



02. 확인

     - Eclipse에서 사용할 수 있는 Git plugin은 크게 JGit 과 EGit 두 가지가 있다.
     - 그런데, 예전에는 이 plug-in들을 별도로 설치를 해주어야 했지만 최근들어 이걸 기본적으로 제공해주고 있다.

     - 하지만, Eclipse Classic을 설치하면 포함이 안되어있다.

     - Import 하는 부분에 CVS는 있지만, Git은 안보인다.

03. 설치

     - GIt 관련 Plug-in이 내장되어있지는 않지만, 제공은 해주고 있다.

     - [ Help ] → [ Install New Software ]
     - Work with 부분에서 "Indigo"를 골라주자.

     - "Collaboration" 항목을 확장해서 "Eclipse EGit"을 선택하면 된다. 나머지 과정은 그냥 쓕쓕~

     - 설치를 마치고 나면, 재시작을 물어본다. 당연히 재시작해주면 된다.




04. Preference

     - EGit Plug-in의 환경 설정을 하자.

     - [ Window ] → [ Preference ]

     - "Team" → "Git" 항목을 선택하면 위와 같은 화면이 나온다.



05. User Settings

     - 개발 PC에서 Git을 사용하기 위해 환경을 맞출 때에 제일 먼저 해야할 것은 내가 누구인지 알려주는 것이다.

     - 기본적인 환경 설정에 대해서 잘 확인하고 입력해놓자.



06. SSH public key

     - 우리는 지금 Gitolite를 사용하고 있는 환경에 대해서 알아보고 있으므로 공개키를 등록해보자.

     - [ Git ] 항목이 아니라 [ General ] 항목에서 "Network Connections - SSH2" 부분에서 설정을 한다.
     - 앞 포스팅에서 "Git Bash"를 통해 "ssh-keygen"으로 키를 만들었으면 위와 같은 설정을 그대로 사용하면 된다.
     - 물론 만약 다른 경로에 위치하고 있다면, 그에 맞게 변경하면 된다.



07. Import

     - 이제 Remote Repository에 있는 프로젝트를 가져오는 과정에 대해서 알아보자.

     - [ File - Import ] 메뉴를 선택해서 나오는 창을 살펴보면 "Git"이라는 항목이 새로 나온 것이 확인된다.
     - "Projects from Git"을 선택하면 된다.

     - Remote Repository로 부터 받아올 것이니 당연히 "URI"를 선택하면 된다.

     - URI를 작성할 때에 바로 URI를 작성할 필요없이, 밑의 항목들을 입력하면 자동으로 URI가 완성된다.
     - Host, Repository path, Protocol(다시 한 번 ssh 선택해주면 된다), User를 입력해주자.
     - Password는 비워두면 된다. 왜냐하면, 우리는 SSH 공개키를 등록했기 때문이다.

     - 성공적으로 연결이 되면 branch를 선택하는 창이 나온다.

     - 어디에다가 파일들을 받을 것인지, 어느 branch로 시작을 할 것인지, Remote 이름을 확인하자.

     - 그러면 위와 같이 cloning 작업을 수행한다.

     - 다 받아오게 되면 위와 같이 받아온 소스코드를 프로젝트와 어떻게 연결할 것인지를 묻는 화면이 나온다.
     - 일단은 위 스크린샷과 같이 새로운 프로젝트로 만들어보자.

     - 받아온 소스코드 성격에 따라서 프로젝트 타입을 골라주면 된다.

     - 그리고, 프로젝트 名을 적어주면 된다.

     - 그러면, 이제 마무리가 되어야 하는데...

     - 뭔가 이상하지 않은가??????



08. Directory

     - 그렇다. 프로젝트를 만들었는데, 파일들이 안보인다.

     - 앞에서 살펴본 부분에서 Directory들을 한 번 살펴보면 이상한 원인이 보일 것이다.

     - 프로젝트를 만들 때 location을 확인해야 한다.
     - Remote Repository를 clone 받을 때에 지정했던 경로와 동일하게 설정을 해주어야 하는 것이다.

     - 이번에는 제대로 파일들이 보일 것이다!



09. Share Project

     - 그러면 Git 관련 작업을 할 때엔 어떻게 해야할까?!

     - [ Team - Share Project ]를 실행하면 창이 하나 나오는데...

     - 경고 메시지가 나온다. "HOME" 이라는 이름의 환경변수를 설정해야 한다는 말이다.

     - 하지만, 안내메시지처럼 알아서 기본 경로를 잘 잡아준다.
     - 귀찮으면 "Do not show again"을 체크함으로써 끝~

     - 공식 가이드에 의하면 Windows 7 환경에서는 "Users" 디렉토리의 대소문자 오류가 있으니 참고~!!

     - [ Use or create repository in parent folder of project ]에 체크를 하고 "Finish"를 해주면 된다.

     - 모두 설정하고 나면 오른쪽 버튼의 "Team" 항목에 위 스크린샷과 같이 새로운 메뉴가 나타난다.




여기까지~~~~~~
Eclipse 환경에 대해서 너무 길게 포스팅한 것 같지만... 그래도 좀 아쉬운 부분도 있다.



오늘은 이 블로그를 통해서 좋은 인연을 맺게 된 분과 처음으로 만났다.
그로 인해서 너무나 감사한 기회를 얻게 될 것 같은데... 뭔가 정해지면 다시 또 공유해보겠다.

포스팅을 할 때 가장 즐거운 일은 댓글을 확인하는 것이다 ^^
이번에는 저에게 너무나 큰 기쁨을 주는 댓글을 통해 문의하신 것 중 하나에 대해서 포스팅 해보고자 한다.

Gitolite에 대해서 어려워 하시는 분들의 대부분은 Gitolite 때문이 아니라,
SSH에 대한 이해와 더불어 공개키(public key)에 대한 사항 때문에 어려움을 겪게 된다.


Windows에서 공개키 만들고 등록하는 것은 Linux 환경에서 하는 것과 거의 동일하다.
그래도 다시 한 번 되돌아 보는 의미로 살펴보면서 공개키에 대해서 같이 살펴보도록 하겠다.



1. 공개키 등록하기

     - 새로운 사용자, 지금 상황에서는 Windows XP 환경의 사용자가 등록을 하고 싶은 경우를 살펴보자.

     - 왼쪽 하단의 'chaniXP'라는 이름의 사용자가 공개키를 만들어서,
       왼쪽 상단의 gitolite 관리자에게 보내면, 그 관리자가 등록 및 설정을 하고,
       오른쪽의 Server에 push를 하면,
       chaniXP 사용자는 Server로부터 허용된 repositories를 clone 받을 수 있게 되는 것이다.

     - 여기서 중요한 점은 chaniXP라는 사용자는 Server의 계정이 아니다.
     - Gitolite를 사용하게 되면, Server에서는 'git-repo'라는 계정 하나만 있으면 된다.




2. Git Bash

     - Windows 환경에서 Git 설치하기를 하셨다면, Git Bash가 있을 것이다.

     - 무슨 말인지 모르겠다면, 다음 포스팅을 참조하면 된다.
     - http://whatwant.tistory.com/288





3. Windows에서 공개키 만들기

     - Linux 때와 마찬가지로 [ ssh-keygen ]을 실행하여 공개키를 만들어주자.

     - Windows 환경에서도 분명히 사용자 이름이 있으며, home directory는 존재한다.
     - 그냥 엔터만 쳐도 잘 만들어진다.




4. 공개키 보내기

     - Gitolite 관리자에게 공개키를 보내서 등록해달라고 해야한다.
     - 여기에서는 gitolite라는 계정에게 scp를 통해서 공개키를 보내주도록 하겠다.

     - 중요한 점은 이전에도 한 번 언급했지만, 일반적으로 [ 계정명.pub ] 형식의 파일명을 사용한다는 것이다.




5. Gitolite 관리자

     - 이제부터는 Gitolite 관리자가 해야하는 일이다.

     - 우선은 새로운 파일이 잘 들어왔는지 확인을 하고, 그 계정에게 권한을 부여해주면 된다.

     - ./keydir directory 안에 [ chaniXP.pub ]라는 파일이 잘 들어왔는지 확인을 하고,
     - [ ./conf/gitolite.conf ] 환경 파일을 수정해주면 된다.

     - 공개키를 등록한다해도, 그 계정이 어느 repository에 권한을 갖는지 정해주지 않는다면 무용지물이다.




6. push

     - 제일 중요한 과정이다. 바로 서버에 해당 정보들을 보내주어야 모든 것이 이루어진다.

     - 위 스크린샷과 명령어 정리한 내용과 차이가 있다.

     - 정말 종종 실수하는 부분인데, 기존에 등록된 파일의 수정이 아니라 새로운 파일이 등록되었을 경우에는
        [ git commit -a -m "..." ] 명령으로 처리가 되지 않는다. 별도로 등록을 해주어야 하는 것이다!!!!!
     - 이 부분만 주의해서 정리하고 push 해주면 모든 것은 끝난다!!!




강원도 솔비치로 2박3일 가족여행을 다녀오자마자 내 방에 처박혀서 포스팅을 하고 있으니,
우리 아가와 와이프가 째려본다.... ㅋㅋㅋ ^^

솔비치 호텔에서 2박 모두 했는데 바로 앞에 바다가 있어서 아가랑 놀러가기에는 정말 좋은 것 같다.
다만, 아직까지는 물이 차가워서 모래놀이 위주로 했지만...

다음에는 호텔이 아니라 콘도로 예약을 해야겠다 ^___^