Gitblit搭建及Git協(xié)作開(kāi)發(fā)流程版本：v1.0(2015年3月20日)作者：南瓜剪子1. 概述目前主流的是git作為自己代碼管理，但是采用github需要付費(fèi)才能夠使用，如果不付費(fèi)，代碼需要公開(kāi)。創(chuàng)業(yè)團(tuán)隊(duì)及小型開(kāi)發(fā)團(tuán)隊(duì)都有必要搭建自己的代碼服務(wù)器，自己摸索需要一定的時(shí)間，會(huì)趕不及項(xiàng)目進(jìn)度。在此作者把自己的經(jīng)驗(yàn)作為文檔寫(xiě)下來(lái)，方便互聯(lián)網(wǎng)各位創(chuàng)業(yè)者參考，能很快的搭建自己所需要的代碼服務(wù)器。同時(shí)作者也把最基本的開(kāi)發(fā)流程，代碼提交，代碼上傳，代碼merge等流程用命令寫(xiě)出，方便大家參考。作者自己的團(tuán)隊(duì)開(kāi)發(fā)以Maven+Java為主，使用eclipse作為開(kāi)發(fā)工具，相關(guān)部分在此文檔中都有詳細(xì)的描述。文檔中使用的工具版本如下jdk1.8.0_73Gitblit 1.7.1Eclipse MARS.1PortableGit 2.7.1Apache-maven-3.3.9注意： 由于互聯(lián)網(wǎng)技術(shù)日新月異，以后工具如有更新，流程也許會(huì)變化，所以本文檔中流程只作為參考。并請(qǐng)準(zhǔn)備一臺(tái)Windows機(jī)器，并且在你的局域網(wǎng)內(nèi)，開(kāi)發(fā)者能夠訪問(wèn)注意: 如果你只是一個(gè)開(kāi)發(fā)者，不需要關(guān)心Gitblit代碼服務(wù)器搭建，請(qǐng)?zhí)^(guò)下面章節(jié)第3章 Gitblit服務(wù)器搭建第4章配置Gitblit用戶(hù)第5章創(chuàng)建第一個(gè)Gitblit版本庫(kù)第7章項(xiàng)目管理者上傳項(xiàng)目最初始代碼這幾張是有關(guān)Gitblit部分，主要是代碼管理員需要學(xué)習(xí)服務(wù)器管理。開(kāi)發(fā)人員請(qǐng)從后面相關(guān)部分學(xué)習(xí)，后面類(lèi)容依然精彩，會(huì)告訴你怎么下載代碼，構(gòu)建工程，還有上傳代碼，更新代碼。2. 安裝JDK安裝JDK這個(gè)過(guò)程我就不再過(guò)多描述訪問(wèn) /technetwork/java/javase/downloads下載最新JDK,并按操作安裝安裝完畢后最好設(shè)置環(huán)境變量JAVA_HOME及PATH新建JAVA_HOME=C:Program FilesJavajdk1.8.0_73 (你的JDK安裝目錄，請(qǐng)核對(duì)你自己目錄及版本)并把(;%JAVA_HOME%bin;)加入到PATH大致流程如下圖所示3. Gitblit服務(wù)器搭建訪問(wèn)地址：/下載最新的Gitblit windows版本，由于小型團(tuán)隊(duì)一般以windows機(jī)器為主，在這里只介紹windows版本的搭建Step1) 下載gitblit-1.7.1.zipStep2) 解壓到D:open_sourcegitblit-1.7.1Step3) 創(chuàng)建一個(gè)目錄，用來(lái)存放代碼庫(kù)：D:/GitRepositoiesStep4) 修改data目錄下的perties(D:open_perties)加入以下紅色內(nèi)容# GITBLIT.PROPERTIES# Define your custom settings in this file and/or include settings defined in# other properties files.# Include Gitblits perties within your configuration.# NOTE: Gitblit will not automatically reload included properties. Gitblit# only watches the perties file for modifications.# Paths may be relative to the $baseFolder or they may be absolute.# COMMA-DELIMITED# SINCE 1.7.0include = perties# Define your overrides or custom settings below# Base folder for repositories.# This folder may contain bare and non-bare repositories but Gitblit will only# allow you to push to bare repositories.# Use forward slashes even on Windows!# e.g. c:/gitrepos# SINCE 0.5.0# RESTART REQUIRED# BASEFOLDERgit.repositoriesFolder = D:/GitRepositoies# Standard http port to serve. = 0 disables this connector.# On Unix/Linux systems, ports 1024 require root permissions.# Recommended value: 80 or 8080# SINCE 0.5.0# RESTART REQUIREDserver.httpPort = 1000# Secure/SSL https port to serve. = 0 disables this connector.# On Unix/Linux systems, ports d:D:cd D:open_sourcegitblit-1.7.1D:open_sourcegitblit-1.7.1installServiceStep7) 檢查windows服務(wù)開(kāi)始菜單“運(yùn)行”中，輸入services.msc并檢查gitblit服務(wù)是否成功安裝，由于開(kāi)發(fā)團(tuán)隊(duì)每天都在用，確保為自動(dòng)模式，每次windows啟動(dòng)都自動(dòng)啟動(dòng)右鍵點(diǎn)擊gitblit, 并把服務(wù)啟動(dòng)起來(lái)注意：如果要?jiǎng)h除服務(wù)，請(qǐng)直接運(yùn)行D:open_sourcegitblit-1.7.1下面的uninstallService.cmdStep8) 有可能服務(wù)器起來(lái)后，局域網(wǎng)其他機(jī)器無(wú)法訪問(wèn)，只能在本機(jī)瀏覽器中打開(kāi)，這是由于防火墻的設(shè)置，你必須人工設(shè)置防火強(qiáng)規(guī)則。打開(kāi)“控制面板”-“管理工具”-“高級(jí)安全 Windows 防火墻”由于我演示用的機(jī)器是windows10,也許名字會(huì)不對(duì)，請(qǐng)點(diǎn)擊“管理工具”里面的有關(guān)“防火墻”選項(xiàng)就行如下圖所示：然后“新建規(guī)則”，選擇“程序”然后選擇程序?yàn)镈:open_sourcegitblit-1.7.1x86gitblit.exe注意這里”x86”是你在step5)中選擇的架構(gòu)然后點(diǎn)下一步然后點(diǎn)下一步：點(diǎn)下一步：然后會(huì)看到有下面一條記錄Step8) 然后可以在IE中輸入:1000/其中IP地址換成你服務(wù)器的地址，注意，這里我們使用端口為1000，在前面perties里面配置Gitblit安裝完畢4. 配置Gitblit用戶(hù)用IE登陸系統(tǒng)： :1000/Step1) 用管理員賬號(hào)登錄確實(shí)用戶(hù)名/密碼： admin/adminStep2) 修改管理員賬戶(hù)密碼Step3) 添加用戶(hù)為你團(tuán)隊(duì)中的開(kāi)發(fā)人員創(chuàng)建用戶(hù)，只有授權(quán)用戶(hù)才能進(jìn)行相關(guān)操作然后點(diǎn)擊添加用戶(hù)然后填入成員基本信息，點(diǎn)擊保存然后把用戶(hù)名及初始密碼發(fā)送給團(tuán)隊(duì)成員，讓他們登陸:1000/進(jìn)去修改密碼Step4) 創(chuàng)建項(xiàng)目組也許你的創(chuàng)業(yè)團(tuán)隊(duì)有好幾個(gè)項(xiàng)目，每個(gè)項(xiàng)目都由不同的人開(kāi)發(fā)，你可以為每個(gè)項(xiàng)目創(chuàng)建個(gè)團(tuán)隊(duì)。然后點(diǎn)擊右上交“添加團(tuán)隊(duì)” 并填寫(xiě)以下信息:例如我有一個(gè)項(xiàng)目名稱(chēng)叫“阿爾法貓”然后選擇團(tuán)隊(duì)成員，當(dāng)前只有我一個(gè)，也可以選擇多個(gè)，如下圖其他有關(guān)權(quán)限部分可以先不用關(guān)心，熟悉后請(qǐng)自行閱讀/中文檔5. 創(chuàng)建第一個(gè)Gitblit版本庫(kù)： 阿爾法貓Step1) 使用系統(tǒng)管理員賬號(hào)登陸，并點(diǎn)擊“創(chuàng)建版本庫(kù)”Step2) 然后按要求填入以下信息可以給項(xiàng)目分組，那么在名稱(chēng)哪里填寫(xiě)：ai/alpha-mao表示項(xiàng)目alpha-mao屬于ai分組，對(duì)于項(xiàng)目名稱(chēng)我們一般采用全小寫(xiě)，中間用分隔符“-”分離單詞注意，為了保證代碼的安全，我們選擇第四個(gè)： 限制查看，克隆及推送，只有加入項(xiàng)目組的人才能夠查看項(xiàng)目。 不像github，匿名用戶(hù)可以查看克隆開(kāi)源代碼，一般創(chuàng)業(yè)團(tuán)隊(duì)的代碼都是保密。其他信息可以不用填寫(xiě)，下面會(huì)告訴你怎么推送新代碼到服務(wù)器。然后點(diǎn)擊下面“創(chuàng)建”，Step3) 設(shè)置項(xiàng)目權(quán)限當(dāng)項(xiàng)目創(chuàng)建后，點(diǎn)擊版本庫(kù)又上角的“編輯”按鈕然后設(shè)置團(tuán)隊(duì)及用戶(hù)權(quán)限注意：請(qǐng)一定要點(diǎn)擊“添加”按鈕添加成功后，點(diǎn)擊保存按鈕注意，團(tuán)隊(duì)權(quán)限只有能夠查看克隆推送的權(quán)限，但是沒(méi)有創(chuàng)建，修改分支(branch)的權(quán)限我們這里設(shè)置了一個(gè)項(xiàng)目管理員：他除了有查看克隆推送的權(quán)限，還有創(chuàng)建分支的權(quán)限。在后面我們會(huì)看到lan.zhou這個(gè)用戶(hù)能夠直接在服務(wù)器上創(chuàng)建dev分支。到此我們創(chuàng)建了一個(gè)新的版本庫(kù)，下面等待lan.zhou這個(gè)用戶(hù)上傳最初始的代碼，然后團(tuán)隊(duì)里面的別人就可以克隆使用。6. 下載最新的git工具并安裝訪問(wèn)/download/win 下載最新的git工具一般“32-bit Git for Windows Portable”就行，一般國(guó)外服務(wù)器比較難下載，可以找國(guó)內(nèi)鏡像。安裝步驟：step1) 解壓PortableGit-2.7.0-32-bit.7z.exestep2) 按下圖把bin目錄(;D:Program FilesPortableGit-2.7.0-32-bitbin)加在系統(tǒng)環(huán)境變量PATH下step3) 打開(kāi)一個(gè)cmd(命令提示符)運(yùn)行下列命令git config -global user.email git config -global lan.zhou注意：請(qǐng)把紅色的用戶(hù)名換成你自己的登陸名(詳見(jiàn)第一章)然后用下列命令檢查是否配置成功：git config -listcore.symlinks=falsecore.autocrlf=truecolor.diff=autocolor.status=autocolor.branch=eractive=truepack.packsizelimit=2ghelp.format=htmlhttp.sslcainfo=/ssl/certs/ca-bundle.crtdiff.astextplain.textconv=astextplainrebase.autosquash==lan.zhouuser.email=core.editor=C:/Program Files/Notepad+/notepad+.exe -multiInst -notabbar -nosession -noPlugin運(yùn)行完上面兩個(gè)config命令，在你的windows用戶(hù)目錄下(C:Users登陸用戶(hù)名)就會(huì)生成一個(gè)文件.gitconfig里面包含下面內(nèi)容：useremail = name = lan.zhou7. 項(xiàng)目管理者上傳項(xiàng)目最初始代碼項(xiàng)目管理者請(qǐng)準(zhǔn)備最初的一個(gè)項(xiàng)目，里面包含一些基本代碼請(qǐng)參考下面我準(zhǔn)備的例子下面進(jìn)行本地的準(zhǔn)備Step1) 把上面文件點(diǎn)擊右鍵“保存到文件”，然后解壓到文件夾，比如D:gitalpha-maoStep2) 打開(kāi)一個(gè)windows命令提示符，運(yùn)行下列命令C:Usersappled:D:cd D:gitalpha-mao進(jìn)入項(xiàng)目目錄Step3) 進(jìn)行g(shù)it 初始化D:gitalpha-maogit init初始化空的 Git 版本庫(kù)于 E:/apple/Documents/git/alpha-mao/.git/Step4) 把文件加入版本D:gitalpha-maogit add .gitignoreD:gitalpha-maogit add LICENSED:gitalpha-maogit add README.mdD:gitalpha-maogit add pom.xmlD:gitalpha-maogit add src/Step5) 第一次commitD:gitalpha-maogit commit -m first commit到此，項(xiàng)目在你本地已經(jīng)準(zhǔn)備好了，但是還沒(méi)有上傳到建立好的Gitblit服務(wù)器。下面我們上傳代碼Step1) 查看你的上傳地址，用項(xiàng)目管理者(前面建立的用戶(hù)：lan.zhou，并不是系統(tǒng)管理員admin)登陸 :1000Step2) 查看剛才建立的新版本庫(kù)點(diǎn)擊圖中紅圈標(biāo)出的“復(fù)制到剪貼板”這個(gè)就是用戶(hù)lan.zhou對(duì)應(yīng)的git服務(wù)器地址Step3) 上傳代碼在剛才的命令行中運(yùn)行D:gitalpha-maogit remote add origin ssh:/lan.zhou:29418/ai/alpha-mao.gitD:gitalpha-maogit push -u origin masterThe authenticity of host :29418 (:29418) cant be established.RSA key fingerprint is SHA256:yQE8FoZXgbMUR1ou9zl+CKLE9xqM1zwy09wU33A4CeM.Are you sure you want to continue connecting (yes/no)? yesWarning: Permanently added :29418 (RSA) to the list of known hosts.Password authenticationPassword:Counting objects: 19, done.Delta compression using up to 4 threads.Compressing objects: 100% (9/9), done.Writing objects: 100% (19/19), 5.60 KiB | 0 bytes/s, done.Total 19 (delta 0), reused 0 (delta 0)remote: Updating references: 100% (1/1)To ssh:/lan.zhou:29418/ai/alpha-mao.git * new branch master - master分支 master 設(shè)置為跟蹤來(lái)自 origin 的遠(yuǎn)程分支 master。在上圖紅色的部分先輸入：yes,然后再輸入你在Gitblit上設(shè)置的密碼到此，代碼已經(jīng)上傳到服務(wù)器Step4) 登陸到Gitblit可以看到相關(guān)代碼下面為了項(xiàng)目開(kāi)發(fā)，我們一般務(wù)必要做兩個(gè)事請(qǐng)Step1) 創(chuàng)建初始tag，并上傳到服務(wù)器D:gitalpha-mao git tag -a v0.1 -m initial versionD:gitalpha-mao git push origin v0.1然后你在 :1000 上能夠看到v0.1這個(gè)tagStep2) 創(chuàng)建服務(wù)器的dev分支一般master分支為穩(wěn)定代碼，小型團(tuán)隊(duì)平常開(kāi)發(fā)一般在另一個(gè)分子dev上進(jìn)行我們必須在遠(yuǎn)端Gitblit服務(wù)器上創(chuàng)建dev分支。由于Gitblit權(quán)限控制， 只有授權(quán)的人才能創(chuàng)建分子，詳見(jiàn)第4章配置Gitblit用戶(hù)。在這里lan.zhou這個(gè)用戶(hù)擁有這個(gè)權(quán)限運(yùn)行下列命令在遠(yuǎn)端Gitblit服務(wù)器創(chuàng)建dev分支：D:gitalpha-maogit push origin master:devStep3) 用下列命令查看分支 查看本地分支：D:gitalpha-maogit branch * master查看遠(yuǎn)端分支： D:gitalpha-maogit branch -r origin/dev origin/masterGit環(huán)境搭建完畢，下面開(kāi)始進(jìn)入第二部分，開(kāi)發(fā)部分8. 本地開(kāi)發(fā)環(huán)境: eclipse請(qǐng)到地址：/downloads/下載最新版本的：Eclipse IDE for Java EE Developers然后直接解壓縮，右鍵點(diǎn)擊里面的“eclipse.exe”在桌面創(chuàng)建快捷方式，以后在桌面直接點(diǎn)擊就可運(yùn)行。在本文中我們使用 MARS.1版本9. 配置eclipse 的git功能步驟Step1)點(diǎn)擊eclipse下列菜單Step 2) 進(jìn)入git配置選項(xiàng)卡Step 3) 在上圖中的location，點(diǎn)擊Open,然后選中你的git配置文件: C:Usersapple.gitconfig注意：其中apple是你的機(jī)器用戶(hù)名Step 4), 檢查你的用戶(hù)名與郵箱是否正確10. Eclipse中配置mavenStep1) 下載maven/download.cgi比如：apache-maven-3.3.9-bin.tar.gzStep2) 同樣解壓后直接使用同時(shí)把bin目錄(;D:Program Filesapache-maven-3.3.9bin)加入PATH目錄Step3) 設(shè)置eclipse然后把剛才解壓的目錄加入Step4) 選擇配置文件，一定要選擇你解壓的maven目錄下D:Program Filesapache-maven-3.3.3confsettings.xmlStep5) 更新配置文件在文件D:Program Filesapache-maven-3.3.3confsettings.xml中加入下列紅色的語(yǔ)句 !- mirror | Specifies a repository mirror site to use instead of a given repository. The repository that | this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used | for inheritance and direct lookup purposes, and must be unique across the set of mirrors. | mirrorId repositoryId Human Readable Name for this Mirror. /repo/path - CN OSChina Central /content/groups/public/ central 在這里我們引入了中國(guó)區(qū)的maven庫(kù)，可以極大提高你的獲取速度。同時(shí)注意，你可以選擇另外的目錄作為maven庫(kù) E:appleDocumentsmvn_repo這個(gè)目錄可能會(huì)很大，選擇合適的磁盤(pán)存放11. 團(tuán)隊(duì)其他成員在服務(wù)器端查看工程團(tuán)隊(duì)其他成員，這里我依然還是已自己(lan.zhou)為例，但是這里可以是屬于項(xiàng)目阿爾法貓團(tuán)隊(duì)其他任何成員。請(qǐng)用瀏覽器訪問(wèn)地址：:1000/Step1) 請(qǐng)點(diǎn)擊下面的阿爾法貓項(xiàng)目Step2) 請(qǐng)取得項(xiàng)目的地址，點(diǎn)擊下圖中紅色的標(biāo)記出來(lái)的“復(fù)制到剪貼板”你同時(shí)會(huì)看到我已經(jīng)新建了兩個(gè)分支：master(主分支，用來(lái)存儲(chǔ)當(dāng)前穩(wěn)定的代碼）dev(開(kāi)發(fā)分支,我們平時(shí)每天用來(lái)提交代碼的分支，如果多人同時(shí)提交，可能需要merge)注意：不允許直接向master提交任何代碼，只有管理員（余強(qiáng)）才能整合dev代碼到master同時(shí)你還會(huì)看到我已經(jīng)建立一個(gè)第一個(gè)版本標(biāo)簽 v0.1，這是架構(gòu)代碼我們將會(huì)很快開(kāi)發(fā)v1.0版本12. 團(tuán)隊(duì)其他成員第一次下載代碼Step1) 在你的電腦上建立一個(gè)目錄，比如E:appleDocumentsgitStep2) 打開(kāi)一個(gè)命令行cmd，并運(yùn)行下列兩個(gè)命令C:Usersapplee:E:cd appleDocumentsgit進(jìn)入E:appleDocumentsgitStep3) 接著運(yùn)行下列命令E:appleDocumentsgit git clone ssh:/lan.zhou:29418/ai/alpha-mao.git注意：真?zhèn)€連接是你在上面章節(jié)中step2中拷貝得到的鏈接，請(qǐng)完整復(fù)制，不用使用別人的鏈接，里面包含你的用戶(hù)名然后進(jìn)入項(xiàng)目目錄E:appleDocumentsgitcd alpha-maoStep4) 可以熟悉簡(jiǎn)單的git命令 git status （查看當(dāng)前你修改后還沒(méi)有提交的代碼）On branch masterYour branch is up-to-date with origin/master.nothing to commit, working directory clean git branch （查看你本地的分支）* master git branch r （查看遠(yuǎn)端服務(wù)器的分支） origin/HEAD - origin/master origin/dev origin/master注意，在服務(wù)器中我們已經(jīng)有了origin/dev分支，我們將用這個(gè)分支進(jìn)行開(kāi)發(fā)Step5) 創(chuàng)建你自己的本地開(kāi)發(fā)分支比如你分配到的任務(wù)是feature1, 或者你修改bug5540你可以在你的本地創(chuàng)建名字為feature1或者bug5540的分支但是對(duì)于我們一般代碼開(kāi)發(fā)，可以統(tǒng)一使用localdev git branch localdev然后可以查看新建的localdev分支 git branch （查看你本地的分支） localdev* master但是當(dāng)前的工作分支仍然是master, 前面有一個(gè)*號(hào)Step 6) check out 當(dāng)前的 localdev 分支 git checkout localdevSwitched to branch localdev git branch （查看你本地的分支）* localdev MasterStep 7) merge remote dev分支到本地localdev分支 git merge origin/dev13. eclipse導(dǎo)入工程下面打開(kāi)eclipse，導(dǎo)入工程Step1),選擇importStep