gitlab上传本地项目（gitlab如何把项目上传）

本文目录一览：

• 1、getlab仓库项目更新,本地怎样更新
• 2、创建新的项目并上传到gitlab远端仓库
• 3、gitlab上可以上传文本材料吗
• 4、代码管理-gitlab使用方法建议
• 5、Gitlab是什么？

getlab仓库项目更新,本地怎样更新

可以。

gitlab上传本地项目（gitlab如何把项目上传）

gitlab上可以上传文本材料，上传文本材料把文件到要上传的本地git目录中，进入本地git文件所在目录，将要上传文件加入索引中，将要上传的文件提交到本地仓库，文件同步到GitLab上就上传好了。

GitLab是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的Web服务。安装方法是参考GitLab在GitHub上的Wiki页面。Gitlab是被广泛使用的基于git的开源代码管理平台,基于RubyonRails构建,主要针对软件开发过程中产生的代码和文档进行管理。

1.在gitlab上创建项目

2.在本地项目中 执行命令 git init 使这个目录变成git可以管理的仓库

3.接着执行命令 git add . 把所有文件添加到暂存区里面去

4.执行命令 git commit -m “init” ，把文件提交到仓库。引号内为提交说明。

5.执行命令 git remote add origin git@gitlab.xxxx :Dev/xxx.git 为远程库，进行关联

6.如果远程仓库不为空，一定要先pull。执行命令 git pull --rebase orgin (本次任务中，就遇到了这个问题，先执行第七步则一直报错。如果没有远程仓库则不用先pull)

对gitlab的使用主要从两个角度去分析，一个是，一个是开发提交者。

1.1 初始配置

浏览器访问 ://IP:11000

次访问会默认以root用户登陆，需要输入两遍密码。

登陆后，可以看到，gitlab中主要围绕着以下几个概念进行作：

group 团队

如果是作为个人使用，那么使用root用户创建project就可以实现上传下载代码了。

如果是小团队项目，就需要创建group，并在group中创建projects，添加user到group中，并给用户相应的权限。

1.1.1 关闭系统注册功能

为了便于管理，可以选择关闭gitlab的注册功能.

在主界面左边条依次选择 Settings -> General -> Sign-up restrictions ,点击 Expand 按钮，在 Sign-up restrictions 选项处将勾点掉，下拉点击 Se changes 就可以了。

1.1.2 修改网站logo

为了让我们的gitlab看起来更符合项目，可以对网站的logo进行调整，在 Appearance 中对 导航条图标（Nigation bar）、网站图标（Ficon）、登陆页图标（Sign in/Sign up pages）进行设置。

1.2 代码管理

1.2.1 团队协作方式

gitlab团队协作主要有两种方式：

使用fork

项目负责人在gitlab上新建一个项目，并分享URL给开发人员

开发人员在负责人的gitlab项目页面上点击“fork”按钮，将此项目fork到自己的gitlab上，这相当于是从负责人那拷贝了一份项目副本，无论开发人员如何修改代码都不会影响负责人那分支上的代码

然后开发人员可以根据自己的项目分工，像对待普通项目一样做clone、add、commit、push等作

如果开发人员人为一个小模块做好了，可以点击“New Merge Request”按钮，向负责人发送代码合并请求，要合并的代码文件也会以列表的形式同时发送给负责人，此时负责人会看到开发人员的请求，经审核如果代码没问题则会合并模块，并向开发人员发送确认合并的通知

不使用fork

1. 负责人为开发人员分别创建开发分支（namedev_branch）

项目负责人在gitlab上新建一个项目，并为每一个开发人员创建一个开发分支（namedev_branch）

开发人员clone项目之后，经git branch检查发现本地只有分支，因此也需要把属于自己的开发分支也一起获取下来

> `git fetch origin namedev_branch:namedev_branch`

> `#拉取远程的一个叫namedev_branch的分支，并在本地创建一个叫namedev_branch的分支和远程的分支匹配`

切换到namedev_branch分支

> `git checkout namedev_branch`

之后的作如同对待普通项目一样

> `git add hello.py`

> `git commit -m add hello.py`

> `git push -u origin namedev_branch #需要注意，是push到远程的namedev_branch分支`

~~这个方式感觉有风险，项目成员要注意自己的branch，很容易因为忽略branch直接向提交变更，对代码管理会添加麻烦~~

2. 负责人不为开发人员分别创建开发分支 （开发者自己创建）

虽然项目负责人不分别为开发人员创建分支，但是需要把他们添加到一个group中，否则开发人员在向项目push自己的开发分支时遇到权限错误

