學科: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」是極度危險的。