學科:Git/在Windows下安裝Gitolite

一些約定

安裝是在本地進行的（示例中域名均為localhost），示例中gitolite使用的帳戶為「git」，如果你要使用其他名字，請看清命令。粗體為用戶輸入，斜體部分是需要你根據實際情況進行修改的。

準備Cygwin環境

因為gitolite並不提供原生Windows支持，所以在Windows上搭建gitolite需要藉助Cygwin。Cygwin可以為Windows提供一個類似Linux的POSIX模擬系統。

安裝

訪問 http://cygwin.com/install.html 獲取安裝文件
按提示繼續，路徑建議不要包含中文或空格
之後來到組件選擇 Select Packages 部分

推薦選擇：openssh（必選），vim（推薦，gl-setup安裝時如果未使用-q開關則會調用vi編輯配置文件），git（必選），git-completion，git-gui，git-svn（可選），gitk。

關於編輯器：如果你不熟悉vim或編輯器列表里其他編輯器，建議選擇nano

提示：建議使用搜索尋找需要的組件

繼續按提示安裝

配置Cygwin

將cygwin的bin目錄加入到Windows系統環境變量中，重啟生效
打開Cygwin終端，執行

   $ /bin/cyglsa-config

將提示：

   Warning: Registering the Cygwin LSA authentication package requires administrator privileges!  You also have to reboot the machine to activate the change.
   Are you sure you want to continue? (yes/no)

yes確認：

   Cygwin LSA authentication package registered.
   Activating Cygwin's LSA authentication package requires to reboot.

重啟生效。

準備SSH

以管理員身份啟動終端，執行

   $ ssh-host-config

接下來要回答一系列問題（一次不成功沒關係，可以再次操作），以下是推薦的回答：
- Should privilege separation be used? 選yes
- Query: new local account 'sshd'? (yes/no) 選yes
- Do you want to install sshd as a service? 選yes
- Enter the value of CYGWIN for the daemon: [] 直接回車
- Do you want to use a different name? (yes/no) 選no
- Create new privileged user account 'cyg_server'? (yes/no) 選yes，接下來輸入密碼（如果組策略開啟了密碼強度要求，設置的密碼要符合該要求，否則會失敗）

如果成功最後幾條信息會是：

   *** Info: The sshd service has been installed under the 'cyg_server'
   *** Info: account.  To start the service now, call `net start sshd' or
   *** Info: `cygrunsrv -S sshd'.  Otherwise, it will start automatically
   *** Info: after the next reboot.
   
   *** Info: Host configuration finished. Have fun!

接下來執行

   $ sc start sshd

啟動sshd服務，成功的輸出形如：

   SERVICE_NAME: sshd
       TYPE               : 10  WIN32_OWN_PROCESS
       STATE              : 2  START_PENDING
                               (STOPPABLE, NOT_PAUSABLE, IGNORES_SHUTDOWN)
       WIN32_EXIT_CODE    : 0  (0x0)
       SERVICE_EXIT_CODE  : 0  (0x0)
       CHECKPOINT         : 0x2
       WAIT_HINT          : 0x1388
       PID                : 2644
       FLAGS              :

提示：cygrunsrv用於管理服務，也可使用「cygrunsrv -S sshd」啟動服務，不同的是沒有信息輸出則表示成功啟動。使用「cygrunsrv -R sshd」可以移除sshd服務。
可選：配置防火牆，允許ssh服務使用埠22（如果沒改配置文件中的埠設置的話）

準備git帳戶

雖然可以使用現有帳戶或ssh-host-config中創建的cyg_server帳戶，但還是推薦單獨創建一個名為「git」的帳戶。

帳戶創建

轉到Windows控制面板，新建名為「git」帳戶（這步不區分大小寫）
進入終端，執行：

   $ mkpasswd -l -u git >> /etc/passwd

這步是為了讓cygwin系統認得git帳戶對應Windows的哪個帳戶

登入git帳戶

打開終端，通過ssh登入git帳戶，參考命令：

   $ ssh git@localhost

成功的參考輸出：

   The authenticity of host 'localhost (::1)' can't be established.
   ECDSA key fingerprint is 18:a6:df:7c:93:5f:c7:b6:20:ce:46:03:90:a9:f8:da.
   Are you sure you want to continue connecting (yes/no)? yes
   Warning: Permanently added 'localhost' (ECDSA) to the list of known hosts.
   git@localhost's password:
   Could not chdir to home directory /home/git: No such file or directory
   Copying skeleton files.
   These files are for the users to personalise their cygwin experience.
   
   They will never be overwritten nor automatically updated.
   
   `./.bashrc' -> `/home/git//.bashrc'
   `./.bash_profile' -> `/home/git//.bash_profile'
   `./.inputrc' -> `/home/git//.inputrc'
   `./.profile' -> `/home/git//.profile'

並且命令的前導符變成：git@localhost。

安裝Gitolite

添加bash環境變量

編輯~/.bashrc，以nano作為示例：

   $ nano ~/.bashrc

nano的使用提示：nano和Windows筆記本很像，也可用方向鍵移動光標，底部會顯示一些如「^G」的命令（如果作業系統是中文的這些命令也應該有中文提示），「^」表示Ctrl，如按Ctrl+G獲取幫助。

在第一行添加：

  PATH="$PATH:$HOME/bin"

