Gitblit搭建及Git协作开发流程参考

Gitblit搭建及Git协作开发流程版本：v1.0(2015年3月20日)作者：南瓜剪子1.概述目前主流的是git作为自己代码管理，但是采用github需要付费才能够使用，如果不付费，代码需要公开。创业团队及小型开发团队都有必要搭建自己的代码服务器，自己摸索需要一定的时间，会赶不及项目进度。在此作者把自己的经验作为文档写下来，方便互联网各位创业者参考，能很快的搭建自己所需要的代码服务器。同时作者也把最基本的开发流程，代码提交，代码上传，代码merge等流程用命令写出，方便大家参考。作者自己的团队开发以Maven+Java为主，使用eclipse作为开发工具，相关部分在此文档中都有详细的描述。文档中使用的工具版本如下jdk1.8.0_73Gitblit1.7.1EclipseMARS.1PortableGit2.7.1Apache-maven-3.3.9注意：由于互联网技术日新月异，以后工具如有更新，流程也许会变化，所以本文档中流程只作为参考。并请准备一台Windows机器，并且在你的局域网内，开发者能够访问注意:如果你只是一个开发者，不需要关心Gitblit代码服务器搭建，请跳过下面章节第3章Gitblit服务器搭建第4章配置Gitblit用户第5章创建第一个Gitblit版本库第7章项目管理者上传项目最初始代码这几张是有关Gitblit部分，主要是代码管理员需要学习服务器管理。开发人员请从后面相关部分学习，后面类容依然精彩，会告诉你怎么下载代码，构建工程，还有上传代码，更新代码。2.安装JDK安装JDK这个过程我就不再过多描述访问下载最新JDK,并按操作安装安装完毕后最好设置环境变量JAVA_HOME及PATH新建JAVA_HOME=C:\ProgramFiles\Java\jdk1.8.0_73(你的JDK安装目录，请核对你自己目录及版本)并把(;%JAVA_HOME%\bin;)加入到PATH大致流程如下图所示3.Gitblit服务器搭建访问地址：下载最新的Gitblitwindows版本，由于小型团队一般以windows机器为主，在这里只介绍windows版本的搭建Step1)下载gitblit-1.7.1.zipStep2)解压到D:\open_source\gitblit-1.7.1Step3)创建一个目录，用来存放代码库：D:/GitRepositoiesStep4)修改data目录下的gitblit.properties(D:\open_source\gitblit-1.7.1\data\gitblit.properties)加入以下红色内容##GITBLIT.PROPERTIES##Defineyourcustomsettingsinthisfileand/orincludesettingsdefinedin#otherpropertiesfiles.##IncludeGitblit's'defaults.properties'withinyourconfiguration.##NOTE:Gitblitwillnotautomaticallyreloadincludedproperties.Gitblit#onlywatchesthe'gitblit.properties'fileformodifications.##Pathsmayberelativetothe${baseFolder}ortheymaybeabsolute.##COMMA-DELIMITED#SINCE1.7.0include=defaults.properties##Defineyouroverridesorcustomsettingsbelow##Basefolderforrepositories.#Thisfoldermaycontainbareandnon-barerepositoriesbutGitblitwillonly#allowyoutopushtobarerepositories.#UseforwardslashesevenonWindows!!#e.g.c:/gitrepos##SINCE0.5.0#RESTARTREQUIRED#BASEFOLDERgit.repositoriesFolder=D:/GitRepositoies#Standardhttpporttoserve.=0disablesthisconnector.#OnUnix/Linuxsystems,ports1024requirerootpermissions.#Recommendedvalue:80or8080##SINCE0.5.0#RESTARTREQUIREDserver.httpPort=1000#Secure/SSLhttpsporttoserve.=0disablesthisconnector.#OnUnix/Linuxsystems,ports1024requirerootpermissions.#Recommendedvalue:443or8443##SINCE0.5.0#RESTARTREQUIREDserver.httpsPort=1001#SpecifytheinterfaceforJettytobindthestandardconnector.#Youmayspecifyaniporanemptyvaluetobindtoallinterfaces.#SpecifyinglocalhostwillresultinGitblitONLYlisteningtorequeststo#localhost.##SINCE0.5.0#RESTARTREQUIREDserver.httpBindInterface=#SpecifytheinterfaceforJettytobindthesecureconnector.#Youmayspecifyaniporanemptyvaluetobindtoallinterfaces.#SpecifyinglocalhostwillresultinGitblitONLYlisteningtorequeststo#localhost.##SINCE0.5.0#RESTARTREQUIREDserver.httpsBindInterface=注意：红色部分属性都是从同目录下defaults.properties拷贝过来，只是采用了我们自己的配置，其中为了安全及便利，我没有没有使用端口80及443，用1000及1001代替(因为我团队的机器80端口用作其他用途了)。并把仓库设置为Step3中的目录。Step5)修改D:\open_source\gitblit-1.7.1\installService.cmd下面红色部分@[e-mail](prunmgr.exe)isaGUIapplicationformonitoring@REMandconfiguringtheGitblitprocrunservice.@REM@REMBydefaultthistoollaunchestheservicepropertiesdialog@REMbutitalsohassomeotherveryusefulfunctionality.@REM@REM@REMarch=x86,amd64,oria32SETARCH=x86由于我的机器是x86-32位的，所以我改为x86,请对照你机器的架构选择如果你的机器是64位，请选择amd64Step6)安装windows服务用管理员权限打开CMD命令提示符,如下图所示然后再命令行中输入一下命令C:\Windows\system32d:D:\cdD:\open_source\gitblit-1.7.1D:\open_source\gitblit-1.7.1installServiceStep7)检查windows服务开始菜单“运行”中，输入services.msc并检查gitblit服务是否成功安装，由于开发团队每天都在用，确保为自动模式，每次windows启动都自动启动右键点击gitblit,并把服务启动起来注意：如果要删除服务，请直接运行D:\open_source\gitblit-1.7.1下面的uninstallService.cmdStep8)有可能服务器起来后，局域网其他机器无法访问，只能在本机浏览器中打开，这是由于防火墙的设置，你必须人工设置防火强规则。打开“控制面板”-“管理工具”-“高级安全Windows防火墙”由于我演示用的机器是windows10,也许名字会不对，请点击“管理工具”里面的有关“防火墙”选项就行如下图所示：然后“新建规则”，选择“程序”然后选择程序为D:\open_source\gitblit-1.7.1\x86\gitblit.exe注意这里”x86”是你在step5)中选择的架构然后点下一步然后点下一步：点下一步：然后会看到有下面一条记录Step8)然后可以在IE中输入其中IP地址换成你服务器的地址，注意，这里我们使用端口为1000，在前面gitblit.properties里面配置Gitblit安装完毕4.配置Gitblit用户用IE登陆系统：)用管理员账号登录确实用户名/密码：admin/adminStep2)修改管理员账户密码Step3)添加用户为你团队中的开发人员创建用户，只有授权用户才能进行相关操作然后点击添加用户然后填入成员基本信息，点击保存然后把用户名及初始密码发送给团队成员，让他们登陆进去修改密码Step4)创建项目组也许你的创业团队有好几个项目，每个项目都由不同的人开发，你可以为每个项目创建个团队。然后点击右上交“添加团队”并填写以下信息:例如我有一个项目名称叫“阿尔法猫”然后选择团队成员，当前只有我一个，也可以选择多个，如下图其他有关权限部分可以先不用关心，熟悉后请自行阅读中文档5.创建第一个Gitblit版本库：阿尔法猫Step1)使用系统管理员账号登陆，并点击“创建版本库”Step2)然后按要求填入以下信息可以给项目分组，那么在名称哪里填写：ai/alpha-mao表示项目alpha-mao属于ai分组，对于项目名称我们一般采用全小写，中间用分隔符“-”分离单词注意，为了保证代码的安全，我们选择第四个：限制查看，克隆及推送，只有加入项目组的人才能够查看项目。不像github，匿名用户可以查看克隆开源代码，一般创业团队的代码都是保密。其他信息可以不用填写，下面会告诉你怎么推送新代码到服务器。然后点击下面“创建”，Step3)设置项目权限当项目创建后，点击版本库又上角的“编辑”按钮然后设置团队及用户权限注意：请一定要点击“添加”按钮添加成功后，点击保存按钮注意，团队权限只有能够查看克隆推送的权限，但是没有创建，修改分支(branch)的权限我们这里设置了一个项目管理员：他除了有查看克隆推送的权限，还有创建分支的权限。在后面我们会看到lan.zhou这个用户能够直接在服务器上创建dev分支。到此我们创建了一个新的版本库，下面等待lan.zhou这个用户上传最初始的代码，然后团队里面的别人就可以克隆使用。6.下载最新的git工具并安装访问下载最新的git工具一般“32-bitGitforWindowsPortable”就行，一