开发人员在把项目clone之后需要为自己新建一个开发分支（namedev_branch），因为经由git branch查看发现本地只有分支

> `git branch namedev_branch #新建分支`

> `git checkout namedev_branch #切换到开发分支`

> `git push origin namedev_branch #将新建的开发分支push到远程项目上`

之后的作如同对待普通项目一样

> `git add hello.py`

> `git commit -m add hello.py`

> `git push -u origin namedev_branch #需要注意，是push到远程的namedev_branch分支`

之后，两种方式下项目负责人都可以在项目的gitlab主页上看到每个开发人员的工作进度，并考虑何时merge开发人员的分支到分支上以完善项目。

所有成员包括项目负责人除克隆、修改、提交代码这些作外，其它merge、建立分支等作都在Gitlab网页端进行。

所有分支中，分支为主干分支，此分支的代码不允许直接修改，只能由其它分支（一般只由dlop分支）发出merge请求，经项目代码审查通过后合并代码，普通开发者无权执行push、merge等作，确保此分支任何时候、任何tag处导出的项目代码都是稳定可正常运行的代码；dlop分支为开发分支，可以接受由其它分支发起的merge请求，同样只能经项目代码审查通过后予以合并。

1.2.2 团队初始化

设我们项目组分为两个组team1、team2，每个组有不同的组员和对应的不同的子项目,对项目组用户开放项目的访问，使用fork方式来做代码的更新和提交。

因此我们的gitlab的架构大概是这样的：

1. 创建Group，在主界面上方的加号选择New Group,创建Group只需要填写 Group path 、Group name、Description 几个选项就可以了。Visibility Ll选项选择 Private-私有仓库

2. 创建user，对需要加进来的团员，由负责给他们创建相应的用户，创建用户需要填写合法的Email地址，正常情况下会向这个Email发送登陆的初始连接，但是如果不方便的话，也可以在创建后由修改这个user的初始登陆密码。

3. 选中Group添加相应的user，user的角色分以下几种：Guest、Reporter、Dloper、Maintainer、owner，基本上我们只会用到guest和dloper两种。

4. 在Group中创建project，选中Subgroup，点击 New project 来创建新的项目。

5. 项目完成创建后，相应的团队成员也可以使用fork来获取项目的内容,fork后属于成员自己的项目的git地址是不一样的，这个一定要注意，后面提交代码都是提交到这个fork项目的地址，只有在网页端发起merge request 以及从更新fork项目时才会用到主项目

1.2.3 代码提交管理

当有新的代码提交请求时，项目负责人可以通过查看merge requests获取到来自fork或者branch的合并请求：

接受合并时，可以选择 Open in Web IDE 来检查审核变更的内容，确认没问题后点击Merge按钮来合并。

1.2.4 活跃度查询

右边条选择 Project -> Activity 可以看到push、merge、issue、comment（讨论）等信息

选择 Cycle Analytics 可以看到图形化的分析内容，这部分需要有足够的数据支持，还需要好好研究下。

> Cycle Analytics measures the time it takes to go from an idea to production for each project you he.

> 周期分析功能是监测从每个项目一个想法到产品所需的时间。

## 项目开发方式 issue+milestone+label

如何结合gitlab提供的这些功能来完整的梳理、管理一个产品、或者一个模块的开发方式

定义一个开发任务从开始如何分配到如何标识完成的过程。

这一块是用好gitlab的重点，否则就是用gitlab来做一个简单的代替svn的版本管理工具

2.1 fork项目

项目成员首先利用浏览器进入gitlab的系统后，查看自己的group和project，并fork自己需要参与开发的project。

> 在project的detail界面中点击fork按钮。

fork时会提示选择Namespace，这个选择是用来决定这个工程所属的，可以选Users,或者选择Groups，这个会影响到后面工程的，项目成员都统一选择users本人的命名空间就可以了。

2.2 获取fork项目

项目内容获取主要使用git客户端工具来实现，项目开发人员首先要在本机安装git客户端软件，[]()

安装时基本都采用默认设置就可以了。

安装完成后我们主要使用Git Bash命令行工具来工作。

2.3 设置账户信息

设置修改本地对应的gitlab用户和邮箱。

2.4 配置ssh连接信息 （windows下没调成功）

1. 创建 SSH密钥

通过下面的命令生成密钥，将命令中的YOUR_EMAIL@YOUREMAIL.COM替换为注册Gitlab时用的Email地址。

`ssh-keygen -t rsa -C duwj@gitlab`

注意：Enter passphrase (empty for no passphrase) :时，可以直接按两次回车键输入一个空的 passphrase；也可以选择输入一个 passphrase 口令，如果此时你输入了一个passphrase，请牢记，之后每次提交时都需要输入这个口令来确认。