Ctrl+X，回車保存。為了使應用立即生效需要執行：

  $ source ~/.bashrc

確認添加結果可以執行：

   $ echo $PATH

剛才添加的路徑應該加到最後面了，示例為「/home/git/bin」。

Clone Gitolite文件

cd到/tmp/share（必須是這個路徑），命令：

   $ cd /tmp/share

為什麼路徑必須是「/tmp/share」？

如果是Linux當然沒有這個限制，但cygwin下的gitolite在安裝中的路徑判斷存在問題，如果是其他路徑，在gl-setup時會提示找不到/tmp/share中的文件，所以目前就放到這個目錄了。後面給RC文件添加$ENV{PATH}也是cygwin路徑判斷的問題。 —— BB9z (talk) 10:44, 1 March 2012 (UTC)

然後從遠端clone gitolite倉庫：

   $ git clone git://github.com/sitaramc/gitolite.git

參考輸出：

   Cloning into 'gitolite'...
   remote: Counting objects: 5197, done.
   remote: Compressing objects: 100% (1775/1775), done.
   remote: Total 5197 (delta 3557), reused 4954 (delta 3366)
   Receiving objects: 100% (5197/5197), 1.74 MiB | 168 KiB/s, done.
   Resolving deltas: 100% (3557/3557), done.

gl-system-install

gl-system-install，參考命令及輸出：

   $ /tmp/share/gitolite/src/gl-system-install
   using default values for EUID=1015:
   /home/git/bin, /home/git/share/gitolite/conf, /home/git/share/gitolite/hooks

修正rc文件環境變量

註：這是cygwin獨有的問題，Linux無需此操作。

以nano為例，執行：

   $ nano ~/.gitolite.rc

在第一行添加如下內容，保存：

   $ENV{PATH}="/bin:/usr/bin";

準備管理員帳戶的公鑰

gitolite安裝初始需要提供一名管理員的公鑰，安裝好後只要有相應私鑰即可通過gitolite-admin庫進行管理，既可以在本地，也可以在遠端。為了方便起見，下面以本機已有帳戶為例。

打開終端登入要作為初始管理員的帳戶（非git帳戶，默認打開終端使用的是當前登錄Windows的用戶，如果要把當前用戶作為管理員的話直接打開終端就可以了）。

將用戶公鑰從ssh用戶目錄中拷貝出來，參考命令：

   $ cp ~/.ssh/id_rsa.pub /name.pub

如果提示找不到文件則需要先生成一個，執行：

   $ ssh-keygen -t rsa

需要回答幾個問題，直接回車。參考的輸出：

   Generating public/private rsa key pair.
   Enter file in which to save the key (/home/git/.ssh/id_rsa):
   Enter passphrase (empty for no passphrase):
   Enter same passphrase again:
   Your identification has been saved in /home/git/.ssh/id_rsa.
   Your public key has been saved in /home/git/.ssh/id_rsa.pub.
   The key fingerprint is:
   95:bb:00:a0:04:2e:12:3c:21:9a:37:f6:8b:57:f0:e0 git@BBservice
   The key's randomart image is:
   +--[ RSA 2048]----+
   |=oo .            |
   |+* . .     .     |
   |=.* o .   o      |
   |oo + + . . .     |
   |    E o S .      |
   |   . o   . .     |
   |  . o     .      |
   |   .             |
   |                 |
   +-----------------+

然後再執行之前的拷貝命令。

gl-setup

最後，執行gl-setup，參考命令：

  $ gl-setup -q path_to_admin_pub_file

成功的示例：

   creating gitolite-admin...
   Initialized empty Git repository in /home/git/repositories/gitolite-admin.git/
   creating testing...
   Initialized empty Git repository in /home/git/repositories/testing.git/
   [master (root-commit) 119d2f3] gl-setup -q /home/git.pub
    2 files changed, 8 insertions(+), 0 deletions(-)
    create mode 100644 conf/gitolite.conf
    create mode 100644 keydir/git.pub

至此Gitolite的安裝過程就全部完成了。

驗證安裝

首先，檢出gitolite-admin倉庫。

終端登入管理員身份，在合適的目錄執行：

   $ git clone git@localhost:gitolite-admin

成功的輸出參考：

   Cloning into 'gitolite-admin'...
   remote: Counting objects: 15, done.
   remote: Compressing objects: 100% (11/11), done.
   remote: Total 15 (delta 2), reused 0 (delta 0)
   Receiving objects: 100% (15/15), done.
   Resolving deltas: 100% (2/2), done.

之後可以修改配置文件，能順利提交的話就沒有問題了。

關於Gitolite的配置參見：Subject:Git/Gitolite配置

問題解答

安裝Cygwin時少選或選錯組件了怎麼辦？

只需重新執行Setup.exe在原位安裝即可，選擇組件時，已有組件的狀態將顯示為keep。

安裝gitolite的過程出問題了，如何重新安裝？

直接重新執行gl-system-install和gl-setup應該沒有問題，如果想全新的安裝，可以用rm命令刪除gitolite相關文件，詳見： http://sitaramc.github.com/gitolite/install.html#uninstall_

甚至你也可以用「rm -fr /home/git」將整個git用戶文件推倒重來，但要小心，「rm -fr」是極度危險的。

參考