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

Commit 63b9c17c authored by 郭斐's avatar 郭斐

[Init] Let there be code

parents
# 外网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 进入子群组创建页面,子群组可以对父群组的成员进一步细分,子群组成员可以访问父群组项目,非子群组的父群组成员无法访问子群组项
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment