Qu’est-ce que les propriétés personnalisées ?
Les propriétés personnalisées sont des champs de métadonnées structurées que vous pouvez attacher aux référentiels ou aux organisations dans GitHub.com. Ils vous permettent de décorer vos référentiels ou organisations avec des informations telles que des infrastructures de conformité, une sensibilité des données ou des détails de projet.
Il existe deux types de propriétés personnalisées :
- Propriétés personnalisées du référentiel : métadonnées attachées à des référentiels individuels.
- Propriétés personnalisées de l’organisation : métadonnées attachées aux organisations au sein d’une entreprise.
Quels sont les avantages de l’utilisation de propriétés personnalisées ?
En plus de fournir des fonctionnalités améliorées de découverte, de flux de travail automatisés, de suivi de conformité, d’application de stratégie ciblée et de meilleures fonctionnalités de création de rapports, les propriétés personnalisées permettent une gouvernance puissante par le biais de l’intégration de l’ensemble de règles.
Les propriétés personnalisées du référentiel et de l’organisation peuvent être utilisées comme critères de ciblage pour les ensembles de règles, ce qui permet d’appliquer des stratégies affinées en fonction des métadonnées.
- Pour connaître les règles personnalisées du référentiel, consultez Création d'ensembles de règles pour les dépôts de votre organisation et Gestion des propriétés personnalisées des référentiels dans votre entreprise.
- Pour connaître les règles personnalisées de l’organisation, consultez Gestion des ensembles de règles de code pour les dépôts de votre entreprise.
Comment ajouter et gérer des propriétés personnalisées ?
Il existe plusieurs façons de gérer les propriétés personnalisées. Pour gérer les propriétés dans GitHub, vous pouvez utiliser :
- Paramètres de votre organisation ou de votre entreprise. Consultez Gestion des propriétés personnalisées pour les référentiels de votre organisation et Gestion des propriétés personnalisées pour les organisations.
- Points de terminaison d’API REST pour les propriétés personnalisées de GitHub.
Vous pouvez également configurer une intégration pour mettre à jour automatiquement des propriétés personnalisées avec des métadonnées à partir d’un système externe, tel qu’un catalogue de logiciels ou un portail de développement interne. Les propriétés externes peuvent être utilisées dans les mêmes emplacements que les propriétés personnalisées du référentiel standard. Consultez Intégration de propriétés personnalisées à un système externe
Les propriétés personnalisées standard et les propriétés externes peuvent être gérées à grande échelle avec l’API REST et GitHub Apps. Les propriétés externes sont plus adaptées lorsque le système externe doit être la source de vérité, car ils sont :
- Avec un espace de noms (
external_system.property_name), afin que leur provenance soit claire et qu’elles n’entrent pas en conflit avec d’autres propriétés personnalisées de l’organisation. - En lecture seule sur GitHub, les utilisateurs ne peuvent pas les modifier ni les désynchroniser du système externe.
Les propriétés externes ne sont pas disponibles pour les propriétés personnalisées de l’organisation (métadonnées attachées aux organisations).