Ajout de référentiels externes dans Cloud Manager external-repositories
Découvrez comment ajouter un référentiel externe dans Cloud Manager. Cloud Manager prend en charge l’intégration aux référentiels GitHub Enterprise, GitLab et Bitbucket.
Les clients peuvent désormais également intégrer leurs référentiels Git Azure DevOps dans Cloud Manager, avec la prise en charge des référentiels Azure DevOps modernes et VSTS hérités (Visual Studio Team Services).
- Pour les utilisateurs et utilisatrices d’Edge Delivery Services, le référentiel intégré peut être utilisé pour synchroniser et déployer le code du site.
- Pour les utilisateurs et utilisatrices d’AEM as a Cloud Service et d’Adobe Managed Services (AMS), le référentiel peut être lié aux pipelines full stack et front-end.
Configuration d’un référentiel externe
La configuration d’un référentiel externe dans Cloud Manager comprend les étapes suivantes :
- Ajouter un référentiel externe à un programme sélectionné
- Liaison d’un référentiel externe validé à un pipeline
- Configurez un webhook dans un référentiel externe.
Ajout d’un référentiel externe add-ext-repo
-
Connectez-vous à Cloud Manager à l’adresse my.cloudmanager.adobe.com et sélectionnez l’organisation appropriée.
-
Sur la console Mes programmes, sélectionnez le programme auquel vous souhaitez lier un référentiel externe.
-
Dans le menu latéral, sous Programme, cliquez sur
-
Dans le coin supérieur droit de la page Référentiels, cliquez sur Ajouter un référentiel.
-
Dans la boîte de dialogue Ajouter un référentiel, sélectionnez Référentiel privé pour lier un référentiel Git externe à votre programme.
-
Dans chaque champ respectif, fournissez les détails suivants sur votre référentiel :
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Champ Description Nom du référentiel Obligatoire. Nom expressif pour votre nouveau référentiel. URL du référentiel Obligatoire. URL du référentiel.
Si vous utilisez un référentiel hébergé sur GitHub, le chemin d’accès doit se terminer par.git.
Par exemple,https://github.com/org-name/repo-name.git(le chemin d’accès de l’URL est fourni à titre d’illustration uniquement).
Si vous utilisez un référentiel externe, il doit utiliser le format de chemin d’accès d’URL suivant :https://git-vendor-name.com/org-name/repo-name.git
ouhttps://self-hosted-domain/org-name/repo-name.git
et correspondre à votre fournisseur Git.Sélection du type de référentiel Obligatoire. Sélectionnez le type de référentiel que vous utilisez. Si le chemin d’URL du référentiel inclut le nom du fournisseur Git, tel que GitLab ou Bitbucket, le type de référentiel est déjà présélectionné pour vous.:
- GitHub (GitHub Enterprise et la version auto-hébergée de GitHub)
- GitLab (
gitlab.comet la version auto-hébergée de GitLab) - Bitbucket (uniquement
bitbucket.org- version cloud) est pris en charge. La version auto-hébergée de Bitbucket a été abandonnée à partir du 15 février 2024. - Azure DevOps (
dev.azure.com)
Description Facultatif. Description détaillée du référentiel. -
Sélectionnez Enregistrer pour ajouter le référentiel.
Fournissez maintenant un jeton d’accès pour valider la propriété du référentiel externe.
-
Dans la boîte de dialogue Validation de la propriété du référentiel privé, fournissez un jeton d’accès pour valider la propriété du référentiel externe afin que vous puissiez y accéder, puis cliquez sur Validation.
Sélection d’un jeton d’accès existant pour un référentiel Bitbucket (à titre d’illustration uniquement).
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Option de jeton d’accès | Description |
| Utilisation d’un jeton d’accès existant | Si vous avez déjà fourni un jeton d’accès au référentiel pour votre organisation et que vous avez accès à plusieurs référentiels, vous pouvez sélectionner un jeton existant. Utilisez la liste déroulante Nom du jeton pour choisir le jeton que vous souhaitez appliquer au référentiel. Sinon, ajoutez un nouveau jeton d’accès. |
| Ajout d’un nouveau jeton d’accès |
|
Après validation, le référentiel externe est prêt à l’emploi et peut être connecté à un pipeline.
Voir aussi Gérer les jetons d’accès.
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Option de jeton d’accès | Description |
| Utilisation d’un jeton d’accès existant | Si vous avez déjà fourni un jeton d’accès au référentiel pour votre organisation et que vous avez accès à plusieurs référentiels, vous pouvez sélectionner un jeton existant. Utilisez la liste déroulante Nom du jeton pour choisir le jeton que vous souhaitez appliquer au référentiel. Sinon, ajoutez un nouveau jeton d’accès. |
| Ajout d’un nouveau jeton d’accès |
|
Après validation, le référentiel externe est prêt à l’emploi et peut être connecté à un pipeline.
Voir aussi Gérer les jetons d’accès.
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Option de jeton d’accès | Description |
| Utilisation d’un jeton d’accès existant | Si vous avez déjà fourni un jeton d’accès au référentiel pour votre organisation et que vous avez accès à plusieurs référentiels, vous pouvez sélectionner un jeton existant. Utilisez la liste déroulante Nom du jeton pour choisir le jeton que vous souhaitez appliquer au référentiel. Sinon, ajoutez un nouveau jeton d’accès. |
| Ajout d’un nouveau jeton d’accès |
|
Après validation, le référentiel externe est prêt à l’emploi et peut être connecté à un pipeline.
Voir aussi Gérer les jetons d’accès.
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Option de jeton d’accès | Description |
| Utilisation d’un jeton d’accès existant | Si vous avez déjà fourni un jeton d’accès au référentiel pour votre organisation et que vous avez accès à plusieurs référentiels, vous pouvez sélectionner un jeton existant. Utilisez la liste déroulante Nom du jeton pour choisir le jeton que vous souhaitez appliquer au référentiel. Sinon, ajoutez un nouveau jeton d’accès. |
| Ajout d’un nouveau jeton d’accès |
|
Après validation, le référentiel externe est prêt à l’emploi et peut être connecté à un pipeline.
Voir aussi Gérer les jetons d’accès.
Liaison d’un référentiel externe validé à un pipeline validate-ext-repo
-
Ajoutez ou modifiez un pipeline :
Boîte de dialogue Ajout d’un pipeline hors production avec référentiel sélectionné et branche Git -
Pour spécifier l’emplacement du code source lors de l’ajout ou de la modification d’un pipeline, sélectionnez le référentiel externe de votre choix dans la liste déroulante Référentiel.
-
Dans la liste déroulante Branche Git, sélectionnez la branche comme source du pipeline.
-
Cliquez sur Enregistrer.
Configuration d’un webhook pour un référentiel externe configure-webhook
Cloud Manager vous permet de configurer des webhooks pour les référentiels Git externes que vous avez ajoutés. Voir Ajouter un référentiel externe. Ces webhooks permettent à Cloud Manager de recevoir des événements liés à différentes actions dans votre solution de fournisseur Git.
Par exemple, les webhooks permettent à Cloud Manager de déclencher des actions en fonction d’événements tels que :
- Création de la requête de tirage (PR) - Lance la fonctionnalité de validation PR.
- Événements push : démarre les pipelines lorsque le déclencheur « En cas de validation Git » est activé.
- Futures actions basées sur des commentaires : permettent des workflows, tels que le déploiement direct d’une requête de tirage vers un environnement de développement rapide (RDE).
La configuration Webhook n’est pas requise pour les référentiels hébergés sur GitHub.com, car Cloud Manager s’intègre directement via l’application GitHub.
Pour tous les autres référentiels externes intégrés avec un jeton d’accès, tels que GitHub Enterprise, GitLab, Bitbucket et Azure DevOps, la configuration webhook est disponible et doit être configurée manuellement.
Pour configurer un webhook pour un référentiel externe, procédez comme suit
-
Connectez-vous à Cloud Manager à l’adresse my.cloudmanager.adobe.com et sélectionnez l’organisation appropriée.
-
Dans la console Mes programmes, sélectionnez le programme pour lequel vous souhaitez configurer un webhook pour un référentiel Git externe.
-
Dans le coin supérieur gauche de la page, cliquez sur
-
Dans le menu de gauche, sous l’en-tête Programme, cliquez sur
-
Sur la page Référentiels, à l’aide de la colonne Type pour vous guider dans votre sélection, localisez le référentiel souhaité, puis cliquez sur l’icône
-
Dans le menu déroulant, cliquez sur Configurer le Webhook.
-
Dans la boîte de dialogue Configurer le Webhook, procédez comme suit :
- En regard du champ URL Webhook, cliquez sur
Collez l’URL dans un fichier texte brut. L’URL copiée est requise pour les paramètres du Webhook de votre fournisseur Git. - En regard du champ Secret Webhook jeton/clé, cliquez sur Générer, puis sur
Collez le secret dans un fichier texte brut. Le secret copié est requis pour les paramètres du Webhook de votre fournisseur Git.
- En regard du champ URL Webhook, cliquez sur
-
Cliquez sur Fermer.
-
Accédez à votre solution de fournisseur Git (GitHub Enterprise, GitLab, Bitbucket ou Azure DevOps).
Tous les détails sur la configuration webhook et les événements requis pour chaque fournisseur sont disponibles dans Ajouter un référentiel externe. Sous l’étape 8, consultez le tableau à onglets.
-
Recherchez la section Paramètres Webhook de la solution.
-
Collez l’URL du Webhook que vous avez copiée précédemment dans le champ de texte de l’URL.
-
Remplacez le paramètre de requête
api_keydans l’URL du Webhook par votre propre clé API réelle.Pour générer une clé API, vous devez créer un projet d’intégration dans Adobe Developer Console. Voir Création d’un projet d’intégration d’API pour plus d’informations.
-
-
Collez le secret Webhook que vous avez copié précédemment dans le champ de texte Secret (ou Clé secrète ou Jeton secret).
-
Configurez le webhook pour envoyer les événements requis par Cloud Manager. Utilisez le tableau suivant pour déterminer les événements corrects pour votre fournisseur Git.
| table 0-row-1 1-row-1 |
|---|
| Événements webhook obligatoires |
|
Ces événements permettent à Cloud Manager de répondre à l’activité GitHub, comme la validation de la demande d’extraction, les déclencheurs basés sur les notifications push pour les pipelines ou la synchronisation du code Edge Delivery Services.
|
| table 0-row-1 1-row-1 |
|---|
| Événements webhook obligatoires |
|
Ces événements webhook permettent à Cloud Manager de déclencher des pipelines lorsque le code est transmis ou qu’une demande de fusion est envoyée. Ils effectuent également le suivi des commentaires liés à la validation de la demande d’extraction (par le biais d’événements de note).
|
| table 0-row-1 1-row-1 |
|---|
| Événements webhook obligatoires |
|
Ces événements permettent à Cloud Manager de valider les demandes d’extraction, de répondre aux publications de code et d’interagir avec les commentaires pour la coordination du pipeline.
|
| table 0-row-1 1-row-1 |
|---|
| Événements webhook requis et authentification |
|
Ces événements permettent à Cloud Manager de valider les demandes d’extraction, de répondre aux publications de code et d’interagir avec les commentaires pour la coordination du pipeline.
Définition de l’authentification : |
Validation des requêtes d’extraction avec des Webhooks
Une fois les Webhooks configurés correctement, Cloud Manager déclenche automatiquement les exécutions de pipeline ou les contrôles de validation de RP pour votre référentiel.
Le comportement varie en fonction du fournisseur Git que vous utilisez, comme indiqué ci-dessous.
Lorsque la vérification est créée, elle ressemble à la capture d’écran ci-dessous. La principale différence avec GitHub.com est que GitHub.com utilise une exécution de vérification, tandis que GitHub Enterprise (à l’aide de jetons d’accès personnel) génère un statut de validation :
Les interactions GitLab reposent uniquement sur des commentaires. Lorsque la validation commence, un commentaire est ajouté. Une fois la validation terminée (qu’elle ait réussi ou échoué), le commentaire initial est supprimé et remplacé par un nouveau commentaire contenant les résultats de la validation ou les détails de l’erreur.
Lorsque la validation de la qualité du code est en cours d’exécution :
Lorsque la validation de la qualité à froid est terminée :
Lorsque la validation de la qualité du code échoue avec une erreur :
Lorsque la validation de la qualité du code échoue en raison de problèmes client :
Lorsque la validation de la qualité du code est en cours d’exécution :
Utilise le statut de validation pour le suivi de la progression de la validation PR. Dans le cas suivant, la capture d’écran montre ce qui se produit lorsqu’une validation de qualité du code échoue en raison d’un problème client. Un commentaire est ajouté avec des informations détaillées sur les erreurs, et une vérification de validation est créée, qui affiche l’échec (visible à droite) :
Azure DevOps effectue le suivi de la validation de la demande de tirage par le biais de contrôles de statut. Lorsque Cloud Manager exécute la validation de la demande d’extraction, il ajoute des vérifications de statut qui apparaissent dans l’interface de demande d’extraction Azure DevOps.
Lors de la validation de la qualité du code, une vérification de l’état indique que le processus est en cours :
Une fois la validation de la qualité du code terminée, la vérification de statut se met à jour pour refléter les résultats :
Si la validation échoue, des informations d’erreur détaillées sont fournies dans les détails de vérification de l’état. Vous pouvez cliquer sur la vérification de statut pour afficher les résultats complets de la validation dans Cloud Manager.
Pour les commentaires et les retours de la demande d’extraction, Cloud Manager ajoute directement des commentaires à la demande d’extraction dans Azure DevOps avec les détails de validation et les actions nécessaires.
Résolution des problèmes webhook
- Assurez-vous que l’URL du Webhook comprend une clé API valide.
- Vérifiez que les événements webhook sont correctement configurés dans les paramètres de votre fournisseur Git.
- Si la validation PR ou les déclencheurs de pipeline ne fonctionnent pas, vérifiez que le secret Webhook est à jour dans Cloud Manager et votre fournisseur Git.