Ernest Talks: git

設定 Gitolite 範圍中每個 repository 在每次收到 git push 之後就通知該 repository 相關人員，需要設定 hook 機制。但是 gitolite 和 git 的設定方式有些不同，尋覓許多文件後終於找到實作的方式成功 :)<br />
<div>
<br /></div>
<div>
<br /></div>
<div>
<span style="font-size: large;">環境</span></div>
<div>
<ul>
<li>建立 gitolite 環境：參考 Tsung 的「<a href="http://blog.longwin.com.tw/2011/03/linux-gitolite-git-server-2011/">Linux 使用 Gitolite 架設 Git Server</a>」 採用 gitolite  這個帳號直接管理 gitolite，沒有另外建立一個 git 的 linux user 帳號。</li>
<li>gitolite 的 hooks 位在：/usr/share/gitolite/hooks/common</li>
<li>寄信通知大家的工具程式「post-receive-email」位在：/usr/share/doc/git/contrib/hooks/post-receive-email</li>
</ul>
<div>
<br /></div>
</div>
<div>
<span style="font-size: large;">方向</span></div>
<div>
<ul>
<li>讓 gitolite 的 hook script 裡頭知道要去哪裡找到可以執行送信程式「post-receive-email」</li>
</ul>
<div>
<pre class="brush: plain">$ sudo chmod a+x /usr/share/doc/git/contrib/hooks/post-receive-email
$ sudo vim /usr/share/gitolite/hooks/common/post-receive
$ sudo chmod a+x /usr/share/gitolite/hooks/common/post-receive
</pre>
在 /usr/share/gitolite/hooks/common/post-receive 中，原本是空的，可以輸入以下 script：
<br />
<pre class="brush: plain">#!/bin/bash
/usr/share/doc/git/contrib/hooks/post-receive-email
</pre>
</div>
<div>
<br /></div>
<ul>
<li>調整 .gitolite.rc 檔案內容（不然等一下設定 git config 參數在 gitolite.conf 的時候，gitolite 會不認識 config 參數）</li>
</ul>
<div>
<pre class="brush: plain">$ sudo su gitolite
$ vim .gitolite.rc
  # 然後找到「$GL_GITCONFIG_KEYS = "";」
  # 改成「$GL_GITCONFIG_KEYS = ".*";」
$ gl-setup admin.pub
</pre>
</div>
<ul>
<li>將 git config 參數設定在 gitolite-admin/conf/gitolite.conf 裡頭，然後 git push </li>
</ul>
<div>
<pre class="brush: plain">repo    testing # 在此以 testing 這個 repo 為範例
        RW+     = @all # 你原本的權限設定

config hooks.mailinglist    = "ernest@example.com, chiang@example.com" # 可以寄信給多個人
        config hooks.envelopesender = git@example.com # 寄件者的信箱地址 email address of sender
        config hooks.emailprefix    = "[testing] " # 信件主旨的開頭字串
        config hooks.showrev        = "git show -C %s; echo" # 原本只有列出有改動的檔案們，在此我改為列出有改動的檔案內容
</pre>
然後 git add, git commit, git push 到 git server 去。
</div>
<ul>
<li>git push 後，在 git server 端，用 gitolite 這個 user 跑 gl-setup （讓 gitolite 幫我們將 config 和 hooks 灑進去各個 repository 中）</li>
</ul>
<div>
<pre class="brush: plain">$ sudo su gitolite
$ gl-setup admin.pub
</pre>
</div>
<div>
<br />
到目前為止應該 hook 可以正常動作了 :)<br />
<br />
<span style="font-size: large;">參考參數：</span><br />
(<a href="http://sourceforge.net/apps/trac/sourceforge/wiki/Git%20hook%20script%20example">reference</a>)<br />
<br />
<br />
<pre class="wiki" style="background-attachment: initial; background-clip: initial; background-color: white; background-image: initial; background-origin: initial; border-bottom-color: rgb(215, 215, 215); border-bottom-style: solid; border-bottom-width: 1px; border-image: initial; border-left-color: rgb(215, 215, 215); border-left-style: solid; border-left-width: 1px; border-right-color: rgb(215, 215, 215); border-right-style: solid; border-right-width: 1px; border-top-color: rgb(215, 215, 215); border-top-style: solid; border-top-width: 1px; font-size: 13px; margin-bottom: 1em; margin-left: 1.75em; margin-right: 1.75em; margin-top: 1em; overflow-x: auto; overflow-y: auto; padding-bottom: 0.25em; padding-left: 0.25em; padding-right: 0.25em; padding-top: 0.25em; text-align: left;"># Config
# ------
# hooks.mailinglist
#   This is the list that all pushes will go to; leave it blank to not send
#   emails for every ref update.
# hooks.announcelist
#   This is the list that all pushes of annotated tags will go to.  Leave it
#   blank to default to the mailinglist field.  The announce emails lists
#   the short log summary of the changes since the last annotated tag.
# hooks.envelopesender
#   If set then the -f option is passed to sendmail to allow the envelope
#   sender address to be set
# hooks.emailprefix
#   All emails have their subjects prefixed with this prefix, or "[SCM]"
#   if emailprefix is unset, to aid filtering
# hooks.showrev
#   The shell command used to format each revision in the email, with
#   "%s" replaced with the commit id.  Defaults to "git rev-list -1
#   --pretty %s", displaying the commit id, author, date and log
#   message.  To list full patches separated by a blank line, you
#   could set this to "git show -C %s; echo".
#   To list a gitweb/cgit URL *and* a full patch for each change set, use this:
#     "t=%s; printf 'http://.../?id=%%s' \$t; echo;echo; git show -C \$t; echo"
#   Be careful if "..." contains things that will be expanded by shell "eval"
#   or printf.
# hooks.emailmaxlines
#   The maximum number of lines that should be included in the generated
#   email body. If not specified, there is no limit.
#   Lines beyond the limit are suppressed and counted, and a final
#   line is added indicating the number of suppressed lines.
#</pre>
<br />
<br />
<span style="font-size: large;">參考文件：</span><br />
<br />
<ul>
<li><a href="http://blog.longwin.com.tw/2011/05/git-commit-send-mail-notify-2011/">設定 Git Commit 更新 自動寄信通知</a> (Tsung, #git)</li>
<li><a href="https://github.com/sitaramc/gitolite/blob/pu/doc/hook-propagation.mkd">hook propagation in gitolite</a> (gitolite 官方文件, #但幫助不大) </li>
<li><a href="https://github.com/sitaramc/gitolite/blob/pu/doc/mirroring.mkd">mirroring gitolite servers</a> (gitolite 官方文件, #我在這參考 mirror 作法找到 hook 的接點)</li>
<li><a href="https://github.com/sitaramc/gitolite/blob/pu/doc/gitolite.rc.mkd">configuring gitolite's advanced features -- the .gitolite.rc file</a> (gitolite 官方文件, #.rc 檔案設定方式參考)</li>
<li><a href="http://blog.gslin.org/archives/2011/12/19/2805/gitolite-%E7%9A%84-hook/">gitolite 的 hook…</a> (gslin, #gitolite #很重要的 hint)</li>
<li><a href="http://stackoverflow.com/questions/5055190/how-to-setup-post-receive-email-git-hook-with-gitolite">How to setup post-receive-email Git hook with Gitolite</a> (stackoverflow)</li>
</ul>
<br />
<br />
<br />
<br /></div>
</div>

Setup Gitolite Hook post-receive-email

設定 Gitolite 範圍中每個 repository 在每次收到 git push 之後就通知該 repository 相關人員，需要設定 hook 機制。但是 gitolite 和 git 的設定方式有些不同，尋覓許多文件後終於找到實作的方式成功 :) 環境 ...