- 最新动态
- 功能总览
- 服务公告
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
-
API参考
- 使用前必读
- API概览
- 如何调用API
-
API
- SSH Key
-
Repository
- 获取分支目录下的文件
- 获取仓库统计数据
- 获取一个仓库下特定分支的图片文件
- 修改被流水线引用的仓库状态
- 判断用户是否有仓库的管理员权限
- 设置仓库是公开状态还是私有状态
- 获取一个仓库下特定分支指定文件内容
- 获取公开示例模板列表
- 创建仓库
- 根据仓库名组名获取仓库短id,用以拼接与commitid对应提交详情页面url
- 根据组名和仓库名查询某仓库某分支对应的提交
- 查询某仓库对应的分支
- 根据仓库id查询仓库某分支对应的提交,提供更多可选参数
- 添加部署密钥
- 删除仓库部署密钥
- 获取仓库上一次的提交统计信息
- 仓库统计
- 删除仓库
- 查看仓库的创建状态
- 查询某仓库的标签列表
- 新建标签
- 查询某个仓库的详细信息
- 获取代码提交行数
- 下载仓库
- 新建保护分支
- 删除保护分支
- 批量删除保护分支
- 新建保护tag
- 删除保护tag
- 获取仓库分支列表
- 获取仓库合并请求列表
- 获取仓库合并请求详情
- 获取仓库ip白名单
- 添加仓库ip白名单
- 修改仓库ip白名单
- 删除仓库ip白名单
- 获取合并请求的变化
- 关联仓库与成员组
- 根据仓库短ID锁定仓库
- 根据仓库短ID解锁仓库
- 审核合并请求
- 获取关联工作项信息
- 根据仓库短ID和合并请求短ID获取检视人信息
- 获取变更文件列表
- Tenant
- Group
- V2Project
- RepoMember
- Commit
- File
- User
- Webhook
- Project
- v2仓库管理
- Discussion
- 应用示例
- 附录
- 历史API
-
常见问题
- 认证鉴权问题
- 成员权限问题
-
代码上传下载问题
- 从本地推送代码仓到CodeArts Repo时,报错"Error: Deny by project hooks setting 'default': message of commit"
- 用户推送二进制文件到CodeArts Repo失败
- 执行git push 命令时,报错'origin' does not appear to be a git repository...
- 在CentOS系统下使用HTTPS协议克隆代码时,报错"The requested URL returned error: 401"
- 使用git pull拉取CodeArts Repo的代码失败,报错"Merge branch 'master' of https://test.com Please Enter a commit"
- fatal: refusing to merge unrelated histories
- 如何阻止涉密文件被推送到CodeArts Repo代码仓库
- 仓库迁移问题
- 合并请求问题
- Fork同步问题
- 仓库容量问题
- 常见问题汇总
- 视频帮助
- 计费说明
- 文档下载
- 通用参考
链接复制成功!
设置子模块
配置代码仓库的子模块概述
子模块(submodule)是Git为管理仓库共用而衍生出的一个工具,用户可以通过子模块将公共仓库作为子目录包含到用户的仓库中,并能够双向同步该公共仓库的代码,借助子模块用户能将公共仓库隔离、复用,能随时拉取最新代码以及对它提交修复,能大大提高用户的团队效率。
当仓库“Test_Fir”需要包含并使用仓库“Test_Sec”(第三方库,或者用户独立开发的,用于多个父项目的库),如果想要把它们当做两个独立的项目,同时又想在“Test_Fir”中使用“Test_Sec”,可以使用Git的子模块功能。 子模块允许用户将一个Git仓库作为另一个Git仓库的子目录。 它能让用户将另一个仓库克隆到自己的仓库中,同时还保持提交的独立。
子模块将被记录在一个名叫“.gitmodules”的文件中,其中会记录子模块的信息:
[submodule "module_name"] #子模块名称 path = file_path #子模块在本仓库(父仓)中文件的存储路径。 url = repo_url #子模块(子仓库)的远程仓地址
其中,位于“file_path”目录下的源代码,将会来自“repo_url”。
约束限制
如果“Test_Fir”仓库的内容将作为“Test_Sec”仓库的子模块,操作的用户需要有“Test_Sec”仓库的“设置”权限和代码的“提交”权限,请参考配置代码仓库级的权限提前进行配置。
在Repo页面添加子模块
用户可以根据需要,选择以下任意方式添加子模块。
在Git客户端添加子模块
- 添加Submodule。
git submodule add <repo> [<dir>] [-b <branch>] [<path>]
示例:
git submodule add git@***.***.com:****/WEB-INF.git
- 拉取包含submodule的仓库。
git clone <repo> [<dir>] --recursive
示例:
git clone git@***.***.com:****/WEB-INF.git --recursive
- 获取远端Submodule更新。
git submodule update --remote
- 推送更新到子库。
git push --recurse-submodules=check
- 删除Submodule。
- 删除“.gitsubmodule”中对应submodule的条目。
- 删除“.git/config”中对应submodule的条目。
- 执行命令,删除子模块对应的文件夹。
git rm --cached {submodule_path} #注意更换为用户的子模块路径
说明:
注意:路径不要加后面的“/”。
示例:用户的submodule保存在“src/main/webapp/WEB-INF/”目录,则执行命令为:
git rm --cached src/main/webapp/WEB-INF
编辑子模块
用户有代码仓的“设置”权限,才能编辑子模块,请参考配置代码仓库级的权限提前进行配置。
如下图所示,“子模块仓库路径”表示子仓库Git地址,单击“子模块仓库提交”,可查看子仓库的历史提交。单击“部署密钥同步”所在列的,可以把父仓库的部署密钥同步到子仓库,同步后,子仓库将继承父仓库的部署密钥。子模块校验结果列为存在,表示子仓库正常存在并可用。如果用户要删除此子模块,请单击“操作”列所在的
。