Ajout d’un référentiel GitHub privé dans Cloud Manager private-repositories
En configurant Cloud Manager pour l’intégrer à votre référentiel GitHub privé hébergé sur github.com, vous pouvez valider votre code directement dans GitHub à l’aide de Cloud Manager. Cette page s’applique à tout référentiel hébergé sur github.com, quel que soit le plan GitHub (Free, Pro, Team ou Enterprise Cloud). Cette configuration supprime l’exigence de synchroniser régulièrement votre code avec le référentiel Adobe.
-
Cette page s’applique à tout référentiel hébergé sur
github.com, quel que soit le plan GitHub (Free, Pro, Team ou Enterprise Cloud). Ces référentiels utilisent l’application GitHub d’Adobe pour valider la propriété. Aucune configuration webhook n’est requise, car Cloud Manager s’intègre directement via l’application. -
Si vous souhaitez ajouter l’un des types de référentiels suivants, voir Ajouter des référentiels externes dans Cloud Manager. Ces référentiels utilisent un PAT (Personal Access Token) et un webhook configuré manuellement pour valider la propriété.
- Référentiels GitHub Enterprise Server (version auto-hébergée de GitHub).
- Référentiels GitLab (
gitlab.comet la version auto-hébergée de GitLab). - Référentiels Bitbucket (uniquement
bitbucket.org, version cloud). La version auto-hébergée de Bitbucket a été abandonnée le 15 février 2024. - Référentiels DevOps (
dev.azure.com) d’Azure.
Configuration configuration
La configuration d’un référentiel GitHub privé dans Cloud Manager se compose de deux étapes :
- Ajoutez un référentiel GitHub privé à un programme sélectionné.
- Ensuite, vérifiez la propriété du référentiel GitHub privé.
Ajouter un référentiel GitHub privé à un programme add-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 Git privé.
-
Dans le menu latéral, sous Services, sélectionnez
-
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é comme type de référentiel.
-
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 pour 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. -
Sélectionnez Enregistrer.
Vous pouvez désormais valider la propriété du référentiel privé.
Validation de la propriété d’un référentiel GitHub privé validate-ownership
Cloud Manager est désormais configuré avec votre référentiel GitHub, mais il nécessite toujours une autorisation d’accès au référentiel. 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é, procédez comme suit
-
Après avoir ajouté votre référentiel, suivez les étapes restantes de la boîte de dialogue 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’adressehttps://github.com/apps/cloud-manager-for-aemet accorder l’accès au référentiel.
· Pour plus d’informations sur l’installation et l’octroi de l’accès est terminé, 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
-
Créez un nouveau fichier nommé dans la branche par défaut de votre référentiel GitHub
.well-known/adobe/cloud-manager-challenge -
Collez le contenu du fichier secret dans le nouveau fichier et enregistrez-le.
Une fois l’application installée et le fichier secret existant dans le référentiel, poursuivez les étapes.
-
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 l’un ou l’autre 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 n’est pas disponible pour être utilisé.
La colonne Type du tableau de la page Référentiels identifie les référentiels fournis par Adobe (Adobe) et vos propres référentiels privés (GitHub).
Pour accéder au référentiel ultérieurement afin de terminer la validation, sur la page Référentiels, cliquez sur
Utiliser des 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 GitHub 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 en cours d’exécution jusqu’à ce que la vérification de qualité du code soit terminée. Les résultats de la qualité du code sont ensuite propagés à la vérification GitHub.
Lorsque la demande d’extraction est fusionnée ou fermée, le pipeline de qualité du code de pile complète créé est automatiquement supprimé.
Associer des référentiels GitHub 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
Les restrictions suivantes s’appliquent lors de l’utilisation de référentiels privés avec Cloud Manager.
- 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 Adobe GitHub est supprimée de votre organisation GitHub, la fonction de validation des demandes d’extraction est supprimée pour tous les référentiels.
- Les pipelines qui utilisent des référentiels GitHub privés et le déclencheur de build « on-commit » ne sont pas démarrés automatiquement lorsqu’une nouvelle validation est poussée 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, Cloud Manager tente toujours de valider les demandes d’extraction créées pour ce référentiel.
- Si votre organisation GitHub applique des restrictions IP, ouvrez un dossier de support pour obtenir la liste des adresses IP qui doivent être autorisées.