Note
Las propiedades personalizadas de la empresa se encuentran en versión preliminar pública y están sujetas a cambios.
Las propiedades personalizadas te permiten añadir a los repositorios marcos de cumplimiento, información sobre la confidencialidad de los datos o detalles del proyecto. Las propiedades personalizadas son privadas y solo las pueden ver las personas con permisos de lectura del repositorio. Una empresa puede tener hasta 100 definiciones de propiedades. Una lista de valores permitidos puede tener hasta 200 elementos.
La definición de propiedades personalizadas a nivel de empresa te permite crear valores coherentes que los usuarios pueden aplicar a los repositorios. Con las propiedades personalizadas implementadas, puedes aplicar una gobernanza coherente entre los repositorios de la empresa creando un conjunto de reglas o una directiva de repositorio en los que se incluyan repositorios con determinadas propiedades. Consulta Determinación de cómo las personas usan los repositorios en la empresa.
Caracteres permitidos
Los nombres y valores de propiedades personalizados solo pueden contener determinados caracteres:
- Nombres:
a-z
,A-Z
,0-9
,_
,-
,$
,#
. - Valores: todos los caracteres ASCII imprimibles excepto
"
.
¿Quién puede establecer y ver valores de las propiedades personalizadas que se definan?
Después de definir una propiedad personalizada, los usuarios pueden establecer un valor para esa propiedad en los repositorios de la empresa. Consulta Administración de propiedades personalizadas para repositorios de la organización.
- Como propietario de la empresa, puedes establecer un valor predeterminado para las propiedades obligatorias.
- Los propietarios de la organización pueden establecer valores en su organización, ya sea en todos los repositorios o a nivel de repositorio.
- Si se habilita, los usuarios con acceso al repositorio o con el permiso específico
custom properties
pueden establecer y actualizar el valor de la propiedad de su repositorio.
Los usuarios con permisos de lectura en un repositorio pueden ver los valores de propiedad personalizados de ese repositorio.
Además, los propietarios de la organización pueden buscar repositorios en su organización por valores de propiedad personalizados. Consulta Administración de propiedades personalizadas para repositorios de la organización.
Adición de propiedades personalizadas
Puedes agregar propiedades personalizadas a tu empresa para que esas propiedades estén disponibles en todas las organizaciones.
- En la esquina superior derecha de GitHub, haz clic en la fotografía del perfil.
- En función de tu entorno, haz clic en Your enterpriseo en Your enterprises y, a continuación, haz clic en la empresa que deseas ver.
- En la barra lateral izquierda, en "Policies", haz clic en Custom properties.
- Para agregar una nueva propiedad personalizada, haz clic en New property en la esquina superior derecha.
- Escribe un nombre, una descripción y un tipo para la propiedad personalizada. El nombre debe ser único entre todas las organizaciones y no puede contener espacios.
- Opcionalmente, puedes seleccionar Allow repository actors to set this property. Cuando se habilita, los usuarios del repositorio y las aplicaciones con el permiso específico
custom properties
de nivel de repositorio podrán establecer y actualizar el valor de la propiedad para su repositorio. Además, cualquier actor que cree un repositorio puede establecer la propiedad en el repositorio. - De manera opcional, selecciona Require this property for all repositories y agrega un valor predeterminado. Esto significa que es obligatorio que todos los repositorios de la empresa tengan un valor para esta propiedad. Los repositorios que no tienen un valor explícito para esta propiedad heredarán el valor predeterminado.
- Haz clic en Guardar propiedad.
Promoción de las propiedades de la organización a propiedades empresariales
Puedes promover una propiedad de una organización a su cuenta empresarial para asegurarse de que el nombre y los valores de propiedad estén disponibles para su uso en todas las organizaciones de la empresa.
- En la esquina superior derecha de GitHub, haz clic en la fotografía del perfil.
- En función de tu entorno, haz clic en Your enterpriseo en Your enterprises y, a continuación, haz clic en la empresa que deseas ver.
- En la barra lateral izquierda, en "Policies", haz clic en Custom properties.
- Para ver todas las propiedades administradas por organizaciones, seleccione Filtro y elija el calificador Administrado por y organización como valor o escriba
managed-by:organization
en la barra de filtros. - Opcionalmente, para ver todas las propiedades administradas por organizaciones, seleccione Filtro y elija el calificador Organización y el nombre de la organización como valor o escribe
org:<ORGANIZATION-NAME>
en la barra de filtros. - En la lista de propiedades, selecciona el nombre de propiedad que desea promover. Esto te lleva a la página de detalles de la propiedad.
- Para promover la propiedad seleccionada, haga clic en Promover a la empresa. El nombre de propiedad debe ser único en todas las organizaciones de la empresa; de lo contrario, no se permitirá la promoción.
- Haga clic en Promote (Promover).