Adobe リポジトリに対する Git サブモジュールのサポート git-submodule-support

Git サブモジュールを使用すると、ビルド時に Git リポジトリ間で複数のブランチのコンテンツを結合できます。

Cloud Managerのビルドプロセスを実行すると、パイプラインのリポジトリを複製し、ブランチをチェックアウトします。 ブランチのルートディレクトリに .gitmodules ファイルが存在する場合は、対応するコマンドが実行されます。

次のコマンドは、各サブモジュールを適切なディレクトリにチェックアウトします。

$ git submodule update --init

この手法は、 複数のSource Git リポジトリーの操作で説明しているソリューションの代わりになります。 Git サブモジュールに慣れており、外部マージプロセスを管理しないことを好む組織に最適です。

例えば、3 つのリポジトリがあるとします。 各リポジトリには、main という名前のブランチが 1 つ含まれます。 プライマリリポジトリ（パイプラインで設定されたもの）の main ブランチには、他の 2 つのリポジトリに含まれているプロジェクトを宣言している 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>

次に、他の 2 つのリポジトリー用のサブモジュールを追加します。

$ 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 サブモジュールのサポート private-repositories

プライベートリポジトリでの Git サブモジュールのサポートは、通常、Adobeリポジトリでの使用に似ています。

ただし、pom.xml ファイルを設定し、git submodule コマンドを実行した後、サブモジュールの設定を認識するために、Cloud Managerの集約リポジトリのルートディレクトリに .gitmodules ファイルを追加する必要があります。

制限事項と推奨事項 limitations-recommendations-private-repos

プライベートリポジトリで Git サブモジュールを使用する場合、次の制限に注意してください。