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.
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 detallado
custom propertiespueden 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
Puede agregar propiedades personalizadas a su empresa para que esas propiedades estén disponibles en todas las organizaciones.
-
Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
-
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 en todas las organizaciones, no puede contener espacios y no puede superar los 75 caracteres de longitud.
-
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 a nivel de repositorio
custom propertiespodrán establecer y actualizar el valor de la propiedad de 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 en tu empresa tengan un valor para esta propiedad. Los repositorios que no tienen un valor explícito para esta propiedad heredarán el valor predeterminado.
- Opcionalmente, puede seleccionar Requerir valores explícitos especificados por el usuario. Cuando esta opción está habilitada, los usuarios y las aplicaciones con permiso para establecer valores de propiedad deben proporcionar un valor explícito al establecer propiedades, crear repositorios o transferir repositorios. Los repositorios que aún no tienen un valor explícito seguirán heredando el valor predeterminado.
-
Haz clic en Guardar propiedad.
Pasos siguientes
Aplicar directivas a repositorios en función de sus propiedades personalizadas. Consulta Definición de directivas para repositorios en la empresa.