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

相關資料準備

• Server: git.example.com
• Project name: project_name
• Apache 帳號、密碼檔: /etc/apache2/dav_git.passwd
• Git Repository Path: /var/cache/git (/var/cache/git/prject_name.git)

啟用 Apache2 模組(Server)

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

1. a2enmod dav_fs
2. a2enmod dav

修改 Apache2 設定(Server)

1. htpasswd -c /etc/apache2/dav_git.passwd USERNAME # 建立新的 帳號 / 密碼
2. 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>

3. ln -s /etc/apache2/sites-available/git.conf /etc/apache2/sites-enabled/git.conf
4. /etc/init.d/apache2 restart

建立 / 設定 Git Repository (Server)

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

1. mkdir -p /var/cache/git/project_name.git
2. cd /var/cache/git/project_name.git
3. git --bare init
4. 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

5. cp hooks/post-update.sample hooks/post-update
6. vim hooks/post-update # http 存取需要設這個, 沒有執行此行, 就不能 pull 到新資料
   

   exec git-update-server-info
   改成 # debian 沒有 git-update-server-info 的指令
   exec git update-server-info

7. chown www-data:www-data -R .
8. # 註: 到此 Server 部份就都完成囉 🙂

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

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

1. vim ~/.netrc
   

   machine example.com
   login USERNAME
   password PASSWORD

2. chmod 600 ~/.netrc
3. 測試: curl --netrc --location http://git.example.com/project_name.git/HEAD # 會看到 ref: refs/heads/master
4. 測試: curl --netrc --location -v http://git.example.com/project_name.git/HEAD # 會出現所有過程訊息

由 Git Repository 取得資料 (Client)

1. git clone http://git.example.com/project_name.git
2. cd project_name
3. touch index.html
4. git add index.html
5. git commit -m 'init' # local commit
6. 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

7. git push # 第二次後, 只要 push 即可, 不需加 origin master.

測試

1. mkdir /tmp/a /tmp/b
2. cd /tmp/a
3. git clone http://git.example.com/project_name.git
4. cd /tmp/b
5. git clone http://git.example.com/project_name.git
6. echo "hello" > hello.html
7. git add hello.html
8. git commit -m 'add hello.html' # local commit.
9. git push # 推到 Server 上.
10. cd /tmp/a
11. git pull # 會看到 hello.html

相關網頁

• Setting up a git repository which can be pushed into and pulled from over HTTP(S).
• Sharing a public Git repo over HTTP [flow chart]
• Sharing git repositories via OS X's built-in web sharing
• Using Git on Alioth - hook mail、irc、svn 轉換 等設定.
• Git FAQ - 設定上若有任何問題, 可以由此處找找有沒有答案

快速建立 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 .

錯誤排除

若於 git push origin master 時, 出現下述錯誤:

error: Cannot access URL http://git.example.com/project_name.git, return code 22

原因

• WebDAV 不支援

解法

1. Apache 啟用 dav_fs, dav
2. 於 Apache 設定檔 啟用 DAV on.