2. 获取公钥内容

SSH密钥生成结束后，根据提示信息找到SSH目录（通常ssh密钥保存路径均为~/.ssh 目录），会看到私钥id_rsa和公钥id_rsa.pub这两个文件，不要把私钥文件id_rsa的信息透露给任何人。

用记事本打开id_rsa.pub，里面的所有内容以备下一步使用。

3. 将密钥中的公钥添加到Gitlab

登录Gitlab的web站点，进入设置 - SSH Keys页面，将第2步所获得的内容粘贴在文本框key内，并填写title以便记忆，而后保存。

2.5 克隆代码

在gitlab网页端进入project的detail中可以下拉看到提示的代码信息。

这样在本地就可以获取到fork的项目内容。

2.6 正常代码更新提交

2.7 更新本地仓库内容命令

2.8 请求合并到

在网页端进入到project的detail界面后，如果fork的项目代码有变动，在界面右上角会提示Create merge request 来提交合并申请

点击创建后，输入本次提交的title和描述，描述要说明本次提交修改的脚本、修改的内容等信息，便于审核。

2.9 【关键】同步库内容

fork后的项目不会自动从主分支获取更新，需要负责fork的开发人员自己更新版本

如何更新已经fork的代码：

首先要先确定一下是否建立了主repo的远程源：

在本地项目库下执行 `git remote -v`

如果里面只能看到你自己的两个源(fetch 和 push)，那就需要添加主repo的源：

fetch源分支的新版本到本地

执行 `git fetch upstream`

执行后本地库的内容会更新为与库一致的内容

合并本地两个版本的代码：

执行 `git merge upstream/`

将在本地合并后的代码push到自己的github上去，以更新github上fork的仓库

执行 `git push origin `

执行后网页端的仓库内容更新为合并后的新版本

对于开发人员来说，会使用fork克隆项目，会使用本地git客户端对项目内容进行更新、编辑、提交，会在网页端提交代码合并申请并且规范编写申请描述就足够了。

对管理人员来说，使用gitlab能方便的知道每个员工负责的内容的提交进度情况，方便对他们提交的代码进行质量的检查走读，还有更多统计类、开发进度管理等等功能，但是需要熟练掌握gitlab上的一些功能使用方法，比如使用issue来管理开发任务分配，使用milestone来制定和管理里程碑等等。

# 3. gitlab使用开发规范

参考：[gitlab使用开发规范]()

Gitlab是开放式一体化安全DevOps平台，集成了项目管理，CVCD，安全以及配置，软件研发全生命周期的DevOps 能力.太平洋电信是极狐(GitLab)铂金级别合作伙伴，致力于为跨境电商企业提供一个更符合国人使用习惯的软件研发全周期解决方案，提供优质的代码托管、DevOps一体化平台服务和安全、高速的网络体验。

1、首先创建一个空文件夹当作你作的空间。

2、然后进入这个文件夹，把想更新的gitlab地址拿过来。

3、在git上创建分支即可。

创建新的项目并上传到gitlab远端仓库

可以。

gitlab上可以上传文本材料，上传文本材料把文件到要上传的本地git目录中，进入本地git文件所在目录，将要上传文件加入索引中，将要上传的文件提交到本地仓库，文件同步到GitLab上就上传好了。

GitLab是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的Web服务。安装方法是参考GitLab在GitHub上的Wiki页面。Gitlab是被广泛使用的基于git的开源代码管理平台,基于RubyonRails构建,主要针对软件开发过程中产生的代码和文档进行管理。

1.在gitlab上创建项目

2.在本地项目中 执行命令 git init 使这个目录变成git可以管理的仓库

3.接着执行命令 git add . 把所有文件添加到暂存区里面去

4.执行命令 git commit -m “init” ，把文件提交到仓库。引号内为提交说明。

5.执行命令 git remote add origin git@gitlab.xxxx :Dev/xxx.git 为远程库，进行关联

6.如果远程仓库不为空，一定要先pull。执行命令 git pull --rebase orgin (本次任务中，就遇到了这个问题，先执行第七步则一直报错。如果没有远程仓库则不用先pull)

gitlab上可以上传文本材料吗

可以。

gitlab上可以上传文本材料，上传文本材料把文件到要上传的本地git目录中，进入本地git文件所在目录，将要上传文件加入索引中，将要上传的文件提交到本地仓库，文件同步到GitLab上就上传好了。

GitLab是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的Web服务。安装方法是参考GitLab在GitHub上的Wiki页面。Gitlab是被广泛使用的基于git的开源代码管理平台,基于RubyonRails构建,主要针对软件开发过程中产生的代码和文档进行管理。

代码管理-gitlab使用方法建议

可以。

gitlab上可以上传文本材料，上传文本材料把文件到要上传的本地git目录中，进入本地git文件所在目录，将要上传文件加入索引中，将要上传的文件提交到本地仓库，文件同步到GitLab上就上传好了。

GitLab是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的Web服务。安装方法是参考GitLab在GitHub上的Wiki页面。Gitlab是被广泛使用的基于git的开源代码管理平台,基于RubyonRails构建,主要针对软件开发过程中产生的代码和文档进行管理。

1.在gitlab上创建项目

2.在本地项目中 执行命令 git init 使这个目录变成git可以管理的仓库

3.接着执行命令 git add . 把所有文件添加到暂存区里面去

4.执行命令 git commit -m “init” ，把文件提交到仓库。引号内为提交说明。

5.执行命令 git remote add origin git@gitlab.xxxx :Dev/xxx.git 为远程库，进行关联

6.如果远程仓库不为空，一定要先pull。执行命令 git pull --rebase orgin (本次任务中，就遇到了这个问题，先执行第七步则一直报错。如果没有远程仓库则不用先pull)

对gitlab的使用主要从两个角度去分析，一个是，一个是开发提交者。

1.1 初始配置

浏览器访问 ://IP:11000

次访问会默认以root用户登陆，需要输入两遍密码。

登陆后，可以看到，gitlab中主要围绕着以下几个概念进行作：

group 团队

如果是作为个人使用，那么使用root用户创建project就可以实现上传下载代码了。

如果是小团队项目，就需要创建group，并在group中创建projects，添加user到group中，并给用户相应的权限。

1.1.1 关闭系统注册功能

为了便于管理，可以选择关闭gitlab的注册功能.

在主界面左边条依次选择 Settings -> General -> Sign-up restrictions ,点击 Expand 按钮，在 Sign-up restrictions 选项处将勾点掉，下拉点击 Se changes 就可以了。

1.1.2 修改网站logo

为了让我们的gitlab看起来更符合项目，可以对网站的logo进行调整，在 Appearance 中对 导航条图标（Nigation bar）、网站图标（Ficon）、登陆页图标（Sign in/Sign up pages）进行设置。

1.2 代码管理

1.2.1 团队协作方式

gitlab团队协作主要有两种方式：

使用fork

项目负责人在gitlab上新建一个项目，并分享URL给开发人员

开发人员在负责人的gitlab项目页面上点击“fork”按钮，将此项目fork到自己的gitlab上，这相当于是从负责人那拷贝了一份项目副本，无论开发人员如何修改代码都不会影响负责人那分支上的代码

然后开发人员可以根据自己的项目分工，像对待普通项目一样做clone、add、commit、push等作

如果开发人员人为一个小模块做好了，可以点击“New Merge Request”按钮，向负责人发送代码合并请求，要合并的代码文件也会以列表的形式同时发送给负责人，此时负责人会看到开发人员的请求，经审核如果代码没问题则会合并模块，并向开发人员发送确认合并的通知

不使用fork

1. 负责人为开发人员分别创建开发分支（namedev_branch）

项目负责人在gitlab上新建一个项目，并为每一个开发人员创建一个开发分支（namedev_branch）

开发人员clone项目之后，经git branch检查发现本地只有分支，因此也需要把属于自己的开发分支也一起获取下来

> `git fetch origin namedev_branch:namedev_branch`

> `#拉取远程的一个叫namedev_branch的分支，并在本地创建一个叫namedev_branch的分支和远程的分支匹配`

切换到namedev_branch分支

> `git checkout namedev_branch`

之后的作如同对待普通项目一样

> `git add hello.py`

> `git commit -m add hello.py`

> `git push -u origin namedev_branch #需要注意，是push到远程的namedev_branch分支`

~~这个方式感觉有风险，项目成员要注意自己的branch，很容易因为忽略branch直接向提交变更，对代码管理会添加麻烦~~

2. 负责人不为开发人员分别创建开发分支 （开发者自己创建）

虽然项目负责人不分别为开发人员创建分支，但是需要把他们添加到一个group中，否则开发人员在向项目push自己的开发分支时遇到权限错误

开发人员在把项目clone之后需要为自己新建一个开发分支（namedev_branch），因为经由git branch查看发现本地只有分支

> `git branch namedev_branch #新建分支`

> `git checkout namedev_branch #切换到开发分支`

> `git push origin namedev_branch #将新建的开发分支push到远程项目上`

之后的作如同对待普通项目一样

> `git add hello.py`

> `git commit -m add hello.py`

> `git push -u origin namedev_branch #需要注意，是push到远程的namedev_branch分支`

之后，两种方式下项目负责人都可以在项目的gitlab主页上看到每个开发人员的工作进度，并考虑何时merge开发人员的分支到分支上以完善项目。

所有成员包括项目负责人除克隆、修改、提交代码这些作外，其它merge、建立分支等作都在Gitlab网页端进行。

所有分支中，分支为主干分支，此分支的代码不允许直接修改，只能由其它分支（一般只由dlop分支）发出merge请求，经项目代码审查通过后合并代码，普通开发者无权执行push、merge等作，确保此分支任何时候、任何tag处导出的项目代码都是稳定可正常运行的代码；dlop分支为开发分支，可以接受由其它分支发起的merge请求，同样只能经项目代码审查通过后予以合并。

1.2.2 团队初始化

设我们项目组分为两个组team1、team2，每个组有不同的组员和对应的不同的子项目,对项目组用户开放项目的访问，使用fork方式来做代码的更新和提交。

因此我们的gitlab的架构大概是这样的：

1. 创建Group，在主界面上方的加号选择New Group,创建Group只需要填写 Group path 、Group name、Description 几个选项就可以了。Visibility Ll选项选择 Private-私有仓库

2. 创建user，对需要加进来的团员，由负责给他们创建相应的用户，创建用户需要填写合法的Email地址，正常情况下会向这个Email发送登陆的初始连接，但是如果不方便的话，也可以在创建后由修改这个user的初始登陆密码。

3. 选中Group添加相应的user，user的角色分以下几种：Guest、Reporter、Dloper、Maintainer、owner，基本上我们只会用到guest和dloper两种。

4. 在Group中创建project，选中Subgroup，点击 New project 来创建新的项目。

5. 项目完成创建后，相应的团队成员也可以使用fork来获取项目的内容,fork后属于成员自己的项目的git地址是不一样的，这个一定要注意，后面提交代码都是提交到这个fork项目的地址，只有在网页端发起merge request 以及从更新fork项目时才会用到主项目

1.2.3 代码提交管理

当有新的代码提交请求时，项目负责人可以通过查看merge requests获取到来自fork或者branch的合并请求：

接受合并时，可以选择 Open in Web IDE 来检查审核变更的内容，确认没问题后点击Merge按钮来合并。

1.2.4 活跃度查询

右边条选择 Project -> Activity 可以看到push、merge、issue、comment（讨论）等信息

选择 Cycle Analytics 可以看到图形化的分析内容，这部分需要有足够的数据支持，还需要好好研究下。

> Cycle Analytics measures the time it takes to go from an idea to production for each project you he.

> 周期分析功能是监测从每个项目一个想法到产品所需的时间。

## 项目开发方式 issue+milestone+label

如何结合gitlab提供的这些功能来完整的梳理、管理一个产品、或者一个模块的开发方式

定义一个开发任务从开始如何分配到如何标识完成的过程。

这一块是用好gitlab的重点，否则就是用gitlab来做一个简单的代替svn的版本管理工具

2.1 fork项目

项目成员首先利用浏览器进入gitlab的系统后，查看自己的group和project，并fork自己需要参与开发的project。

> 在project的detail界面中点击fork按钮。

fork时会提示选择Namespace，这个选择是用来决定这个工程所属的，可以选Users,或者选择Groups，这个会影响到后面工程的，项目成员都统一选择users本人的命名空间就可以了。

2.2 获取fork项目

项目内容获取主要使用git客户端工具来实现，项目开发人员首先要在本机安装git客户端软件，[]()

安装时基本都采用默认设置就可以了。

安装完成后我们主要使用Git Bash命令行工具来工作。

2.3 设置账户信息

设置修改本地对应的gitlab用户和邮箱。

2.4 配置ssh连接信息 （windows下没调成功）

1. 创建 SSH密钥

通过下面的命令生成密钥，将命令中的YOUR_EMAIL@YOUREMAIL.COM替换为注册Gitlab时用的Email地址。

`ssh-keygen -t rsa -C duwj@gitlab`

注意：Enter passphrase (empty for no passphrase) :时，可以直接按两次回车键输入一个空的 passphrase；也可以选择输入一个 passphrase 口令，如果此时你输入了一个passphrase，请牢记，之后每次提交时都需要输入这个口令来确认。

2. 获取公钥内容

SSH密钥生成结束后，根据提示信息找到SSH目录（通常ssh密钥保存路径均为~/.ssh 目录），会看到私钥id_rsa和公钥id_rsa.pub这两个文件，不要把私钥文件id_rsa的信息透露给任何人。

