Adobe 存放庫的 Git 子模組支援 git-submodule-support

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

主題：
Cloud Manager
開發

建立對象：

管理員
開發人員

可使用 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

搭配Adobe管理的存放庫使用Git子模組時，請注意下列限制。

Git URL必須完全符合上節所述語法。
僅支援分支根部的子模組。
基於安全考量，請勿在Git URL中嵌入憑證。
除非另有必要，否則Adobe建議您執行下列操作來使用淺子模組：
每個子模組有git config -f .gitmodules submodule.<submodule path>.shallow true。
Git 子模組參考資料會儲存至特定的 Git 認可。因此，若對子模組存放庫進行變更，必須更新參考的認可。
例如，使用下列專案：

git submodule update --remote