GIT版本库操作手册及管理规范.docx

FESCO Adecco公司内部自建系统GIT代码版本库操作手册及管理规范版本1.0文档版本历史版本作者/修改者日期描述1.0刘传宏2016-01-29草稿1.1刘传宏2016-02-16修正文档中对各版本库的定义及概念【目录】1概述41.1编写目的41.2适用范围41.3名词解释42GIT操作使用说明52.1GIT工具的安装及权限开放申请52.2GIT工具的使用62.2.1从GIT导入项目62.2.2创建分支112.2.3代码提交122.2.4版本切换142.2.5代码同步142.2.6其他153GIT版本库管理规范154GIT版本结构图175GIT代码管理执行流程图18概述编写目的本文主要用于对公司内部自主研发的系统进行代码的版本管理，同时指导公司内部开发人员使用GIT工具进行统一的管理规范。本文所形成的规范将作为IT部门开发的标准流程进行管控，不定时的进行线上环境的抽查，各项目架构师也应当以此文进行严格的版本管理及执行监督。适用范围所有公司内部自主研发的项目。名词解释UAT环境：用于用户做验收时进行测试的环境，其中数据均为线上生产数据的备份，在未约定与用户进行验收测试的情况下，不对业务部门开放。测试环境：包含所有开发代码的环境，用于提供用户进行培训、演示等用途的临时环境，数据为加密及改版过的测试数据。PRO分支：用于执行ANT脚本进行自动发布的GIT环境，此处的代码必须与生产环境完全保持一致。UAT分支：用于保证系统的完整性，与PRO分支除数据库配置文件不同外，必须完全一致。GIT分支：由开发工程师根据需求所建的分支，由开发工程师从本地GIT资源库推送至公司统一的GIT版本资源库。测试分支：由项目组自行定义的分支，用于管理测试环境的代码版本库，可根据业务部门的用户需求自行合并GIT分支进行打包整合，以提供给BU部门稳定的可用的测试环境。GIT操作使用说明GIT工具的安装及权限开放申请GTI插件在ECLIPSE软件的安装及引用：官网下载当前必威体育精装版版的GIT插件，并放置于ECLIPSE项目插件结构下，ECLIPSE工具安装插件方法可参照官网上相应的教程：/egit/updates/配置SSH登陆口令：ECLIPSE程序中，Window-Preferences-输入SSH进行配置定位查询。打开配置界面，见下图：注：如图所见，Comment中必须按照公司流程规范填写域账号中对应的用户名，不允许出现不符合公司规范的用户名，如果出现则一律驳回。申请GIT访问权限：第二步完成后，将保存好的口令文件以邮件方式发送给GIT管理员，邮箱为liu.chuanhong@。由GIT环境的配置管理员进行相应的权限开通，管理员在开通前对账号的描述进行审核。不满足公司域账号规范命名的审核直接驳回，要求申请人重新申请处理。以上是GIT插件安装及权限申请的基本流程及方法，员工需要自行完成安装、配置及权限申请。GIT工具的使用本章节仅描述需要开发工程师按照标准的管理规范所使用到的插件的功能，涉及到代码的合并及提交方式，其余均暂不描述，开发工程师可自行对插件功能进行研究。从GIT导入项目右键Package Explore面板，选择IMPORT，选择Projects from Git，如图所示：点击NEXT，选择CLONE URI，如图所示：点击NEXT，填写项目GIT资源库路径信息等，如图所示（本文以公司ERP为DEMO进行图解）：点击NEXT，选择创建本地资源库的依据版本，如图所示：注：每个项目均会有一个标准待上线的发布版本作为公司内部的标准版本，各项目组在选择版本时如果存在疑问，可咨询项目对应的架构师，确定版本后，只需要勾选已经过确定的唯一版本即可。之后所有的版本将均以此版本的基础上进行提交和开发，如果在项目初期初始化的版本有问题，后续需要额外的进行切换，以此才能保证当前同步下来的版本是目前必威体育精装版的待上线版本。点击NEXT进行本地资源库的创建，如图所示：注：图中第一个红框处所代表的路径指本地的资源库路径，与WORKSPACE无关，建议不要存放在C盘，一旦由于系统重装等导致C盘遗失的，未提交至生产的GIT代码也同样将无法找回。git与SVN工具不同，它将同步一个资源库放在本地进行管理，在第一次同步初始化时，需要选择一个版本将本地与远程的版本进行关联，之后从GIT更新代码时，如无特殊的配置选择，同步下来的代码版本也均自动以用户初始化选择的版本进行关联和合并。版本的初始化选择如图中第二个红框所示。选择完成后点击NEXT，将会出现一个较长的同步过程，同步时间的长短与项目本身代码的大小有关，等待完成后，将出现如下图所示的界面：选择导入已经存在的项目，点击NEXT，如下图：点击FINISH，后续流程与导入本地项目一致，选择相应的编译版本，加入相应的JAR包文件，后续图略。