Utiliser vos propres référentiels GitHub dans Cloud Manager byo-github

En configurant Cloud Manager pour qu’il fonctionne avec vos propres référentiels GitHub, vous pouvez valider votre code directement dans votre référentiel GitHub via Cloud Manager, rendant ainsi inutile la synchronisation cohérente de votre code avec le référentiel Adobe.

NOTE
Cette fonctionnalité n’est disponible que pour le programme d’adoption précoce.
NOTE
Cette fonctionnalité est réservée au GitHub public. La prise en charge de GitHub auto-hébergé n’est pas disponible.

Configuration configuration

La configuration se compose de deux étapes principales :

Ajouter un référentiel add-repo

  1. Dans Cloud Manager, à partir du Aperçu du programme , sélectionnez Référentiels pour basculer vers l’onglet Référentiels page et clic Ajouter un référentiel.

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

  3. Fournir des détails de votre référentiel

    • Nom du référentiel  : un nom expressif.
    • URL du référentiel  : l’URL du référentiel, qui doit se terminer par .git.
    • Description (facultatif) : une description plus longue du référentiel selon les besoins.

    Ajout de votre propre référentiel.

  4. Sélectionnez Enregistrer.

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

Valider la propriété du référentiel 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é.

  1. Après avoir ajouté votre propre référentiel, la variable Validation de la propriété du référentiel privé s’ouvre.

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

  2. Cloud Manager utilise une application GitHub pour interagir de manière sécurisée avec votre référentiel.

    • Une personne propriétaire de votre organisation GitHub doit installer l’application qui se trouve à l’adresse https://github.com/apps/cloud-manager-for-aem et accordez l’accès au référentiel.
    • Consultez la documentation de GitHub pour plus d’informations sur la manière dont cela est effectué.
  3. Pour renforcer la sécurité, vous devez créer un fichier secret dans la branche par défaut de votre référentiel. Sélectionner Générer.

  4. Confirmez la génération du fichier secret en appuyant ou en cliquant sur Confirmer.

    Confirmation de la génération du secret.

  5. De retour dans la fenêtre Validation de la propriété du référentiel privé, Cloud Manager a généré le contenu du fichier privé dans le champ Contenu du fichier secret. Copiez 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 fenêtre, régénérez le secret.

    Copie du contenu du fichier secret.

  6. Créez un fichier dans la branche par défaut de votre référentiel GitHub appelé .well-known/adobe/cloud-manager-challenge, collez le contenu du fichier secret dans ce fichier et enregistrez-le.

  7. Une fois l’application installée et le fichier secret présent dans le référentiel, vous pouvez sélectionner Valider dans le Validation de la propriété du référentiel privé boîte de dialogue.

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 variable Type identifie facilement les référentiels fournis par l’Adobe (Adobe) et vos propres référentiels GitHub (GitHub).

Si vous devez revenir au référentiel à une date ultérieure pour terminer la validation, sur la page Référentiels , sélectionnez le bouton représentant des points de suspension dans la ligne représentant le référentiel GitHub que vous venez d’ajouter, puis sélectionnez Validation de propriété dans le menu déroulant.

Utiliser vos propres référentiels GitHub avec Cloud Manager using

Une fois le référentiel GitHub validé dans Cloud Manager, l’intégration est terminée et vous pouvez utiliser le référentiel 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 à l’état d’exécution jusqu’à ce que les vérifications de la qualité du code soient terminées. 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 demande d’extraction est fermée ou fusionnée, le pipeline de qualité de code de pile pleine créé est automatiquement supprimé.

Limites limitations

Limites lors de l’utilisation de vos propres référentiels GitHub avec Cloud Manager.

  • Vous ne pouvez pas utiliser les référentiels GitHub comme source directe de référentiel pour les pipelines que vous gérez.
    • Cette fonctionnalité est prévue.
  • Vous ne pouvez pas suspendre la validation de la requête de tirage à l’aide de la vérification GitHub du gestionnaire de cloud.
    • Si le référentiel GitHub est validé dans Cloud Manager, ce dernier tente toujours de valider les demandes d’extraction créées pour ce référentiel.
      Si l’application GitHub d’Adobe est supprimée de votre organisation GitHub, la fonctionnalité de validation des demandes d’extraction est supprimée pour tous les référentiels.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab