GitLab使用教程

一、基本操作

1、登录
从浏览器地址栏输入https://gitlab.com/回车，进入登录界面。如果没有gitlab账户，则需要进行注册，也可以直接使用github账户进行登录。
2、修改密码
登录成功后点击工具栏目Profile Settings ---- Password ----修改密码----Save password。
Tips：点击Gitlab的logo，可以从任何界面回到本页。

二、项目管理

可以根据需要选择新建项目，新建组合，新建用户
1、新建项目
如下图所示新建项目：

newproject

创建时可以在自己用户下创建或者某个群组内创建。
创建时选项：
a. 项目名称：可以为字母、数字、空格、下划线、中划线和英文点号组成，且必须以字母或数字开头，不能使用中文。
b. 项目描述（可选项）
c. 可见性（库类别）
私有库：只有被赋予权限的用户可见
内部库：登录用户可以下载
公开库：所有人可以下载
根据以上实际情况填写完各项之后，点击创建项目，项目创建成功。
提示通过SSH方式拉取推送项目代码必须要导入SSH key（见下方SSH key连接）
项目地址有HTTP和SSH两种方式，可发送给开发人员下载和初始化项目。

2、编辑或删除项目
a. 编辑：项目左边工具栏点Settings---->General选项---->Visibility，project features， permissions可以Rename以及编辑权限。
b. 删除：项目左边工具栏点Settings---->General选项---->Advanced---->拉到最下边Delete project。

三、组管理（管理员使用）

1、新建组：左上角groups--->New Group
a. 组名称：可以为字母、数字、空格、下划线、中划线和英文点号组成，且必须以字母或数字开头，不能使用中文。
2、编辑或删除组
项目左边工具栏点Settings进行编辑和删除组操作。
3、添加组成员
项目左边工具栏点Members进行组成员添加以及分配权限。
4、从组管理添加项目
项目左边工具栏点Settings---->Projects。

四、权限说明

1、Guest(匿名用户) - 创建项目、写留言薄
2、 Reporter（报告人）- 创建项目、写留言薄、拉项目、下载项目、创建代码片段
3、Developer（开发者）- 创建项目、写留言薄、拉项目、下载项目、创建代码片段、创建合并请求、创建新分支、推送不受保护的分支、移除不受保护的分支 、创建标签、编写wiki
4、Master（管理者）- 创建项目、写留言薄、拉项目、下载项目、创建代码片段、创建合并请求、创建新分支、推送不受保护的分支、移除不受保护的分支 、创建标签、编写wiki、增加团队成员、推送受保护的分支、移除受保护的分支、编辑项目、添加部署密钥、配置项目钩子
5、Owner（所有者）- 创建项目、写留言薄、拉项目、下载项目、创建代码片段、创建合并请求、创建新分支、推送不受保护的分支、移除不受保护的分支 、创建标签、编写wiki、增加团队成员、推送受保护的分支、移除受保护的分支、编辑项目、添加部署密钥、配置项目钩子、开关公有模式、将项目转移到另一个名称空间、删除项目

五、配置SSH密钥

1、下载Git安装包，去git官网下载git，https://git-scm.com/downloads，下载.exe格式并安装。
2、SSH 秘钥生成（我们要用到的是公钥）：
a. 首先，检查下自己之前有没有已经生成：在开始菜单中打开git下的git bash（当然，在其他目录下打开git bash也是一样的），执行：

cd ~/.ssh

b. 如果能进入到.ssh文件目录下 ，则证明，之前生成过.ssh秘钥，可以直接使用里面的秘钥。
如果不能进入到.ssh文件目录下，则：检测下自己之前有没有配置：git config user.name和git config user.email，若之前没有创建，则执行以下命令：
（1）配置：

git config --global user.name 'XXXX'
git config --global user.email 'XXX@XX.XXX'

（2）生成密钥：

ssh-keygen -t rsa -C "邮箱"

按三个回车，最后在.ssh目录下得到两个文件：id_rsa（私有密钥）和id_rsa.pub（公有密钥）
3、如果想登录远端，需要将rsa.pub里的密钥添加到远端。
首先，在.ssh目录下找到id_rsa.pub这个文件夹打开复制全部内容。
登录GitLab，进入你的Settings，会看到SSH Keys，创建New SSH Key，粘贴你的密钥到Key输入框中。点击Add SSH Key。
4、测试
在电脑要上传的文件右键，点Git Bash，进入命令行页面，输入

git clone git@gitlab.com:xxxx/xxx.git
touch README.md
git add README.md
git commit -m "add README"
git push -u origin master