Ajout de 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
En configurant Cloud Manager pour utiliser vos propres référentiels GitHub privés, vous pouvez valider votre code directement dans votre référentiel GitHub via Cloud Manager, vous évitant ainsi d’avoir à constamment synchroniser votre code 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, appuyez ou 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 ou appuyez sur Enregistrer.
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é.
-
Après avoir 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 accordez l’accès au référentiel. - Reportez-vous à la documentation de GitHub pour plus d’informations sur la procédure à suivre.
- Une personne propriétaire de votre organisation GitHub doit installer l’application qui se trouve à l’adresse
-
Pour renforcer la sécurité, vous devez créer un fichier secret dans la branche par défaut de votre référentiel. Appuyez ou cliquez sur Générer.
-
Confirmez la génération du fichier secret en appuyant ou en cliquant sur Confirmer.
-
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, 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 appuyer ou 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 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é.
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).
Si vous devez revenir au référentiel à une date ultérieure pour terminer la validation, sur la page Référentiels, appuyez ou cliquez sur le bouton représentant des points de suspension dans la ligne représentant le référentiel GitHub que vous venez d’ajouter et sélectionnez Validation de 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.
-
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.
Limites limitations
Certaines limites s’appliquent lors de l’utilisation de référentiels privés avec Cloud Manager.
- 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.
- 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.
- Aucune balise git ne sera créée et transmise lors de l’utilisation de référentiels privés sur des pipelines de pile complète de production.
- 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.