GitLab的使用
～ 安装Git客户端
-
<u>https://git-scm.com/downloads</u>，下载Git客户端
～注册GitLab
～添加SSH key
点击右上角用户头像，选择Setting，选择SSH keys，
生成SSH keys， -
将key文本框填入SSH key，title里填入自定义标题，然后点击Add key
图片1.png
～建立工程
1.点击左上角菜单按钮，选择Projects，点击New project
2.Project path通常选择开发组名，Project Name填写工程名称，Visibility Level 通常选择Private，点击Create project进行保存
通过SourceTree管理GitLab
- SourceTree下载地址：
Windows: <u>http://downloads.atlassian.com/software/sourcetree/windows/SourceTreeSetup_1.6.21.exe</u>
Mac:
<u>http://downloads.atlassian.com/software/sourcetree/SourceTree_2.0.5.3.dmg</u> - 安装SourceTree到本地并运行
- 从url克隆仓库，源路径填写git@github.com::xxxx（组名）/xxxx（工程名）.git，目标路径填写本地储存路径，点击克隆
- 拉取代码，打开新克隆工程，点击工具栏中拉取按钮
～ MAC下生成和添加SSH keys
1、清楚以往的本地git账号
查看ssh-agent中的密钥： ssh-add -l
从ssh-agent中删除密钥： ssh-add -d ~/.ssh/id_rsa.pub
2、生成SSH keys方法：
打开终端，
ssh-keygen -t rsa -C "youname@.qq.com"， 按多次enter。
在Mac当前用户名下会有一个.ssh文件。
查看 .ssh
$ ls -a ~/.ssh 通过搜索目录
id_rsa //私钥
id_rsa.pub //公钥
打开 id_rsa.pub文件 里面就有需要的ssh 公钥。
复制公钥到GitLab添加SSH输入框。
ssh-keygen -t rsa -C "youname@.qq.com"
Enter passphrase (empty for no passphrase): 注：输入密码
Enter same passphrase again: 注：输入密码
Your identification has been saved in /Users/1sujia/.ssh/id_rsa.
Your public key has been saved in /Users/1sujia/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:0SiX7sis2WgYFstytkqel3Z5lNoqO9R+W4FM8KAGYDs GitLab
The key's randomart image is:
+---[RSA 4096]----+
|oo o |
|. o . + + |
| E o .o= . |
| + o+.. |
| . o. oS. |
|. B. + = . |
| *.+o O .. |
|o +*.X +. |
|.+ooO.=.. |
+----[SHA256]-----+
3.拷贝SSH key
-
粘贴到这里
点击右上角用户头像，选择Setting，选择SSH keys，
将key文本框填入SSH key，title里填入自定义标题，然后点击Add key
图片1.png
用户 / User
运维同学会为大家创建好GitLab用户并设置初始密码，请各位首次登录后修改密码，未来也请按下述要求设置自己的账号：
- 用户名 / Username：使用姓名全拼，全小写，中间没有空格
- 邮箱 / Email：使用公司邮箱
- 显示名 / Name：使用姓名全拼，姓、名首字母分别大写，中间一个空格
例：
组 / Group
在GitLab中组就是我们现实中的项目团队或职能团队，如：移动端组、前端组、后端组（尽管业务权责不同，但为促进后端开发同学形成统一标准和规范，后端不再做更细的拆分）、QA组、基础设施组、运维部，请按下述规范创建组：
- 名称及路径 / Group path：使用小写英文（不知道该起什么名字的来可以跟皓珉确认），单词之间用“-”连接
- 描述 / Description：中文描述，简单说明组的职能，各团队也可发挥想象力写个个性化的描述
- 头像 / Group avatar：可以上传本组头像
- 可见等级 / Visibility Level：请选择Internal，即GitLab内部用户可见；请不要选择Private或Public
例：
Group path: we-tech-inf
Description: W.E.Tech基础设施团队，为上层服务提供基础服务（如消息通知）及中间件
Visibility level: Internal
项目 / Project
通常来讲创建项目即我们的独立代码维护单元，当开发新的“独立”业务系统时，请相关组负责创建项目，创建时请遵循下述规范：
- 名称及路径 / Project path：使用小写英文（不知道该起什么名字的来可以跟皓珉确认），单词之间用“-”连接
- 描述 / Description
- 可见等级 / Visibility Level：请选择Private，即本组用户可见（出于安全考虑，我们践行最小权限原则，如果项目代码有必要向其他GitLab用户共享，请通过设置Project组间共享的功能实现，并设置好访问级别）
Project name: message-center
Project description: 实现消息推送、短信、邮件等用户触达功能，为服务层提供底层基础设施
Visibility level: Private
文档
每个包含代码的项目都应有相应的文档，可以分为下述两个位置：
- README.md：与代码一起维护，作用是
- 项目的简要说明
- 重要文档的Shortcut，一般指向Wiki中的文档，可参考welcome的README.md
- Wiki：项目相关的所有文档，包括但不限于
- 团队成员介绍
- 系统描述文档
几点注意：
- 文档命名，请使用小写英文，单词间用“-”连接
- GitLab中的Wiki也是使用git管理的，所以墙裂推荐通过git像管理代码一样管理Wiki中的项目文档
- 不同团队可能有不同的设计原则、代码规范、最佳实践等文档，这部分文档请放在we-tech/welcome项目的Wiki中，不要直接散布在各个项目中
- 请使用Markdown编辑提交GitLab中的文档，推荐：
Git 终端命令
//克隆git仓库
git clone git@gitlab.we.com:we-tech-iOS/investment.git
//
git remote 不带参数，列出已经存在的远程分支
git remote
origin
git remote -v 列出详细信息，在每一个名字后面列出其远程url
git remote -v
origin git@gitlab.we.com:we-tech-iOS/investment.git (fetch)
origin git@gitlab.we.com:we-tech-iOS/investment.git (push)
git remote add name url 在url创建名字为name的仓库
git remote add gitOrigin git@gitlab.we.com:we-tech-iOS/investment.git
git remote rm origin 删除名称为origin的远程仓库
// git branch
git branch 列出本地已经存在的分支
git branch -r 列出远程已经存在的分支
git branch -a 列出本地和远程已经存在的分支
git branch name 创建一个新的名为name的分支，并不切换分支
git branch -m oldbranch newbranch 重命名分支
git branch -d branch name 删除
//git checkout
git checkout name 切换分支
git checkout -b name 创建新分支并切换过去
//git pull
git pull
git pull origin ***
git push
git push -f origin feature/更改帮助中心url 强制将本地分支推送到远程分支
//vim
vim 文件名 用文本编辑器打开某个文件
//git status
git status 查看当前分支
git clean -fx
git log
