Debian Linux 架設使用 HTTP 存取的 Git Server

星期一, 五月 11, 2009

Debian Linux 架設使用 HTTP 存取的 Git Server

此篇的 HTTP 存取方式, 與 SSH 存取方式, 可以使用同一份 Repository.

關於 Git 的說明、ssh:// 存取 Git 等, 可見: 存取 Git 使用 SSH (Debian Linux)

使用 http:// 存取, 並透過 Apache 去管控權限, 可以省掉開機器的帳號. 之前 svn 若也是用 http:// 存取, 亦可直接使用. (不用重新開帳號、密碼)

Git 安裝

Server: apt-get install git-core # in Debian / Ubuntu Linux
Client: apt-get install git-core curl # in Debian / Ubuntu Linux

啟用 Apache2 模組(Server)

需啟用 Apache 的 dav_fs 和 dav 模組, 所以於命令列執行下述命令

a2enmod dav_fs
a2enmod dav

修改 Apache2 設定(Server)

htpasswd -c /etc/apache2/dav_git.passwd USERNAME # 建立新的帳號 / 密碼
vim /etc/apache2/sites-available/git.conf
<VirtualHost *>
    ServerAdmin user@example.com
    DocumentRoot /var/cache/git
    ServerName git.example.com
    ErrorLog /var/log/apache2/git-error.log
    CustomLog /var/log/apache2/git-access.log combined

    <Location "/project_name.git">
    DAV on
    AuthType Basic
    AuthName "Git"
    # AuthUserFile /etc/apache2/dav_svn.passwd # 若是跟 svn 相容的話, 檔名一致即可
    AuthUserFile /etc/apache2/dav_git.passwd # 若是想另外取名的話.
    Require valid-user
    </Location>
</VirtualHost>
ln -s /etc/apache2/sites-available/git.conf /etc/apache2/sites-enabled/git.conf
/etc/init.d/apache2 restart

建立 / 設定 Git Repository (Server)

下述 Git 建立方式, 另一種方式可見: Debian Linux 架設使用 SSH 存取的 Git Server

mkdir -p /var/cache/git/project_name.git
cd /var/cache/git/project_name.git
git --bare init
git update-server-info
# 若執行此指令沒作用, 手動作下述初始化也可以.
#   (不過不建議這樣做, 通常目前只有在 Server 和 Client 是同一台的狀況會有異常現象.)
#   (Server 和 Client 是同一台的話, 可以考慮用 local commit 即可.)
# 註: refs/heads/master 中間空白是 tab
echo "0000000000000000000000000000000000000000" > /var/cache/git/project_name.git/refs/heads/master
echo "0000000000000000000000000000000000000000    refs/heads/master" > /var/cache/git/project_name.git/info/refs
cp hooks/post-update.sample hooks/post-update
vim hooks/post-update # http 存取需要設這個, 沒有執行此行, 就不能 pull 到新資料
exec git-update-server-info
改成 # debian 沒有 git-update-server-info 的指令
exec git update-server-info
chown www-data:www-data -R .
# 註: 到此 Server 部份就都完成囉 :)

存取 Git 的帳號 / 密碼設定(需透過 curl) (Client)

於 Client 端做下述設定 (註: 此設定不可略過)

vim ~/.netrc
machine example.com
login USERNAME
password PASSWORD
chmod 600 ~/.netrc
測試: curl --netrc --location http://git.example.com/project_name.git/HEAD # 會看到 ref: refs/heads/master
測試: curl --netrc --location -v http://git.example.com/project_name.git/HEAD # 會出現所有過程訊息

由 Git Repository 取得資料 (Client)

git clone http://git.example.com/project_name.git
cd project_name
touch index.html
git add index.html
git commit -m 'init' # local commit
git push origin master # 若出現 PUT error: curl result=22, HTTP code=403 => 代表 www-data 權限不足
Fetching remote heads...
refs/
refs/heads/
refs/tags/
updating 'refs/heads/master'
from 5b78d8b9cc8677e341cb2d8aab3d87c4fa48570c
to   64a09faa921dba45ea20d137156589c5fdb10714
    sending 3 objects
    done
Updating remote server info
git push # 第二次後, 只要 push 即可, 不需加 origin master.

測試

mkdir /tmp/a /tmp/b
cd /tmp/a
git clone http://git.example.com/project_name.git
cd /tmp/b
git clone http://git.example.com/project_name.git
echo "hello" > hello.html
git add hello.html
git commit -m 'add hello.html' # local commit.
git push # 推到 Server 上.
cd /tmp/a
git pull # 會看到 hello.html

快速建立 Repository script

#!/bin/sh # git-create-reps.sh <project_name> # 此 script 需由 root 執行 if [ $# -ne 1 ]; then echo 1>&2 Usage: $0 project_name exit 127 fi set project_name = $1 mkdir -p /var/cache/git/${project_name}.git cd /var/cache/git/${project_name}.git git --bare init git update-server-info cp hooks/post-update.sample hooks/post-update # 請再自行編修此檔案 chown www-data:www-data -R .