1. GitLab 简介
1.1 GitLab基本概念
- GitLab 是一个用于仓库管理系统的开源项目。使用Git作为代码管理工具，并在此基础上搭建起来的web服务。
- 可通过Web界面进行访问公开的或者私人项目。它拥有与Github类似的功能，能够浏览源代码，管理缺陷和注释。
- 可以管理团队对仓库的访问，它非常易于浏览提交过的版本并提供一个文件历史库。
补充 Git、Gitlab与Github区别
- Git 是一种版本控制系统，是一个命令，是一种工具
- Github，Gitlab等产品都是第三方基于git这项技术开发的
- Github 是一个基于git实现的在线代码仓库，包含一个网站界面，向互联网开放
- Gitlab 是一个基于git实现的在线代码仓库软件，你可以用gitlab自己搭建一个类似于github一样的系统，一般用于在企业、学校等内部网络搭建git私服
1.2 GitLab的仓库与角色
- Gitlab中有四种角色：Owner、Master、Developer、Reporter。
- Gitlib中有两种仓库：普通仓库、Stag/Done库
区分方法：
命名为Publish/...._stag，即为stag库，命名为Publish/…._done，即为done库，其他则为普通库。
1.2.1 普通库与角色权限
普通库之前互不可见，一个仓库中各角色权限如下：
| 角色 | 人员 | 权限 |
|---|---|---|
| Owner | 管理员 | 1. 建立仓库； 2. 为仓库指定master； 3. 读写权限； |
| Master | Master | 1. 指定该仓库下的开发角色； 2. merge分支代码到主干，对主干代码有读写权限； 3. 维护仓库，如迁移库、重命名等； |
| Developer | 开发人员 | 1. check in 本地代码到分支； 2. 修改分支代码； 3. 对分支代码有读写权限，对主干分支有读权限； |
| Reporter | 测试人员 | 1. 对主干和分支代码有读权限。 |
1.2.2 stag/done库与角色权限
- stag/done库这两种库分别存放stag环境与生产环境的package。
- 除管理员外和管理员指定人员外有读写权限之外，其他角色不可见
2. Windows安装GitLab客户端
- 在Windows下安装Git客户端软件，下载链接
- 安装Git客户端:
(1)双击图标, 然后按默认选项安装即可。
(2)安装完成后，在开始菜单里找到“Git”->“Git Bash”，蹦出一个类似命令行窗口的
东西，就说明Git安装成功！
3. GitLab的使用
3.1 GitLab客户端的使用
本地仓库由git维护的三棵“树”组成。
- 第一个是工作目录，它持有实际文件；
- 第二个是缓存区(Index)，它像个缓存区域，临时保存你的改动；
- 第三个是HEAD，指向最近一次提交后的结果。
常用命令总结
- 从工作目录到缓存区(index)：git add <filename> 或git add .
- 提交改动(从index到HEAD)：git commit –m "代码提交信息"
- 从本地仓库到远端仓库：git push origin master，可以把master换成想要推送的任何分支
分支
(1) 创建分支并切换到该分支
git checkout -b <branch>
等同于：
git branch <branch>
git checkout <branch>
(2) 切回主分支：git checkout master
(3) 删掉分支：git branch -d <branch>
(4) 除非你将分支推送到git服务器，不然该分支其他人look不到
git push origin <branch>
更新与合并
(1) 从git服务器上更新本地仓库：git pull
等同于：git fetch;git merge
(2) 要合并其他分支到你的当前分支：git merge <branch>以上两种情况，git都会尝试去自动合并改动。
若存在冲突(conflicts)，则自动合并失败，此时只能靠人肉合并冲突。git diff <source_branch> <target_branch> 查看冲突并分析解决
git add <filename>
标签(tag)
标签可以针对某一时间点的版本做标记，常用于版本发布。
(1) 添加标签：git tag –a ${tagname} -m “版本发布信息”
(2) 切换到标签：git checkout ${tagname}
(3) 提交到git服务器：git push origin ${tagname}
替换本地改动
假如你想要丢弃你所有的本地改动与提交，可以到服务器上获取最新的版本并将你本地主分支指向到它：
git fetch origin
git reset --hard origin/master
3.2 关联远程仓库
本地Git仓库和GitLab仓库之间的传输是通过SSH加密的
3.2.1 GitLab客户端的准备
3.2.1.1 设置用户信息
单个代码库的用户信息：
查看
git config --get user.name
git config --get user.email
设置
git config user.name
git config user.email
全局的用户信息：
查看
git config --global --get user.name
git config --global --get user.email
设置
git config --global user.name
git config --global user.email
注意事项
- windows中的换行符为 CRLF， 而在Linux下的换行符为LF
- 可使用
git config --list查看所有配置信息，若存在core.autocrlf=true，则使用git config --global core.autocrlf false禁止自动换行
3.2.1.2 创建SSH Key
创建SSH Key。在用户主目录下，看看有没有.ssh目录，如果有，再看看这个目录下有没有id_rsa和id_rsa.pub这两个文件，如果已经有了，可直接跳到下一步。如果没有，打开Shell（Windows下打开Git Bash），创建SSH Key
ssh-keygen -t rsa -C "youremail@example.com"
- 测试SSH Key是否成功：ssh -T git@server_name
- 如果一切顺利的话，可以在用户主目录里找到.ssh目录，里面有id_rsa和id_rsa.pub两个文件
- id_rsa是私钥，不能泄露出去；id_rsa.pub是公钥，用$cat id_rsa.pub查看key
3.2.2 GitLab服务器的准备
4. 建立仓库，踏上开发
全局设置
git config --global user.name "qianqian.wu吴倩倩"
git config --global user.email "wu.qianqian@chinaredstar.com"
4.1 建Git仓库
(1) 先在本地建仓库，再推送至远端服务器
cd workspace
git init
git remote add origin git@server_name:group/component.git
git add .
git commit
git push -u origin master
(2) 本地已存在git仓库
cd existing_repo
git remote add origin git@server_name:group/component.git
git push -u origin --all
git push -u origin --tags
(3) 从远端服务器克隆仓库到本地
git clone git@server_name:group/component.git
cd component
touch README.md
git add README.md
git commit -m "add README"
git push -u origin master
注意事项
- 如果git库里有多个分支的话，下载的时候需要加上--bare，完整格式为
- git clone –bare git@server_name:group/component.git
下载完成后可以进入目录，使用git branch查看有多少分支，使用git tag查看有多少tags。
(4) 多次从远端更新本地仓库
cd workspace #workspace是工作目录
[ -d ".git" ] || git clone ${git_repository} .
git remote update origin --prune #更新原来已有的
git fetch #拉取远程仓库的
git branch -a #展现分支以及分支的详细内容（remotes/origin/下的所有内容）
git checkout -f ${TAG}
