Ajout d’un référentiel GitHub privé dans Cloud Manager private-repositories

En configurant Cloud Manager pour l’intégration à vos référentiels GitHub privés, vous pouvez valider votre code directement dans GitHub à l’aide de Cloud Manager. Cette configuration supprime l’obligation de synchroniser régulièrement votre code avec le référentiel Adobe.

NOTE
Cette fonctionnalité est réservée au GitHub public. La prise en charge du GitHub auto-hébergé n’est pas disponible.

Configuration configuration

La configuration d’un référentiel GitHub privé dans Cloud Manager se compose de deux étapes :

Ajouter un référentiel GitHub privé à un programme add-repo

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

  2. Dans la console Mes programmes, sélectionnez le programme auquel vous souhaitez lier un référentiel Git privé.

  3. Dans le menu latéral, sous Services, sélectionnez Icône Dossier Référentiels.

    Page Référentiels

  4. Près du coin supérieur droit de la page Référentiels, cliquez sur Ajouter un référentiel.

  5. Dans la boîte de dialogue Ajouter un référentiel, sélectionnez Référentiel privé comme type de référentiel.

    Ajout de votre propre référentiel.

  6. 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
    Champ Description
    Nom du référentiel Nom expressif de votre nouveau référentiel.
    URL du référentiel URL du référentiel privé, qui doit se terminer par .git.
    Par exemple, https://github.com/org-name/repo-name.git (le chemin de l’URL est fourni à titre d’illustration uniquement).
    Description (facultative) Description détaillée du référentiel.
  7. Sélectionnez Enregistrer.
    Désormais, vous pouvez valider la propriété du référentiel privé.

TIP
Pour plus d’informations sur la gestion des référentiels dans Cloud Manager, consultez le document Référentiels Cloud Manager.

Validation de la propriété d’un référentiel GitHub privé validate-ownership

Cloud Manager connaît désormais votre référentiel GitHub, mais il doit toujours y accéder. Pour accorder l’accès, vous devez installer l’application GitHub d’Adobe et vérifier que vous êtes propriétaire du référentiel spécifié.

Pour valider la propriété d’un référentiel GitHub privé :

  1. Après avoir ajouté votre propre référentiel, suivez les étapes restantes dans la boîte de dialogue Validation de la propriété du référentiel privé.

    Validation de la propriété du référentiel privé.

    table 0-row-2 1-row-2 2-row-2
    Description
    Étape 1 : application GitHub Cloud Manager utilise une application GitHub pour interagir en toute sécurité avec votre référentiel privé.
    ・ Un propriétaire de votre organisation GitHub doit installer l’application située à l’emplacement https://github.com/apps/cloud-manager-for-aem et accorder l’accès au référentiel.
    ・ Pour plus d’informations sur l’installation et l’octroi de l’accès, consultez la documentation de GitHub.
    Étape 2 : fichier secret Pour améliorer la sécurité, vous devez créer un fichier secret dans la branche par défaut de votre référentiel.
    ・ Cliquez sur Générer, puis sur Confirmer. Cloud Manager génère le contenu du fichier privé dans le champ de texte Contenu du fichier secret .
    ・ Cliquez sur Icône Copier pour copier le contenu de ce champ. Le contenu du fichier secret ne s’affichera qu’une seule fois. Si vous ne copiez pas le contenu avant de fermer cette boîte de dialogue, régénérez le secret.
  2. Créez un fichier dans la branche par défaut de votre référentiel GitHub appelé :

    .well-known/adobe/cloud-manager-challenge

  3. Collez le contenu du fichier secret dans le nouveau fichier que vous venez de créer, puis enregistrez-le.

    Une fois l’application installée et que le fichier secret existe dans le référentiel, passez à l’étape .

  4. Dans la boîte de dialogue Validation de la propriété du référentiel privé, cliquez sur Valider.

L’application peut être installée et un fichier secret peut être créé dans n’importe quel ordre. Toutefois, vous devez effectuer les deux étapes avant de pouvoir valider.

Jusqu’à la validation, le référentiel est répertorié avec une icône rouge indiquant qu’il n’est pas encore validé et qu’il ne peut pas encore être utilisé.

Référentiel non validé.

La colonne Type de la table sur la page Référentiels identifie les référentiels fournis par l’Adobe (Adobe) et vos propres référentiels privés (GitHub).

Si vous devez revenir au référentiel ultérieurement pour terminer la validation, sur la page Référentiels, cliquez sur Icône More dans la ligne représentant le référentiel GitHub que vous venez d’ajouter. Dans la liste déroulante, sélectionnez Validation de propriété.

Utilisation de référentiels GitHub privés avec Cloud Manager using

Une fois le référentiel GitHub validé dans Cloud Manager, l’intégration est terminée. Vous pouvez utiliser le référentiel avec Cloud Manager.

Pour utiliser des référentiels privés avec Cloud Manager :

  1. Lorsque vous créez une demande d’extraction, une vérification GitHub démarre automatiquement.

    Vérifications GitHub

  2. Un pipeline de qualité de code de pile pleine est créé automatiquement pour chaque demande d’extraction. Ce pipeline démarre à chaque mise à jour de demande d’extraction.

  3. La vérification GitHub reste en cours d’exécution jusqu’à ce que la vérification de la qualité du code soit terminée. Les résultats de la qualité du code sont ensuite propagés à la vérification GitHub.

    Vérifications de la qualité du code GitHub.

Lorsque la requête de tirage est fusionnée ou fermée, le pipeline de qualité de code de pile complet créé est automatiquement supprimé.

TIP
Voir Annotations de vérification GitHub pour plus d’informations sur les informations fournies par l’intermédiaire de GitHub lors de l’exécution des vérifications de requête de tirage.
TIP
Vous pouvez contrôler les pipelines créés automatiquement pour valider chaque requête d’extraction dans un référentiel privé. Consultez le document Configuration de la vérification GitHub pour les référentiels privés pour plus d’informations.

Associer des référentiels privés à des pipelines pipelines

Les référentiels privés validés peuvent être associés aux pipelines full-stack et front-end.

Limites limitations

Certaines limites s’appliquent lors de l’utilisation de référentiels privés avec Cloud Manager.

  • Les pipelines de niveau web et de configuration ne sont pas pris en charge pour les référentiels privés.
  • Aucune balise Git ne sera créée et transmise lors de l’utilisation de référentiels privés sur des pipelines de pile pleine de production.
  • Si l’application GitHub d’Adobe est supprimée de votre organisation GitHub, elle supprime la fonctionnalité de validation des demandes d’extraction pour tous les référentiels.
  • Les pipelines qui utilisent des référentiels privés et le déclencheur de version sur validation ne sont pas lancés automatiquement lorsqu’une nouvelle validation est transmise dans la branche sélectionnée.
  • La fonctionnalité de réutilisation des artefacts ne s’applique pas aux référentiels privés.
  • Vous ne pouvez pas suspendre la validation de la requête de tirage à l’aide de la vérification GitHub de Cloud Manager.
    Si le référentiel GitHub est validé dans Cloud Manager, Cloud Manager tente toujours de valider les demandes d’extraction créées pour ce référentiel.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab