[Init] Let there be code

INTRODUCTION.md

+# 外网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