Gestion des propriétés personnalisées des référentiels dans votre entreprise

Créez des propriétés personnalisées pour donner aux organisations un moyen cohérent de classer les référentiels.

Qui peut utiliser cette fonctionnalité ?

Enterprise owners

Dans cet article

Les propriétés personnalisées vous permettent de décorer vos référentiels avec des informations telles que les cadres de conformité, la sensibilité des données ou les détails du projet. Les propriétés personnalisées sont privées et peuvent uniquement être vues par des personnes disposant d’autorisations d’accès en lecture sur le référentiel. Une entreprise peut avoir jusqu’à 100 définitions de propriétés. Une liste de valeurs autorisées peut contenir jusqu’à 200 éléments.

La définition de propriétés personnalisées au niveau de l’entreprise vous permet de créer des valeurs cohérentes que les utilisateurs peuvent appliquer aux référentiels. Avec les propriétés personnalisées en place, vous pouvez appliquer une gouvernance cohérente à tous les référentiels de votre entreprise en créant un ensemble de règles ou une stratégie de référentiel ciblant les référentiels dotés de certaines propriétés. Consultez « Contrôlez l’utilisation des référentiels dans votre entreprise ».

Caractères autorisés

Les noms et valeurs de propriétés personnalisés ne peuvent contenir que certains caractères :

  • Noms : a-z, A-Z, 0-9, _, -, $, #.
  • Valeurs : tous les caractères ASCII imprimables, sauf ".

Qui peut définir et voir les valeurs des propriétés personnalisées que je définis ?

Après avoir défini une propriété personnalisée, les utilisateurs peuvent définir une valeur pour cette propriété dans les référentiels de l’entreprise. Consultez « Gestion des propriétés personnalisées pour les référentiels de votre organisation ».

  • En tant que propriétaire d’une entreprise, vous pouvez définir une valeur par défaut pour les propriétés requises.
  • Les propriétaires d’organisations peuvent définir des valeurs dans leur organisation, soit pour l’ensemble des référentiels, soit au niveau du référentiel.
  • Si cette option est activée, toute personne disposant d’un accès au référentiel ou de l’autorisation custom properties peut définir et mettre à jour la valeur de la propriété pour son référentiel.

Les personnes disposant de droits de lecture sur un référentiel peuvent afficher les valeurs des propriétés personnalisées de ce référentiel.

De plus, les propriétaires d’organisations peuvent rechercher les référentiels dans leur organisation par des valeurs de propriétés personnalisées. Consultez « Gestion des propriétés personnalisées pour les référentiels de votre organisation ».

Ajout de propriétés personnalisées

Vous pouvez ajouter des propriétés personnalisées à votre entreprise pour les rendre disponibles dans toutes vos organisations.

  1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil.
  2. En fonction de votre environnement, cliquez sur Votre entreprise ou sur Vos entreprises, puis cliquez sur l'entreprise que vous souhaitez consulter.
  3. Dans la barre latérale gauche, dans « Stratégies », cliquez sur Propriétés personnalisées.
  4. Pour ajouter une nouvelle propriété personnalisée, dans le coin supérieur droit, cliquez sur Nouvelle propriété.
  5. Entrez un nom, une description et un type pour la propriété personnalisée. Le nom doit être unique dans toutes vos organisations et ne peut pas contenir d’espaces.
  6. Vous pouvez également sélectionner Autoriser les acteurs du référentiel à définir cette propriété. Lorsque cette option est activée, les utilisateurs du référentiel et les applications disposant de l’autorisation à granularité fine custom properties au niveau du référentiel pourront définir et mettre à jour la valeur de la propriété pour leur référentiel. De plus, tout acteur créant un référentiel peut définir la propriété sur le référentiel.
  7. Vous pouvez également sélectionner Exiger cette propriété pour tous les référentiels et ajouter une valeur par défaut. Cela signifie que vous exigez que tous les référentiels de votre entreprise aient une valeur pour cette propriété. Les référentiels qui n’ont pas de valeur explicite pour cette propriété héritent de la valeur par défaut.
  8. Cliquez sur Enregistrer la propriété.

Promotion des propriétés de l’organisation aux propriétés d’entreprise

Vous pouvez promouvoir une propriété d’une organisation vers votre compte d’entreprise, afin de vous assurer que le nom et les valeurs de la propriété sont disponibles pour être utilisés dans toutes les organisations de l’entreprise.

  1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil.
  2. En fonction de votre environnement, cliquez sur Votre entreprise ou sur Vos entreprises, puis cliquez sur l'entreprise que vous souhaitez consulter.
  3. Dans la barre latérale gauche, dans « Stratégies », cliquez sur Propriétés personnalisées.
  4. Pour afficher toutes les propriétés gérées par les organisations, sélectionnez Filtrer, puis choisissez le qualificateur Géré par et organisation comme valeur, ou entrez managed-by:organization dans la barre de filtre.
  5. Si vous le souhaitez, pour afficher les propriétés gérées par une organisation spécifique, sélectionnez Filtrer et choisissez le qualificateur Organization et un nom d’organisation comme valeur, ou entrez org:<ORGANIZATION-NAME> dans la barre de filtres.
  6. Dans la liste des propriétés, sélectionnez le nom de la propriété que vous souhaitez promouvoir. Vous accédez à la page des détails de la propriété.
  7. Pour promouvoir la propriété sélectionnée, cliquez sur Promouvoir vers l’entreprise. Le nom de la propriété doit être unique dans toutes les organisations de l’entreprise, sinon la promotion ne sera pas autorisée.
  8. Cliquez sur Promouvoir.