Référentiels Cloud Manager

Découvrez comment créer, afficher et supprimer vos référentiels Git dans Cloud Manager.

Ajouter et gérer des référentiels

Suivez ces étapes pour afficher et gérer les référentiels dans Cloud Manager.

1. Sur la page Présentation du programme, cliquez sur l’onglet Référentiels et accédez à la page Référentiels.

2. Cliquez sur Ajouter un référentiel pour lancer l’assistant.

   

3. Saisissez le nom et la description demandés, puis cliquez sur Enregistrer.

   

Lorsque l’assistant se ferme, votre nouveau référentiel s’affiche dans le tableau.

Vous pouvez sélectionner le référentiel dans le tableau, puis cliquer sur le bouton représentant des points de suspension et sélectionner Copier l’URL du référentiel, Afficher et mettre à jour ou Supprimer.

Vous pouvez également sélectionner les référentiels créés dans Cloud Manager lors de l’ajout ou de la modification de pipelines. Consultez le document Pipelines CI/CD pour en savoir plus.

Il existe un référentiel principal unique ou une branche pour chaque pipeline donné. Grâce à la prise en charge des sous-modules Git, de nombreuses branches secondaires peuvent être incluses au moment de la création.

Supprimer un référentiel

La suppression d’un référentiel entraînera les éléments suivants :

• Le nom du référentiel supprimé sera inutilisable pour de nouveaux référentiels qui pourraient être créés ultérieurement.
  • Le message d’erreur suivant Repository name should be unique within organization. s’affiche dans de tels cas.
• Le référentiel supprimé sera indisponible dans Cloud Manager et ne pourra donc pas être lié à un pipeline.

Pour supprimer un référentiel dans Cloud Manager, procédez comme suit.

1. Sur la page Présentation du programme, cliquez sur l’onglet Référentiels et accédez à la page Référentiels.

2. Sélectionnez le référentiel, cliquez sur le bouton représentant des points de suspension, puis sélectionnez Supprimer pour supprimer le référentiel.

   

Prise en charge des sous-modules Git

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 de Cloud Manager s’exécute, une fois le référentiel configuré pour le pipeline cloné et la branche configurée extraite, si la branche contient un fichier .gitmodules dans le répertoire racine, la commande est exécutée.

La commande suivante extrait chaque sous-module dans le répertoire approprié.

$ git submodule update --init

Cette technique constitue une alternative potentielle à la solution décrite dans le document Utiliser plusieurs référentiels Git sources 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="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>

Vous pouvez ensuite ajouter 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

Vous obtenez un fichier .gitmodules similaire au fichier suivant.

[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.

Restrictions et recommandations

Lors de l’utilisation de sous-modules Git, tenez compte des limitations suivantes.

• L’URL Git doit se trouver exactement dans la syntaxe décrite dans la section précédente.
• Seuls les sous-modules situés à la racine de la branche sont pris en charge.
• Pour des raisons de sécurité, n’incorporez pas d’informations d’identification dans les URL Git.
• Sauf si nécessaire, il est vivement recommandé d’utiliser des sous-modules superficiels.
  • Pour ce faire, exécutez git config -f .gitmodules submodule.<submodule path>.shallow true pour chaque sous-module.
• Les références des sous-modules Git sont stockées vers des validations Git spécifiques. Par conséquent, lorsque des modifications sont apportées au référentiel de sous-module, la validation référencée doit être mise à jour.
  • Par exemple, en utilisant git submodule update --remote

Ressources Business.Adobe.com