Administración de propiedades personalizadas para repositorios de la organización

Acerca de las propiedades personalizadas

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 organización puede tener hasta 100 definiciones de propiedades. Una lista de valores permitidos puede tener hasta 200 elementos.

Puedes usar las propiedades del repositorio para determinar qué repositorios deben tener como destino un conjunto de reglas. Para más información, consulta Creación de conjuntos de reglas para repositorios de la organización.

Puedes definir propiedades personalizadas a nivel de empresa para crear una experiencia coherente en todas las organizaciones. Consulta Administración de propiedades personalizadas para repositorios de 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 ".

Adición de propiedades personalizadas

Puedes añadir propiedades personalizadas a la organización y configurar valores en esas propiedades para los repositorios de la organización.

También puedes usar la API de REST para crear y administrar organizaciones. Para más información, consulta Puntos de conexión de la API de REST para propiedades personalizadas

1. En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.

2. Junto a la organización, haga clic en Settings.

3. En la barra lateral izquierda, en la sección «Código, planeamiento y automatización», haz clic en Repositorio y, luego, haz clic en Propiedades personalizadas.

   

4. Para agregar una nueva propiedad personalizada, haz clic en Nueva propiedad en la esquina superior derecha.

5. En el campo «Nombre», escribe el nombre que quieras usar para la propiedad personalizada. El nombre no puede contener espacios.

6. De manera opcional, en el campo «Descripción», escribe una descripción de la propiedad personalizada.

7. En «Tipo», selecciona el tipo de propiedad que deseas añadir. Puede ser una cadena de texto, un solo campo de selección o un campo de selección múltiple o un valor booleano de verdadero o falso.

8. Opcionalmente, puedes seleccionar Permitir que los actores del repositorio establezcan esta propiedad. Cuando se habilita, los usuarios del repositorio y las aplicaciones con el permiso específico de "propiedades personalizadas" de nivel de repositorio podrán establecer y actualizar el valor de la propiedad para su repositorio.

9. De manera opcional, puedes seleccionar Requerir esta propiedad para todos los repositorios y agregar un valor predeterminado. Esto significa que es obligatorio que todos los repositorios de la organización tengan un valor para esta propiedad. Los repositorios que no tienen un valor explícito para esta propiedad heredarán el valor predeterminado.

10. Haz clic en Guardar propiedad.

Configurar valores para los repositorios de tu organización

Usted, y cualquier usuario con el permiso "Editar valores de propiedades personalizadas en el nivel de organización", puede establecer valores para propiedades personalizadas para repositorios de su organización.

1. En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.

2. Junto a la organización, haga clic en Settings.

3. En la barra lateral izquierda, en la sección «Código, planeamiento y automatización», haz clic en Repositorio y, luego, haz clic en Propiedades personalizadas.

   

4. Haz clic en la pestaña «Establecer valores».

5. Selecciona uno o más repositorios de la lista y haz clic en Editar propiedades.

   

6. En el cuadro de diálogo modal que aparece, selecciona un valor para cada propiedad que quieras establecer para los repositorios seleccionados.

7. Haga clic en Guardar cambios.

Visualizar los valores para los repositorios en tu organización

Las personas con permisos de lectura para un repositorio pueden ver los valores de las propiedades personalizadas de ese repositorio, pero no pueden editar dichos valores.

También puedes usar la API de REST para enumerar las propiedades personalizadas asignadas a un repositorio por la organización. Para más información, consulta Puntos de conexión de la API de REST para propiedades personalizadas

1. En GitHub, navegue hasta la página principal del repositorio.

2. En el nombre del repositorio, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

3. En la sección "Code and automation" de la barra lateral, haz clic en Custom properties.

Búsqueda y filtrado de repositorios por valores de propiedades personalizadas

Puedes buscar repositorios en la organización mediante valores de propiedades personalizadas.

1. En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.
2. Haz clic en el nombre de tu organización.
3. En el nombre de la organización, haz clic en Repositorios.
4. En la barra de búsqueda, escribe prop para ver una lista de todas las propiedades personalizadas de la organización y selecciona la propiedad que deseas buscar.