gitweb + nginx

Nginx가 깔린 곳에서 gitweb을 설치하여 사용하고자 하는 한국 사용자를 위한 안내서 입니다.

gitweb은 perl fastcgi를 사용하기 때문에, 자료가 많지 않은 Nginx와 연동하기는 초보자들에게 어렵습니다.

일단 아래는 gitweb을 (gitolite와 함께) 설치하는 것을 자세히 설명한 페이지의 링크입니다.

http://webdir.tistory.com/223

(이 아래의 자료가 Nginx와 gitweb을 연동할 수 있는 자료가 나와 있는 곳 입니다.

https://wiki.archlinux.org/index.php/gitweb#Nginx

그러나 몇몇 정보들이, 개인 리눅스 환경에 따라 다를 수 있음을 알려주지 않기에, 그에 대한 추가 정보를 올립니다.

참고로 제 환경은 라즈베리파이 데비안기반에서 Nginx 1.2.1버전 입니다.

Nginx

Consider you've symlinked ln -s /usr/share/gitweb /var/www, append this location to your nginx configuration:

라고 나와있는데, 현재 nginx 1.2.1에서는 굳이 심볼릭 링크를 안해도 됩니다.

그리고, nginx를 바로 설치한 환경이라면 /var/www 가 아닌 /usr/share/nginx/www 의 경로가 웹 루트 디렉토리 일 것입니다.

그리고 fastcgi랑 perl을 이용하기위해

fcgiwrap, span-fcgi, libcgi-fast-perl, libcgi-perl, libfcgi-procmanager-perl

저는 이렇게 막 깔았는데 아마 잡다한것도 포함되어 있을겁니다.

/etc/nginx/nginx.conf

location /gitweb/ {
        index gitweb.cgi;
        include fastcgi_params;
        gzip off;
        fastcgi_param   GITWEB_CONFIG  /etc/conf.d/gitweb.conf;
        if ($uri ~ "/gitweb/gitweb.cgi") {
                fastcgi_pass    unix:/var/run/fcgiwrap.sock;
        }
}

이렇게 환경설정 하라고 나와 있는데, 이것은 제 환경에서는 이 파일이 없습니다.

그리고 몇몇 파일 위치도 잘못되어서 아래와 같이 작성합니다.

/etc/nginx/sites-enabled/default

location /gitweb/ {
        alias /usr/share/gitweb/;
        index gitweb.cgi;
        include fastcgi_params;
        gzip off;
        fastcgi_param   GITWEB_CONFIG  /etc/gitweb.conf;
        if ($uri ~ "/gitweb/gitweb.cgi") {
                fastcgi_pass    unix:/run/fcgiwrap.socket;
        }
}

alias를 하면 되므로 위에서 심볼릭 링크를 안걸은겁니다.

fcgiwrap.socket 의 경우는 환경마다 다를 수 있으므로

sudo find / -name fcgiwrap* 2> /dev/null

을 해서 fcgiwrap.sock 또는 fcgiwrap.socket의 경로를 찾아보시기 바랍니다.

수정을 했으면

sudo service nginx reload

를 해줍니다.

그리고 다음에

/usr/lib/systemd/system/fcgiwrap.service

를 수정하라고 했는데, 있지도 않고 안해도 상관없었습니다.

그리고 웹에서 내용을 읽을 수 있도록 설정을 해야 하는데

/etc/gitweb.conf 중에 $projectroot, $projects_list 로 설정한 폴더의 그룹에 www-data를 추가해서 권한을 줍니다.