Adobe 存储库的 Git 子模块支持 git-submodule-support

Git 子模块可用于在构建时跨 Git 存储库合并多个分支的内容。

Cloud Manager 的构建流程执行期间，在克隆为管道配置的存储库并签出配置的分支后，如果该分支在根目录中包含 .gitmodules 文件，则执行此命令。

以下命令将把每个子模块签出到适当的目录中。

$ git submodule update --init

这项技术是文档使用多源 Git 存储库中所述解决方案的潜在替代方案，适用于习惯使用 Git 子模块且不想管理外部合并过程。

例如，假设有三个存储库，每个存储库均包含一个名为 main 的分支。 在“主”存储库（即，在管道中配置的存储库）中，main 分支包含一个 pom.xml 文件，声明其他两个存储库所包含的项目。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>customer.group.id</groupId>
    <artifactId>customer-reactor</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>project-a</module>
        <module>project-b</module>
    </modules>

</project>

之后，您将为其他两个存储库添加子模块。

$ git submodule add -b main https://git.cloudmanager.adobe.com/ProgramName/projectA/ project-a
$ git submodule add -b main https://git.cloudmanager.adobe.com/ProgramName/projectB/ project-b

这会导致 .gitmodules 文件类似于以下内容。

[submodule "project-a"]
    path = project-a
    url = https://git.cloudmanager.adobe.com/ProgramName/projectA/
    branch = main
[submodule "project-b"]
    path = project-b
    url = https://git.cloudmanager.adobe.com/ProgramName/projectB/
    branch = main

可以在 Git 参考手册中找到有关 Git 子模块的更多信息。

限制和建议 limitations-recommendations

将Git子模块与Adobe管理的存储库结合使用时，请注意以下限制。

Git 子模块对专用存储库的支持 private-repositories

使用专用存储库时对 Git 子模块的支持与使用 Adobe 存储库时大致相同。

然而，在设置您的 pom.xml 文件并运行 git submodule 命令之后，您必须添加 .gitmodules 文件复制到聚合器存储库的根目录，以便 Cloud Manager 检测子模块设置。

限制和建议 limitations-recommendations-private-repos

使用带有专用存储库的 Git 子模块时，注意以下限制。