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

FESCO Adecco

公司内部自建系统GIT代码版本库操作手册及管理规范

版本<1.0>

文档版本历史

1.1刘传宏2016-02-16修正文档中对各版本库的定义及

概念

【目录】

1概述 (4)

1.1编写目的 (4)

1.2适用范围 (4)

1.3名词解释 (4)

2GIT操作使用说明 (5)

2.1GIT工具的安装及权限开放申请 (5)

2.2GIT工具的使用 (6)

2.2.1从GIT导入项目 (6)

2.2.2创建分支 (11)

2.2.3代码提交 (12)

2.2.4版本切换 (14)

2.2.5代码同步 (14)

2.2.6其他 (15)

3GIT版本库管理规范 (15)

4GIT版本结构图 (17)

5GIT代码管理执行流程图 (18)

1概述

1.1 编写目的

本文主要用于对公司内部自主研发的系统进行代码的版本管理，同时指导公司内部开发人员使用GIT工具进行统一的管理规范。

本文所形成的规范将作为IT部门开发的标准流程进行管控，不定时的进行线上环境的抽查，各项目架构师也应当以此文进行严格的版本管理及执行监督。

1.2 适用范围

所有公司内部自主研发的项目。

1.3 名词解释

UAT环境：用于用户做验收时进行测试的环境，其中数据均为线上生产数据的备份，在未约定与用户进行验收测试的情况下，不对业务部门开放。

测试环境：包含所有开发代码的环境，用于提供用户进行培训、演示等用途的临时环境，数据为加密及改版过的测试数据。

PRO分支：用于执行ANT脚本进行自动发布的GIT环境，此处的代码必须与生产环境完全保持一致。

UAT分支：用于保证系统的完整性，与PRO分支除数据库配置文件不同外，必须完全一致。

GIT分支：由开发工程师根据需求所建的分支，由开发工程师从本地GIT 资源库推送至公司统一的GIT版本资源库。

测试分支：由项目组自行定义的分支，用于管理测试环境的代码版本库，可根据业务部门的用户需求自行合并GIT分支进行打包整合，以提供给BU部门稳定的可用的测试环境。

2GIT操作使用说明

2.1 GIT工具的安装及权限开放申请

1.GTI插件在ECLIPSE软件的安装及引用：官网下载当前最新版的GIT插

件，并放置于ECLIPSE项目插件结构下，ECLIPSE工具安装插件方法

可参照官网上相应的教程：/egit/updates/

2.配置SSH登陆口令：ECLIPSE程序中，Window->Preferences->输入SSH

进行配置定位查询。打开配置界面，见下图：

注：如图所见，Comment中必须按照公司流程规范填写域账号中对应的

用户名，不允许出现不符合公司规范的用户名，如果出现则一律驳回。

3.申请GIT访问权限：第二步完成后，将保存好的口令文件以邮件方式发

送给GIT管理员，邮箱为*****************************。由GIT环境

的配置管理员进行相应的权限开通，管理员在开通前对账号的描述进行

审核。不满足公司域账号规范命名的审核直接驳回，要求申请人重新申

请处理。

以上是GIT插件安装及权限申请的基本流程及方法，员工需要自行完成安装、配置及权限申请。

2.2 GIT工具的使用

本章节仅描述需要开发工程师按照标准的管理规范所使用到的插件的功能，涉及到代码的合并及提交方式，其余均暂不描述，开发工程师可自行对插件功能进行研究。

2.2.1从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包文件，后续图略。

2.2.2创建分支

按照新制定的开发规范，将来所有的开发将全部在本地以分支的方式进行管理，由开发工程师本地进行维护和统一管控，具体规章制度如后文所描述，本章节描述分支创建的方法及过程。

与SVN插件使用方式相同，GIT插件需要对项目进行右键，点击TEAM来操作。

通过点击Switch To来切换本地已经存在的分支版本。创建分支，则需要点击New Branch进行操作，点击后将会出现如下图所示界面：