¿Qué son las propiedades personalizadas?
Las propiedades personalizadas son campos de metadatos estructurados que puede adjuntar a repositorios u organizaciones en GitHub.com. Permiten decorar los repositorios u organizaciones con información como marcos de cumplimiento, confidencialidad de datos o detalles del proyecto.
Hay dos tipos de propiedades personalizadas:
- Propiedades personalizadas del repositorio: metadatos adjuntos a repositorios individuales.
- Propiedades personalizadas de la organización: metadatos adjuntos a organizaciones dentro de una empresa.
¿Cuáles son las ventajas de usar propiedades personalizadas?
Además de proporcionar una detección mejorada, flujos de trabajo automatizados, seguimiento de cumplimiento, aplicación de directivas dirigidas y mejores funcionalidades de informes, las propiedades personalizadas permiten una gobernanza eficaz a través de la integración del conjunto de reglas.
Tanto las propiedades personalizadas del repositorio como de la organización se pueden usar como criterios de destino para los conjuntos de reglas, lo que permite aplicar directivas específicas en función de los metadatos.
- Para conocer las reglas personalizadas del repositorio, consulte Creación de conjuntos de reglas para repositorios de la organización y Administración de propiedades personalizadas para repositorios de tu empresa.
- Para conocer las reglas personalizadas de la organización, consulte Administración de conjuntos de reglas de código para repositorios en tu empresa.
¿Cómo puedo agregar y administrar propiedades personalizadas?
Hay varias maneras de administrar propiedades personalizadas. Para gestionar las propiedades dentro de GitHub, puede usar:
- La organización o la configuración de la empresa. Consulta Administración de propiedades personalizadas para repositorios de la organización y Gestión de propiedades personalizadas para organizaciones.
- Puntos de conexión de la API de REST para propiedades personalizadas de GitHub.
También puede configurar una integración para actualizar automáticamente las propiedades personalizadas con metadatos de un sistema externo, como un catálogo de software o un portal para desarrolladores interno. Las propiedades externas se pueden usar en los mismos lugares que las propiedades personalizadas del repositorio estándar. Consulta Integración de propiedades personalizadas con un sistema externo
Tanto las propiedades personalizadas estándar como las propiedades externas se pueden administrar a gran escala con la API REST y GitHub Apps. Las propiedades externas son más adecuadas cuando el sistema externo debe ser la fuente de verdad, porque son:
- Con espacio de nombres (
external_system.property_name), por lo que su procedencia queda clara y no entren en conflicto con otras propiedades personalizadas de la organización. - De solo lectura en GitHub, por lo que los usuarios no pueden editarlos ni hacer que dejen de estar sincronizados con el sistema externo.
Las propiedades externas no están disponibles para las propiedades personalizadas de la organización (metadatos adjuntos a las organizaciones).