Ajouter des référentiels privés dans Cloud Manager private-repositories
Découvrez comment configurer Cloud Manager pour utiliser vos propres référentiels GitHub privés.
Vue d’ensemble overview
La configuration de Cloud Manager avec vos référentiels GitHub privés vous permet de valider le code directement dans GitHub, éliminant ainsi la nécessité de se synchroniser fréquemment avec le référentiel Adobe.
Configuration configuration
La configuration se compose de deux étapes principales :
Ajouter un référentiel add-repo
-
Dans Cloud Manager, dans la page Vue d’ensemble du programme, cliquez sur l’onglet Référentiels pour basculer vers la page Référentiels et cliquez sur Ajouter un référentiel.
-
Dans la boîte de dialogue Ajouter un référentiel, sélectionnez Référentiel privé comme type de référentiel.
-
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.
-
Cliquez sur Enregistrer.
Validation de la propriété d’un 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é.
-
Lorsque vous avez ajouté votre propre référentiel, la boîte de dialogue Validation de la propriété du référentiel privé s’ouvre.
-
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-aemet accorder l’accès au référentiel. Consultez la documentation GitHub pour plus de détails. -
Pour renforcer 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.
-
Confirmez la génération du fichier secret en cliquant sur Confirmer.
-
Dans la boîte de dialogue Validation de la propriété du référentiel privé, Cloud Manager a généré le contenu 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, vous devrez générer le secret à nouveau.
-
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. -
Une fois que l’application est installée et que le fichier secret existe dans le référentiel, vous pouvez cliquer sur Valider dans la boîte de dialogue Validation de la propriété du référentiel privé.
L’application peut être installée et vous pouvez générer un fichier secret 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é.
Notez que la colonne Type permet d’identifier facilement les référentiels fournis par Adobe (Adobe) et vos propres référentiels GitHub (GitHub).
Pour revenir au référentiel ultérieurement et terminer la validation, accédez à la page Référentiels. Cliquez sur le bouton représentant des points de suspension en regard du référentiel GitHub que vous avez ajouté, puis sélectionnez Validation de la propriété dans le menu déroulant.
Utiliser des référentiels privés 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.
Pour utiliser des référentiels privés avec Cloud Manager :
-
Lorsque vous créez une demande d’extraction, une vérification GitHub démarre automatiquement.
-
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.
-
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.
Lorsque la demande d’extraction est fermée ou fusionnée, le pipeline de qualité de code de pile pleine créé est automatiquement supprimé.
Associer des référentiels privés à des pipelines pipelines
Les référentiels privés validés peuvent être associés à des 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, la fonctionnalité de validation des demandes d’extraction est supprimée 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 demande d’extraction à l’aide de la vérification GitHub à partir de Cloud Manager. 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.