研发一体化平台-智能研发模块，是整个研发一体化平台的核心组成部分之一。该模块主要的作用有：
版本控制
智能研发可以帮助开发者追踪和管理代码的变化，记录每次提交的代码变动，并且可以轻松地切换到任意时间点的代码状态。
多人协作开发
- 开发者可以通过智能研发轻松地分享和获取开源代码，加速软件开发的进程，同时也可以借鉴和学习其他开发者的经验。
- 智能研发可以帮助开发者追踪和管理代码的变化，记录每次提交的代码变动，并且可以轻松地切换到任意时间点的代码状态。
代码备份和恢复
智能研发可以让多个开发者同时对同一个代码库进行修改，并且能够自动处理冲突。开发者可以方便地合并和管理各种代码分支，提高团队的协作效率。
代码审查和质量控制
智能研发可以记录每次代码提交的详细信息，包括代码的作者、提交时间等，为代码审查和质量控制提供便利。开发者可以通过查看代码的变动历史，及时发现和修复潜在的问题。
灵活的工作流程
智能研发支持多种工作流程，如集中式工作流、分支工作流、Fork工作流等。开发者可以根据项目的需求选择合适的工作流程，灵活地进行代码管理和版本控制。
该文档旨在帮助用户了解智能研发 端到端工作流程。通过配置权限、组织、创建和保护您的应用程序，并分析其性能。在整个过程中报告团队效能。
¶ 群组管理
群组的作用：
- 可以使用群组同时管理一个或多个相关项目。
- 可以使用群组来管理项目的权限。如果某人有权访问该群组，则他们可以访问该群组中的所有项目。
- 可以查看群组中项目的所有议题和合并请求，并查看显示群组活动的分析。
- 可以使用群组同时与群组的所有成员进行通信。
与项目一样，群组可以配置为将其可见性限制为：
- 匿名用户。
- 所有经过身份验证的用户。
- 只有明确的群组成员。
应用程序设置级别上对可见性级别的限制也适用于群组。如果设置为内部，则匿名用户的浏览页面为空。群组页面有一个可见性级别图标。管理员用户不能创建比直接父组可见性级别更高的子组或项目。
¶ 查看群组
要查看群组，请在左侧边栏中选择 群组。
群组页面显示按上次更新日期排序的群组列表。
- 要浏览所有公开群组，请选择 浏览群组。
- 要查看您拥有直接或间接成员资格的群组，请选择您的群组，此选项卡也显示以下您所属的群组：
- 通过子组获取的父组的成员资格。
- 通过群组或子组中项目的直接或继承成员资格。
¶ 创建群组
要创建一个群组：
- 在左侧边栏中，选择 搜索或转到 > 查看我的所有群组，然后在右侧选择 新建群组。
- 选择 创建群组。
- 在 群组名称 中输入群组的名称。
- 在 群组 URL 中输入群组的路径，用于命名空间
- 选择可见性级别。
- 通过回答以下问题来个性化您的体验：
- 您的角色是什么？
- 谁将使用这个群组？
- 您会用这个群组做什么？
¶ 删除群组
要删除群组及其内容：
- 在左侧边栏中，选择 搜索或转到 并找到您的群组。
- 在左侧边栏中，选择 设置 > 通用。
- 展开 高级 部分。
- 在 删除群组 部分，选择 删除群组。
- 输入群组名。
- 选择 确认。
群组也可以从群组仪表盘中删除：
- 在左侧边栏中，选择 搜索或转到 > 查看我的所有群组。
- 选择 您的群组。
- 选择要删除的群组对应的 ()。
- 选择 删除。
- 在删除群组部分，选择 删除群组。
- 输入群组名。
- 选择 确认。
此操作将删除该群组。它还添加了一个后台作业来删除组中的所有项目，这意味着群组中的所有项目将会被一并删除。
¶ 请求访问群组
作为用户，如果管理员允许，您可以请求成为群组的成员。
- 在左侧边栏中，选择 搜索或转到 > 查看我的所有群组。
- 选择 您的群组。
- 找到群组并选择它。
- 在群组名下，选择 请求访问。
多达 10 个最近活跃的群组所有者会收到一封包含您的请求的电子邮件。任何群组所有者都可以批准或拒绝请求。
如果您在请求获得批准之前改变主意，请选择 撤销访问请求。
¶ 过滤群组
过滤群组以查找成员。默认情况下，显示群组和子组中的所有成员。
- 在左侧边栏中，选择 搜索或转到 并找到您的群组。
- 在成员列表上方，在筛选成员框中，输入筛选条件。
- 要仅查看群组中的成员，请选择 成员 = 直接。
- 要查看群组及其子组的成员，请选择 成员 = 继承。
¶ 搜索群组
您可以按姓名、用户名或电子邮件搜索成员。
- 在左侧边栏中，选择 搜索或转到 并找到您的群组。
- 在左侧边栏中，选择 管理 > 成员。
- 在成员列表上方，在 筛选成员 框中，输入搜索条件。
- 在 筛选成员 框的右侧，选择放大镜 ()。
¶ 群组成员管理
¶ 添加成员
先决条件：
- 您必须具有所有者角色。
您可以授予用户访问群组中所有项目的权限。
- 在左侧边栏中，选择 搜索或转到 > 查看我的所有群组。
- 选择 您的群组。
- 从左侧边栏中，选择 管理 > 成员。
- 选择 邀请成员。
- 填写字段。
- 该角色适用于群组中的所有项目。
- 在访问过期时间，用户无法再访问组中的项目。
- 选择 邀请。
未自动添加的成员显示在 已邀请 选项卡上。 在此选项卡上的用户：
- 尚未接受邀请。
- 正在等待管理员批准。
- 超过群组用户上限。
¶ 删除成员
先决条件：
- 您必须具有所有者角色。
- 该成员必须是该群组的直接成员。如果成员资格是从父组继承的，则只能从父组中删除该成员。
要从群组中删除成员：
- 进入群组。
- 从左侧菜单中，选择 管理 > 成员。
- 在您要删除的成员旁边，选择 删除。
- 可选。在删除成员确认框中：
- 要从子组和项目中删除直接用户成员资格，请选中 同时从子组和项目中删除直接用户成员资格 复选框。
- 要从关联的议题和合并请求中取消指派用户，请选中 同时从相关的议题和合并请求中取消指派此用户 复选框。
- 选择 移除成员。
¶ 项目管理
¶ 创建项目
¶ 直接在智能研发平台创建
要创建项目：
- 在左侧边栏中，选择 搜索或转到 > 查看我的所有项目。
- 在页面右侧，选择 新建项目。
- 选择 创建空白项目。
- 输入项目详情：
- 在 项目名称 字段中，输入您的项目名称。名称必须以小写或大写字母（
a-z, A-Z）、数字（0-9）、表情符号或下划线（_）开头。 它还可以包含点（.）、加号（+）、破折号（-）或空格。 - 在 项目标识串 字段中，输入项目的路径。极狐GitLab 实例使用标识串作为项目的 URL 路径。要更改标识串，首先输入项目名称，然后更改标识串。
- 在 项目部署目标（可选） 字段中，选择项目的部署目标。此信息有助于极狐GitLab 更好地了解其用户及其部署要求。
- 要为用户修改项目的查看和访问权限，请更改 可见性级别。
- 要创建 README 文件以便初始化 Git 仓库、具有默认分支并可以克隆，请选择 使用自述文件初始化仓库。
- 要分析项目中的源代码是否存在已知安全漏洞，请选择 启用静态应用程序安全测试 (SAST)。
- 在 项目名称 字段中，输入您的项目名称。名称必须以小写或大写字母（
- 选择 创建项目。
¶ 通过 Git 推送创建新项目
使用 git push 将本地项目仓库推送到智能研发平台代码仓库。
先决条件：
- 要使用 SSH 推送，您必须有一个 SSH 密钥，添加到您的极狐GitLab 账户。
- 您必须具有向命名空间添加新项目的权限。要检查您是否有权限：
- 在左侧边栏中，选择 搜索或转到，并找到您的群组。
- 确认右上角有 新建项目。如果您需要权限，请联系您的管理员。
要推送您的代码仓库并创建一个项目：
-
使用 SSH 或 HTTPS 推送：
-
使用 SSH 推送：
git push --set-upstream git@githkdkf.ssdevops.com:group/myproject.git master -
使用 HTTPS 推送：
git push --set-upstream https://githkdkf.ssdevops.com/group/myproject.git mastergithkdkf.ssdevops.com： 为智能研发平台代码仓库域名group：群组名称myproject，项目名称。 -
可选。要导出现有的代码仓库标签，请将
--tags标志附加到您的git push命令。
-
-
配置远端：
git remote add origin https://githkdkf.ssdevops.comm/group/myproject.git
推送完成后，系统会显示以下消息：
remote: The private project group/myproject was created.
¶ 删除项目
删除项目后，个人命名空间中的项目会立即删除。要延迟删除群组中的项目，您可以启用延迟项目删除。
要删除项目：
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 选择 设置 > 通用。
- 展开 高级 部分。
- 向下滚动到 删除项目 部分。
- 选择 删除项目。
- 通过填写字段确认此操作。
¶ 项目设置
¶ 查看项目设置
您必须至少具有维护者角色才能查看项目设置。
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 在左侧边栏中，选择 设置 > 通用。
- 要显示一个部分中的所有设置，请选择 展开。
- 可选。使用搜索框查找设置。
¶ 编辑项目名称和描述
使用项目通用设置来编辑您的项目详细信息。
- 至少以维护者角色登录极狐GitLab。
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 在左侧边栏中，选择 设置 > 通用。
- 在 项目名称 文本框中，输入您的项目名称。
- 在 项目描述 文本框中，输入您的项目描述。
- 在 项目头像 下，要更改您的项目头像，请选择 选择文件
¶ 配置项目可见性、功能和权限
要为项目配置可见性、功能和权限：
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 在左侧边栏中，选择 设置 > 通用。
- 展开 可见性、项目功能、权限 部分。
- 要更改项目可见性，请选择下拉列表。如果您选择 公开，则会将某些功能的访问权限限制为 仅项目成员。
- 要允许用户请求访问项目，请选中 用户可以请求访问 复选框。
- 使用切换开关，启用或禁用项目中的功能。
- 选择 保存更改。
¶ 项目功能设置
使用切换开关来启用或禁用项目中的功能。
| 选项 | 更多访问限制选项 | 描述 |
|---|---|---|
| 议题 | ✓ | 激活极狐GitLab 议题跟踪器 |
| 仓库 | ✓ | 启用仓库功能 |
| 合并请求 | ✓ | 启用合并请求功能 |
| 派生 | ✓ | 启用派生功能 |
| Git 大文件存储 (LFS) | 允许使用大文件 | |
| 软件包 | 支持软件包库功能 | |
| CI/CD | ✓ | 启用 CI/CD 功能 |
| Container Registry | 为您的 Docker 镜像激活仓库 | |
| 分析 | ✓ | 启用分析 |
| 需求 | ✓ | 控制对需求管理的访问 |
| 安全与合规 | ✓ | 控制对安全功能的访问 |
| Wiki | ✓ | 启用单独的文档系统 |
| 代码片段 | ✓ | 允许分享代码和文本 |
| Pages | ✓ | 允许您发布静态网站 |
| 指标仪表盘 | ✓ | 控制对指标仪表盘的访问 |
当您禁用某个功能时，以下附加功能也会被禁用：
- 如果禁用议题功能，项目用户将无法使用：
- 议题看板
- 服务台
- 项目用户仍然可以通过合并请求访问里程碑。
- 如果禁用议题和合并请求，项目用户将无法使用：
- 标记
- 里程碑
- 如果您禁用仓库，项目用户将无法使用：
- 合并请求
- CI/CD
- 容器镜像库
- Git 大文件存储
- 软件包
- 指标仪表盘访问需要读取项目环境和部署。有权访问指标仪表盘的用户还可以访问环境和部署。
¶ 分支管理
分支是项目工作树的版本。当您创建一个新的项目时，极狐GitLab 会为您的代码仓库创建一个默认分支（无法删除）。您可以在项目、子组、群组或实例级别配置默认分支设置。
随着项目的发展，您的团队会创建更多分支，您最好遵循分支命名模式。 每个分支代表一组更改，允许并行完成开发工作。一个分支的开发工作不会影响另一个分支。
¶ 创建分支
先决条件：
- 您必须至少拥有项目的开发者角色。
在 UI 中创建一个新分支：
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 在左侧边栏中，选择 代码 > 分支。
- 在右上角，选择 新建分支。
- 输入一个 分支名称。
- 在 创建自 中，选择分支的基础：现有分支、现有标签或提交 SHA。
- 选择 创建分支。
¶ 查看所有分支
在极狐GitLab 用户界面中查看和管理您的分支：
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 在左侧边栏中，选择 代码 > 分支。
在此页面上，您可以：
- 查看所有分支、活动分支或陈旧分支。
- 创建新分支。
- 比较分支。
- 删除合并的分支。
¶ 分支管理规范
- master主分支
用于生产发布的长线分支，应设置为保护分支，不允许直接向主分支提交代码，所有代码需经过测试验证、业务验收后才能合入主分支，保证功能完整，随时都可以进行生产发布
- test测试分支
用于测试环境验证的长线分支，应设置为保护分支，不允许直接向测试分支提交代码，所有代码需经过质量扫描、Code Review后才能合入测试分支
- feature特性分支
用于迭代需求开发的临时分支，参与迭代的所有开发人员都在特性分支上进行代码集成，测试阶段发现的问题也在特性分支上进行修复，迭代需求上线后特性分支即可删除。基于主分支拉取特性分支，参与当前迭代的开发人员都在该特性分支上做代码集成、联调自测，开发完成后提交合并请求至测试分支，PL或高级工程师进行代码审核，审核通过后合并代码到测试分支，测试完成后合并测试分支到主分支，发布上线。
- hotfix修复分支
用于线上问题修复的临时分支，测试人员直接在修复分支进行验证，合入主分支后即可删除。基于主分支拉取修复分支，问题修复完成后，测试人员直接在修复分支进行测试，测试通过后提交合并请求至主分支，PL或高级工程师进行代码审核，审核通过后合并代码到主分支，发布上线，开发人员及时将主分支的已上线代码并入当前开发分支。
- 开发本地分支
用于映射远程代码仓库分支，进行提交和推送
¶ 代码入库流程
开发人员（Developer）
参与需求评审、负责具体功能实现、测试问题修复、合并请求提交
审核人员（PL / Maintainer）
参与需求评审、负责任务分配、开发排期、CodeReview、代码管理、保护分支代码合并、升级单提交
测试人员
参与需求评审、负责测试（包含hotfix回归）、问题记录、预生产发布、版本标记、升级单审批、流程产物归档
验收人员
负责需求梳理、发起需求评审、进行功能验收
运维发布人员
负责生产环境发布
持续集成平台
触发持续集成流水线、运行预定义的流水线作业
¶ 开发阶段
开发人员拉取特性分支进行功能开发，已编写的代码向代码库推送之前，先通过本地质量扫描插件进行扫描，将扫描出的问题修复后再推送到代码仓库，代码推送事件触发持续集成流水线，流水线中可以进行构建、单元测试、覆盖率统计、静态质量分析等作业，流水线结果通过邮件或钉钉通知开发人员，如果流水线失败，开发人员要及时修复问题，再次推送。
当前迭代所有功能都开发自测完成，开发人员提交合并请求至测试分支，同时指定有权限的代码审核人员，合并请求事件触发持续集成流水线，流水线失败则开发人员要及时修复问题，再次推送后会再次触发流水线，流水线成功后，代码审核人员进行CodeReview，如果代码存在问题，代码审核人员可以直接在问题代码上做评论，或者通过其他方式通知开发人员，开发人员及时修复问题，代码审核通过后，将特性分支代码并入测试分支，提交测试。
¶ 测试验收阶段
测试发现功能问题，记录禅道或其他问题跟踪平台，开发人员在原特性分支上进行问题修复，经过与开发阶段相同的代码审核流程，将代码并入测试分支，通知测试人员验证。测试完成，所有问题修复完成后，发布预生产环境，通知业务验收，验收出现问题则需要开发继续修复问题，验收通过后可以继续上线流程。
¶ 发布阶段
开发人员申请合并测试分支至主分支，代码审核人员执行代码合并，提交升级单，测试人员补充升级单，完成升级单审批流程，对代码打版本标记，交付运维人员发布上线，开发人员及时将已上线代码并入当前开发分支。
¶ 附录
¶ 安装和配置Git
-
点击Git - Downloading Package (git-scm.com)进入git下载页，选择相应版本进行下载：
-
下载完成之后，双击可执行文件进行安装即可。安装完成之后，打开git bash命令行：
-
设置git用户名
git config –global user.name='your username' -
设置git用户邮箱
git config –global user.email='your email'
¶ 添加ssh秘钥
¶ 什么是 SSH 密钥
SSH 使用两个密钥，公钥和私钥。
- 公钥可以被分发。
- 私钥应该被保护。
上传您的公钥是不可能泄露机密数据的。当您需要复制或上传您的 SSH 公钥时，请确保您不会意外地复制或上传您的私钥。
¶ 确认SSH 密钥对
在创建密钥对之前，请查看密钥对是否已存在。
- 在 Windows、Linux 或 macOS 上，转到您的主目录。
- 进入
.ssh/子目录。如果.ssh/子目录不存在，或者.ssh/下没有id_rsa.pub和id_rsa文件，您可能之前没有使用过ssh。这种情况下，您需要生成 SSH 密钥对。
¶ 生成 SSH 密钥对
如果您没有现有的 SSH 密钥对，请生成一个新的。
-
打开一个终端。
-
输入
ssh-keygen -t，然后输入密钥类型和可选注释。此注释包含在创建的.pub文件中。您可能希望在注释中使用电子邮件地址。ssh-keygen -t rsa -b 2048 -C "your Email or your account in Gitlab" -
按照提示，按Enter键，直至完成。
¶ 添加到智能研发平台
-
复制公钥文件的内容。您可以手动执行此操作或在Git Bash中使用如下脚本
clip < ~/.ssh/id_rsa.pub -
登录研发一体化平台，跳转到智能研发模块
-
在左侧边栏的右上角，选择您的头像
-
选择 编辑个人资料
-
在左侧边栏中，选择SSH 密钥
-
在 密钥 框中，粘贴公钥的内容。
-
在 标题 框中，输入说明，例如 “Work Laptop” 或 “Home Workstation”。
-
选择 添加密钥。
¶ 验证是否成功
-
打开终端并运行此命令，将
githkdkf.ssdevops.com替换为您的实例 URL：ssh -T git@githkdkf.ssdevops.com -
如果这是您第一次连接，您应该验证 研发一体化服务器的真实性。如果您看到如下消息：
The authenticity of host 'githkdkf.ssdevops.com (35.231.145.151)' can't be established. ECDSA key fingerprint is SHA256:HbW3g8zUjNSksFbqTiUWPWg2Bq1x8xdGUrliXFzSnUw. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added 'githkdkf.ssdevops.com' (ECDSA) to the list of known hosts.输入
yes，然后按 Enter。