Prise en charge des sous-modules Git pour les référentiels Adobe git-submodule-support

Les sous-modules Git peuvent être utilisés pour fusionner le contenu de plusieurs branches dans des référentiels Git au moment de la création.

Lorsque le processus de création Cloud Manager s’exécute, il commence par cloner le référentiel du pipeline et extrait la branche configurée. Si la branche contient un fichier .gitmodules dans le répertoire racine, la commande est exécutée.

$ git submodule update --init

Cette procédure extrait chaque sous-module dans le répertoire approprié. Cette technique constitue une alternative potentielle à l’utilisation de plusieurs référentiels Git source pour les organisations qui maîtrisent l’utilisation des sous-modules Git et qui ne souhaitent pas gérer de processus de fusion externe.

Par exemple, supposons qu’il existe trois référentiels, chacun contenant une seule branche nommée main. Dans le référentiel « principal », c’est-à-dire celui qui est configuré dans les pipelines, la branche main contient un fichier pom.xml qui déclare les projets contenus dans les deux autres référentiels :

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://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>

Vous ajoutez ensuite des sous-modules pour les deux autres référentiels :

$ 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

Les résultats du fichier .gitmodules ressemblent à ce qui suit :

[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

Pour plus d’informations sur les sous-modules Git, consultez le manuel de référence Git.

Limites limitations

Lors de l’utilisation de sous-modules Git, tenez compte des points suivants :

Prise en charge des sous-modules Git pour les référentiels privés private-repositories

La prise en charge des sous-modules Git pour les référentiels privés est largement similaire à celle des référentiels Adobe.

Cependant, après avoir configuré votre fichier pom.xml et exécuté les commandes git submodule, vous devez ajouter un fichier .gitmodules dans le répertoire racine du référentiel de l’agrégateur pour que Cloud Manager détecte la configuration du sous-module.

Limites et recommandations limitations-recommendations-private-repos

Lors de l’utilisation de sous-modules Git avec des référentiels privés, tenez compte des limites suivantes.