partner-gitlab已接入小米账号,使用详情见用户手册

INTRODUCTION.md 6.13 KB
Newer Older
郭斐's avatar
郭斐 committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174
# 外网Gitlab用户使用手册

参考文档:

- [Gitlab User Doc](https://docs.gitlab.com/ee/user/)
- [Gitlab 使用视频](https://www.bilibili.com/video/BV11E411x7Uv?from=search&seid=18273595278229050218)
- [米盾安全代理](https://dun.mi.com/help/proxy/)  
<br>


## 背景

为方便**合作伙伴**及有 **开源合作意向** 项目专有搭建外网可访问的 Gitlab \[ https://partner-gitlab.mioffice.cn \],域名https/ssh 已过[米盾](https://dun.mi.com/help/proxy/secproxy-core.html)安全[代理](https://dun.mi.com/proxy/sites/5fab45fc20a14370e09a54ea/config),现阶段暂仅限 Miot/手机部/互联网业务部 和外部合作使用  
<br>

## 版本

gitlab ce - 13.2.0 (xiaomi)  
<br>

## 联系方式

邮件:gitlab-contributors@xiaomi.com  
<br>

## 专有名词

**小米账号**:  
小米帐号是小米公司基于官网注册用户的统一称呼,点击https://account.xiaomi.com/fe/service/account 查看自己的小米账户  
<br>

**员工账号**
已经接入CAS或仅**公司内部**人员使用的,公司内部账号类型可见[合作伙伴用户管理系统使用说明](https://xiaomi.f.mioffice.cn/docs/dock49V21fKjNYrjg0wZA98zZhU)

**外部人员需要使用员工账号要进行申请**[申请(p-开头的)账号](https://www.mioffice.cn/family/IT/home)
 
<font color=red>**小米账号不是员工账号,不能混为一谈**</font>

***
## 使用说明

### 账号登录
<br>


#### 1.小米账号

现已初步支持小米账号接入,现阶段只能从账号系统获取 名称,认证登陆后**强烈建议修改个人信息,以便获取通知/联系开发者等**

直接登录 https://partner-gitlab.mioffice.cn/users/sign_in

![](images/login01.png)

跳转后进行授权

![](images/login02.png)

登陆后点击 右上角->Edit profile 修改个人信息(**强烈建议**

![](images/profile01.png)

主要建议修改

- Email:**用于接收 gitlab通知**
- Organization:方便定位开发者组织

其余项可按照需求进行修改,尽量填写完整,方便进行开发者定位

修改完成后将对 email填写邮箱发送**确认邮件**,收到后点击确认则更新个人信息完成

如需增加多个邮箱,可点击左侧导航栏->Email进行添加

![](images/email01.png)

因小米账号为外部账号,<font color=red size=3>**考虑资源、安全等问题,无法创建项目/组**</font>,有需求可联系gitlab-contributors@xiaomi.com 进行权限开放

备注:

- 如需取消授权,可登录https://account.xiaomi.com/ -> 绑定授权 中解除授权

<br>

#### 2.员工账号

Gitlab集成公司**cas3**认证方式,所以合作用户需 [申请](https://www.mioffice.cn/family/IT/home)[(p-开头的)](https://www.mioffice.cn/family/IT/home)[账号](https://www.mioffice.cn/family/IT/home),gitlab拉取用户信息并进行注册登录

![](images/midun01.png)

![](images/login03.png)

备注

- 如有需要(修改邮箱/名称等)可以登陆后点击 右上角->Edit profile 修改个人信息

![](images/profile02.png)

关联小米账号:

内网账号可关联小米账号,具体操作步骤为:

![](images/account01.png)

![](images/account02.png)

![](images/account03.png)

进行授权验证等进行关联,关联后**小米账号登录即为内网账号**

***
### 使用概要
<br>

按照[Gitlab User Doc](https://docs.gitlab.com/ee/user/)[Gitlab 使用视频](https://www.bilibili.com/video/BV11E411x7Uv?from=search&seid=18273595278229050218),ce版部分功能受限,文档中已进行标注

**使用中文右上角点击用户->Settings->Preference->Language**  
<br>

#### 1.SSH Key导入

用户添加 [ssh key](https://partner-gitlab.mioffice.cn/help/ssh/README#generating-a-new-ssh-key-pair)

ssh-keygen -t rsa -C “xxx@xiaomi.com”

#之后会看到提示输入保存ssh key的文件名和加密串,建议直接回车跳过

#完成上述操作之后,cat /home/.ssh/id\_rsa.pub,点击GitLab导航栏的用户头像下拉选择 设置,在左侧菜单栏选择 SSH密钥 进入 SSH 密钥添加页面,使用文本编辑器打开 id\_rsa.pub 文件并全选复制粘贴至密钥添加页面的相应位置,填写密钥标题,点击 增加密钥 按钮即可完成ssh key的上传

ssh -T git@partner-gitlab.mioffice.cn,访问正常返回:

Welcome to GitLab, @xxx!  
<br>

#### 2.项目


#### 2.1 如何新建一个项目

点击GitLab导航条上的 + 下拉选择 新建项目 进入项目创建页面,GitLab提供了以下三种方式创建项目。

2.1.1 新建一个空白项目

填写项目路径、名称、描述,选择项目可见等级之后,点击 创建项目 按钮即可创建一个空白项目。新项目一般采用此方式进行创建。

2.1.2 从模板创建

GitLab提供了多种语言项目模板:Ruby on Rails、Spring、NodeJS Express,可按需使用。  
<br>

#### 2.2 如何管理项目成员

#添加/导入项目成员

进入项目页面,在左侧菜单栏选择 Members,在GitLab member or Email address 里依次选择要邀请的成员(可多选)、[角色权限](https://docs.gitlab.com/ee/user/permissions.html)和访问到期日期,点击 Invite 完成项目成员的添加。

除了手动添加之外,还可以点击 import 按钮进入导入其它项目成员。

#项目成员管理

项目Members 页面还提供了成员管理的功能,可以修改成员的角色权限和访问到期日期,还可以踢出成员  
<br>

#### 2.3 如何新建一个群组项目

2.3.1 创建一个群组

在导航栏里点击 \+ 下拉选择 New Group 进入新建群组页面,填写群组路径、群组名称、描述,选择群组可见等级之后,点击 创建群组 按钮即可创建一个新的群组。

2.3.2 新建群组项目

在群组主页点击 New project 按钮进入新建群组项目页面,填写必要信息之后并提交即可创建一个群组项目,群组项目默认的可见等级为私有,即只允许群组成员访问。

2.3.3 子群组

在群组主页下拉选择并点击 New subgroup 进入子群组创建页面,子群组可以对父群组的成员进一步细分,子群组成员可以访问父群组项目,非子群组的父群组成员无法访问子群组项