用记事本打开id_rsa.pub，里面的所有内容以备下一步使用。

3. 将密钥中的公钥添加到Gitlab

登录Gitlab的web站点，进入设置 - SSH Keys页面，将第2步所获得的内容粘贴在文本框key内，并填写title以便记忆，而后保存。

2.5 克隆代码

在gitlab网页端进入project的detail中可以下拉看到提示的代码信息。

这样在本地就可以获取到fork的项目内容。

2.6 正常代码更新提交

2.7 更新本地仓库内容命令

2.8 请求合并到

在网页端进入到project的detail界面后，如果fork的项目代码有变动，在界面右上角会提示Create merge request 来提交合并申请

点击创建后，输入本次提交的title和描述，描述要说明本次提交修改的脚本、修改的内容等信息，便于审核。

2.9 【关键】同步库内容

fork后的项目不会自动从主分支获取更新，需要负责fork的开发人员自己更新版本

如何更新已经fork的代码：

首先要先确定一下是否建立了主repo的远程源：

在本地项目库下执行 `git remote -v`

如果里面只能看到你自己的两个源(fetch 和 push)，那就需要添加主repo的源：

fetch源分支的新版本到本地

执行 `git fetch upstream`

执行后本地库的内容会更新为与库一致的内容

合并本地两个版本的代码：

执行 `git merge upstream/`

将在本地合并后的代码push到自己的github上去，以更新github上fork的仓库

执行 `git push origin `

执行后网页端的仓库内容更新为合并后的新版本

对于开发人员来说，会使用fork克隆项目，会使用本地git客户端对项目内容进行更新、编辑、提交，会在网页端提交代码合并申请并且规范编写申请描述就足够了。

对管理人员来说，使用gitlab能方便的知道每个员工负责的内容的提交进度情况，方便对他们提交的代码进行质量的检查走读，还有更多统计类、开发进度管理等等功能，但是需要熟练掌握gitlab上的一些功能使用方法，比如使用issue来管理开发任务分配，使用milestone来制定和管理里程碑等等。

# 3. gitlab使用开发规范

参考：[gitlab使用开发规范]()

Gitlab是什么？

可以。

gitlab上可以上传文本材料，上传文本材料把文件到要上传的本地git目录中，进入本地git文件所在目录，将要上传文件加入索引中，将要上传的文件提交到本地仓库，文件同步到GitLab上就上传好了。

GitLab是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的Web服务。安装方法是参考GitLab在GitHub上的Wiki页面。Gitlab是被广泛使用的基于git的开源代码管理平台,基于RubyonRails构建,主要针对软件开发过程中产生的代码和文档进行管理。

1.在gitlab上创建项目

2.在本地项目中 执行命令 git init 使这个目录变成git可以管理的仓库

3.接着执行命令 git add . 把所有文件添加到暂存区里面去

4.执行命令 git commit -m “init” ，把文件提交到仓库。引号内为提交说明。

5.执行命令 git remote add origin git@gitlab.xxxx :Dev/xxx.git 为远程库，进行关联

6.如果远程仓库不为空，一定要先pull。执行命令 git pull --rebase orgin (本次任务中，就遇到了这个问题，先执行第七步则一直报错。如果没有远程仓库则不用先pull)

对gitlab的使用主要从两个角度去分析，一个是，一个是开发提交者。

1.1 初始配置

浏览器访问 ://IP:11000

次访问会默认以root用户登陆，需要输入两遍密码。

登陆后，可以看到，gitlab中主要围绕着以下几个概念进行作：

group 团队

如果是作为个人使用，那么使用root用户创建project就可以实现上传下载代码了。

如果是小团队项目，就需要创建group，并在group中创建projects，添加user到group中，并给用户相应的权限。

1.1.1 关闭系统注册功能

为了便于管理，可以选择关闭gitlab的注册功能.

在主界面左边条依次选择 Settings -> General -> Sign-up restrictions ,点击 Expand 按钮，在 Sign-up restrictions 选项处将勾点掉，下拉点击 Se changes 就可以了。

1.1.2 修改网站logo

为了让我们的gitlab看起来更符合项目，可以对网站的logo进行调整，在 Appearance 中对 导航条图标（Nigation bar）、网站图标（Ficon）、登陆页图标（Sign in/Sign up pages）进行设置。

1.2 代码管理

1.2.1 团队协作方式

gitlab团队协作主要有两种方式：

使用fork

项目负责人在gitlab上新建一个项目，并分享URL给开发人员

