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

Last update: Wed Oct 09 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

管理员
开发人员

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

Cloud Manager的构建过程运行时，会克隆管道的存储库并签出分支。如果分支的根目录中存在.gitmodules文件，则执行相应的命令。

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

$ git submodule update --init

此技术为使用多个Source 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 URL必须完全遵循上一节中所述的语法。
仅支持分支的根目录中的子模块。
为安全起见，请勿在Git URL中嵌入凭据。
除非另有必要，否则Adobe建议您通过运行以下命令来使用浅子模块：
每个子模块的git config -f .gitmodules submodule.<submodule path>.shallow true。
Git 子模块引用将存储到特定的 Git 承诺中。因此，在对子模块存储库进行更改时，必须更新引用的承诺。
例如，使用以下命令：

git submodule update --remote