Référentiels Cloud Manager

Les référentiels sont l’endroit où vous pouvez gérer votre code à l’aide de Git. Découvrez comment créer des référentiels pour vos programmes Cloud Manager.

Accéder aux référentiels

Vous pouvez accéder à vos référentiels Git et les gérer en libre-service à partir de Cloud Manager.

Pour accéder à votre référentiel, utilisez le bouton Accéder aux informations sur le référentiel disponible dans Cloud Manager, notamment sur la vignette de pipeline.

  1. Connectez-vous à Cloud Manager à l’adresse my.cloudmanager.adobe.com et sélectionnez l’organisation et le programme appropriés.

  2. Accédez à la vignette Pipelines de la page Présentation du programme. C’est là que se trouve l’option Accéder aux informations sur le référentiel, qui vous permet de gérer et d’accéder à votre référentiel Git configuré avec ce pipeline.

    Bouton Accéder aux informations sur le référentiel

  3. Si vous passez à l’onglet du pipeline Hors-production, l’option Accéder aux informations sur le référentiel est également disponible, telle que configurée pour le pipeline.

    Pipelines hors production

  4. Cliquez sur le bouton Accéder aux informations sur le référentiel pour ouvrir une boîte de dialogue qui affiche les éléments suivants :

    • URL vers le référentiel Git ;
    • nom d’utilisateur ;
    • mot de passe ;
    • commande Git à exécuter pour cloner le référentiel localement.

    Boîte de dialogue d’informations sur le référentiel

Utilisez les informations fournies pour cloner le référentiel localement afin de pouvoir commencer le développement local.

REMARQUE

L’option Accéder aux informations sur le référentiel est visible par les utilisateurs possédant le rôle Développeur ou Responsable de déploiement.

Ajouter des référentiels

Pour ajouter des référentiels dans Cloud Manager, procédez comme suit :

  1. Connectez-vous à Cloud Manager à l’adresse my.cloudmanager.adobe.com et sélectionnez l’organisation et le programme appropriés.

  2. Sur la page Aperçu du programme, cliquez sur l’onglet Référentiels et accédez à la page Référentiels.

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

    REMARQUE

    Vous devez avoir le rôle Responsable de déploiement ou Propriétaire de l’entreprise pour ajouter un référentiel.

    Ajouter un référentiel

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

    Détails du référentiel

  5. Sélectionnez Enregistrer.

Le référentiel que vous venez de créer s’affiche.

Référentiel nouvellement créé

Vous pouvez sélectionner les référentiels créés dans Cloud Manager lorsque vous créez vos pipelines.

Afficher et modifier des référentiels

Pour modifier et afficher les référentiels dans Cloud Manager, procédez comme suit :

  1. Connectez-vous à Cloud Manager à l’adresse my.cloudmanager.adobe.com et sélectionnez l’organisation et le programme appropriés.

  2. Sur la page Présentation du programme, cliquez sur l’onglet Référentiels et accédez à la page Référentiels. Ici, vous pouvez afficher les détails de vos référentiels existants.

  3. Sélectionnez le référentiel et cliquez sur le bouton de points de suspension à droite du tableau pour copier l’URL du référentiel, afficher et mettre à jour ou supprimer votre référentiel.

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

$ 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 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="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 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 qui ressemble à ceci :

[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

Vous trouverez plus d’informations sur les sous-modules Git dans le Manuel de référence Git.

Limites

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

  • L’URL Git doit se trouver exactement dans la syntaxe décrite ci-dessus.
  • Pour des raisons de sécurité, n’incorporez pas les informations d’identification dans ces URL.
  • Seuls les sous-modules situés à la racine de la branche sont pris en charge.
  • 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 à l’aide de git submodule update --remote.
  • Sauf indication contraire, 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.

Sur cette page