开发人员在负责人的gitlab项目页面上点击“fork”按钮，将此项目fork到自己的gitlab上，这相当于是从负责人那拷贝了一份项目副本，无论开发人员如何修改代码都不会影响负责人那分支上的代码

然后开发人员可以根据自己的项目分工，像对待普通项目一样做clone、add、commit、push等作

如果开发人员人为一个小模块做好了，可以点击“New Merge Request”按钮，向负责人发送代码合并请求，要合并的代码文件也会以列表的形式同时发送给负责人，此时负责人会看到开发人员的请求，经审核如果代码没问题则会合并模块，并向开发人员发送确认合并的通知

不使用fork

1. 负责人为开发人员分别创建开发分支（namedev_branch）

项目负责人在gitlab上新建一个项目，并为每一个开发人员创建一个开发分支（namedev_branch）

开发人员clone项目之后，经git branch检查发现本地只有分支，因此也需要把属于自己的开发分支也一起获取下来

> `git fetch origin namedev_branch:namedev_branch`

> `#拉取远程的一个叫namedev_branch的分支，并在本地创建一个叫namedev_branch的分支和远程的分支匹配`

切换到namedev_branch分支

> `git checkout namedev_branch`

之后的作如同对待普通项目一样

> `git add hello.py`

> `git commit -m add hello.py`

> `git push -u origin namedev_branch #需要注意，是push到远程的namedev_branch分支`

~~这个方式感觉有风险，项目成员要注意自己的branch，很容易因为忽略branch直接向提交变更，对代码管理会添加麻烦~~

2. 负责人不为开发人员分别创建开发分支 （开发者自己创建）

虽然项目负责人不分别为开发人员创建分支，但是需要把他们添加到一个group中，否则开发人员在向项目push自己的开发分支时遇到权限错误

开发人员在把项目clone之后需要为自己新建一个开发分支（namedev_branch），因为经由git branch查看发现本地只有分支

> `git branch namedev_branch #新建分支`

> `git checkout namedev_branch #切换到开发分支`

> `git push origin namedev_branch #将新建的开发分支push到远程项目上`

之后的作如同对待普通项目一样

> `git add hello.py`

> `git commit -m add hello.py`

> `git push -u origin namedev_branch #需要注意，是push到远程的namedev_branch分支`

之后，两种方式下项目负责人都可以在项目的gitlab主页上看到每个开发人员的工作进度，并考虑何时merge开发人员的分支到分支上以完善项目。

所有成员包括项目负责人除克隆、修改、提交代码这些作外，其它merge、建立分支等作都在Gitlab网页端进行。

所有分支中，分支为主干分支，此分支的代码不允许直接修改，只能由其它分支（一般只由dlop分支）发出merge请求，经项目代码审查通过后合并代码，普通开发者无权执行push、merge等作，确保此分支任何时候、任何tag处导出的项目代码都是稳定可正常运行的代码；dlop分支为开发分支，可以接受由其它分支发起的merge请求，同样只能经项目代码审查通过后予以合并。

1.2.2 团队初始化

设我们项目组分为两个组team1、team2，每个组有不同的组员和对应的不同的子项目,对项目组用户开放项目的访问，使用fork方式来做代码的更新和提交。

因此我们的gitlab的架构大概是这样的：

1. 创建Group，在主界面上方的加号选择New Group,创建Group只需要填写 Group path 、Group name、Description 几个选项就可以了。Visibility Ll选项选择 Private-私有仓库

2. 创建user，对需要加进来的团员，由负责给他们创建相应的用户，创建用户需要填写合法的Email地址，正常情况下会向这个Email发送登陆的初始连接，但是如果不方便的话，也可以在创建后由修改这个user的初始登陆密码。

3. 选中Group添加相应的user，user的角色分以下几种：Guest、Reporter、Dloper、Maintainer、owner，基本上我们只会用到guest和dloper两种。

4. 在Group中创建project，选中Subgroup，点击 New project 来创建新的项目。

5. 项目完成创建后，相应的团队成员也可以使用fork来获取项目的内容,fork后属于成员自己的项目的git地址是不一样的，这个一定要注意，后面提交代码都是提交到这个fork项目的地址，只有在网页端发起merge request 以及从更新fork项目时才会用到主项目

1.2.3 代码提交管理

当有新的代码提交请求时，项目负责人可以通过查看merge requests获取到来自fork或者branch的合并请求：

接受合并时，可以选择 Open in Web IDE 来检查审核变更的内容，确认没问题后点击Merge按钮来合并。

1.2.4 活跃度查询

右边条选择 Project -> Activity 可以看到push、merge、issue、comment（讨论）等信息

选择 Cycle Analytics 可以看到图形化的分析内容，这部分需要有足够的数据支持，还需要好好研究下。

