Création et configuration du connecteur Git à partir de l’interface utilisateur
Utilisez l’outil Sources de données de Experience Manager Guides pour créer et configurer un connecteur Git à partir de l’interface utilisateur. Une fois le connecteur configuré, vous pouvez l’utiliser pour importer du contenu d’un référentiel Git dans Experience Manager Guides.
-
Sélectionnez le lien en haut et choisissez Outils.
-
Sélectionnez Guides dans la liste des outils.
-
Sélectionnez la mosaïque Sources de données. La page Sources de données s’affiche.
-
Sélectionnez Créer.
-
Dans la liste des connecteurs de source de données, sélectionnez GitHub.
{width="600"}
-
Sélectionnez Suivant.
-
Saisissez les détails de configuration et de connexion.
{width="600"}
note tip TIP - Survoler
{width="25"} près du champ pour en savoir plus. - Les champs comportant le caractère * sont obligatoires. Par exemple, vous pouvez saisir les informations suivantes pour le connecteur Elasticsearch.
- Nom : saisissez le nom de la source de données.
- Chemin d’accès racine AEM cible : saisissez le chemin d’accès dans le référentiel AEM où le contenu importé depuis Git doit être stocké.
- Filtre de type de fichier (inclusion) : indiquez les types de fichiers à inclure lors de l’importation.
- Chemin exclu (regex) : spécifiez les modèles de chemin à exclure de l’importation.
- Type d’authentification : sélectionnez le type d’authentification dans la liste déroulante. Actuellement, la méthode d’authentification PAT (Personal Access Token) est la seule prise en charge. Saisissez le chemin d’accès lors de la configuration du connecteur pour authentifier et accéder au référentiel Git.Découvrez comment générer un jeton d’accès personnel GitHub.
Lors de la sélection des portées pendant la génération PAT sur GitHub, veillez à activer les portées suivantes :
- repo : cochez la case de niveau supérieur. Toutes les sous-portées sont sélectionnées automatiquement, ce qui permet d’accéder au contenu du référentiel, au statut de validation et aux déploiements.
- admin:org : sélectionnez uniquement lecture:org. Cela est nécessaire pour résoudre l’appartenance à l’organisation et à l’équipe.- URL du référentiel : saisissez l’URL du référentiel Git à partir de laquelle le contenu doit être importé.
- Branche : renseignez la branche à utiliser pour l’importation de contenu.
- Survoler
-
Testez la connexion. Le bouton Tester la connexion n’est activé qu’après avoir saisi les détails requis. Si les détails de la connexion sont corrects, un message de réussite s’affiche. Dans le cas contraire, un message d’erreur s’affiche.
{width="600"}
-
Sélectionnez Enregistrer dans la partie supérieure pour enregistrer le connecteur.
Le bouton Enregistrer n’est activé qu’une fois tous les détails requis saisis et la connexion établie. Si le connecteur est enregistré correctement, vous pouvez afficher le connecteur Github configuré sur la page Sources de données.
{width="600"}
Ajouter le connecteur Git à votre projet Cloud Manager
Avant que le connecteur Git ne soit disponible pour configuration à partir de la page Sources de données, il doit être incorporé en tant que dépendance dans votre projet AEM. Effectuez les étapes suivantes pour ajouter la dépendance :
-
Dans le
all/pom.xmlde votre projet AEM, ajoutez Connecteur Git en tant que dépendance sous<dependencies>:code language-xml <dependency> <groupId>com.adobe.aem.addon.guides</groupId> <artifactId>konnect-github</artifactId> <version>1.0.0</version> </dependency> -
Dans le même
pom.xml, ajoutez la dépendance à la section<embeddeds>de la configurationfilevault-package-maven-plugin:code language-xml <embedded> <groupId>com.adobe.aem.addon.guides</groupId> <artifactId>konnect-github</artifactId> <type>jar</type> <target>/apps/YOUR-vendor-packages/content/install</target> </embedded>Remplacez
YOUR-vendor-packagespar le nom du package fournisseur de votre projet. -
Validez et envoyez les modifications à votre référentiel Git Cloud Manager, puis exécutez le pipeline pour les déployer.
Une fois le pipeline terminé, le connecteur Git est installé dans votre environnement et disponible pour configuration à partir de la page Sources de données.