> Cycle Analytics measures the time it takes to go from an idea to production for each project you he.

> 周期分析功能是监测从每个项目一个想法到产品所需的时间。

## 项目开发方式 issue+milestone+label

如何结合gitlab提供的这些功能来完整的梳理、管理一个产品、或者一个模块的开发方式

定义一个开发任务从开始如何分配到如何标识完成的过程。

这一块是用好gitlab的重点，否则就是用gitlab来做一个简单的代替svn的版本管理工具

2.1 fork项目

项目成员首先利用浏览器进入gitlab的系统后，查看自己的group和project，并fork自己需要参与开发的project。

> 在project的detail界面中点击fork按钮。

fork时会提示选择Namespace，这个选择是用来决定这个工程所属的，可以选Users,或者选择Groups，这个会影响到后面工程的，项目成员都统一选择users本人的命名空间就可以了。

2.2 获取fork项目

项目内容获取主要使用git客户端工具来实现，项目开发人员首先要在本机安装git客户端软件，[]()

安装时基本都采用默认设置就可以了。

安装完成后我们主要使用Git Bash命令行工具来工作。

2.3 设置账户信息

设置修改本地对应的gitlab用户和邮箱。

2.4 配置ssh连接信息 （windows下没调成功）

1. 创建 SSH密钥

通过下面的命令生成密钥，将命令中的YOUR_EMAIL@YOUREMAIL.COM替换为注册Gitlab时用的Email地址。

`ssh-keygen -t rsa -C duwj@gitlab`

注意：Enter passphrase (empty for no passphrase) :时，可以直接按两次回车键输入一个空的 passphrase；也可以选择输入一个 passphrase 口令，如果此时你输入了一个passphrase，请牢记，之后每次提交时都需要输入这个口令来确认。

2. 获取公钥内容

SSH密钥生成结束后，根据提示信息找到SSH目录（通常ssh密钥保存路径均为~/.ssh 目录），会看到私钥id_rsa和公钥id_rsa.pub这两个文件，不要把私钥文件id_rsa的信息透露给任何人。

用记事本打开id_rsa.pub，里面的所有内容以备下一步使用。

3. 将密钥中的公钥添加到Gitlab

登录Gitlab的web站点，进入设置 - SSH Keys页面，将第2步所获得的内容粘贴在文本框key内，并填写title以便记忆，而后保存。

2.5 克隆代码

在gitlab网页端进入project的detail中可以下拉看到提示的代码信息。

这样在本地就可以获取到fork的项目内容。

2.6 正常代码更新提交

2.7 更新本地仓库内容命令

2.8 请求合并到

在网页端进入到project的detail界面后，如果fork的项目代码有变动，在界面右上角会提示Create merge request 来提交合并申请

点击创建后，输入本次提交的title和描述，描述要说明本次提交修改的脚本、修改的内容等信息，便于审核。

2.9 【关键】同步库内容

fork后的项目不会自动从主分支获取更新，需要负责fork的开发人员自己更新版本

如何更新已经fork的代码：

首先要先确定一下是否建立了主repo的远程源：

在本地项目库下执行 `git remote -v`

如果里面只能看到你自己的两个源(fetch 和 push)，那就需要添加主repo的源：

fetch源分支的新版本到本地

执行 `git fetch upstream`

执行后本地库的内容会更新为与库一致的内容

合并本地两个版本的代码：

执行 `git merge upstream/`

将在本地合并后的代码push到自己的github上去，以更新github上fork的仓库

执行 `git push origin `

执行后网页端的仓库内容更新为合并后的新版本

对于开发人员来说，会使用fork克隆项目，会使用本地git客户端对项目内容进行更新、编辑、提交，会在网页端提交代码合并申请并且规范编写申请描述就足够了。

对管理人员来说，使用gitlab能方便的知道每个员工负责的内容的提交进度情况，方便对他们提交的代码进行质量的检查走读，还有更多统计类、开发进度管理等等功能，但是需要熟练掌握gitlab上的一些功能使用方法，比如使用issue来管理开发任务分配，使用milestone来制定和管理里程碑等等。

# 3. gitlab使用开发规范

参考：[gitlab使用开发规范]()

Gitlab是开放式一体化安全DevOps平台，集成了项目管理，CVCD，安全以及配置，软件研发全生命周期的DevOps 能力.太平洋电信是极狐(GitLab)铂金级别合作伙伴，致力于为跨境电商企业提供一个更符合国人使用习惯的软件研发全周期解决方案，提供优质的代码托管、DevOps一体化平台服务和安全、高速的网络体验。