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

Acerca de las propiedades personalizadas

Las propiedades personalizadas son campos de metadatos estructurados que puede agregar a repositorios y organizaciones en GitHub para permitir una mejor organización, gobernanza y automatización en todo el entorno.

En este artículo se relaciona con las propiedades personalizadas del repositorio.

La visibilidad de las propiedades personalizadas coincide con la visibilidad del repositorio. Cualquiera puede ver las propiedades personalizadas en repositorios públicos, mientras que las cuentas con read permisos para el repositorio pueden ver propiedades personalizadas en repositorios internos o privados.

Acerca de las sugerencias de propiedades personalizadas

Al crear una propiedad de selección única o selección múltiple, Copilot puede sugerir valores permitidos para la definición de la propiedad. Seleccione una sugerencia para agregarla a la lista de valores permitidos.

Esta característica está disponible con Copilot Business o Copilot Enterprise. Los propietarios de la organización pueden configurar la disponibilidad con la directiva de sugerencias de propiedades personalizadas del repositorio . Consulte Administración de directivas y características para GitHub Copilot en su organización.

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 "

Sincronización de propiedades personalizadas con un sistema externo

Puede escribir automáticamente metadatos desde un sistema externo, como un catálogo de software o un portal para desarrolladores interno, a las propiedades personalizadas del repositorio en GitHub. Esto hace que el sistema externo sea el origen de estas propiedades y le ayuda a mantener el contexto empresarial, como la propiedad, el nivel de servicio o el estado de cumplimiento actualizados en los repositorios. Las propiedades externas se pueden usar en los mismos lugares que las propiedades personalizadas que se administran en GitHub.

Para obtener instrucciones de configuración, consulta Integración de propiedades personalizadas con un sistema externo.

Adición de propiedades personalizadas en GitHub

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

1. En la esquina superior derecha de GitHub, haz clic en la foto del perfil y luego en Your organizations.

2. Seleccione una organización haciendo clic en ella.

3. Debajo del nombre de la organización, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

4. En la barra lateral, en "Código, planeamiento y automatización", Haga clic en Repositorio y, a continuación, en Propiedades personalizadas.

   

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

6. En el campo «Nombre», escribe el nombre que quieras usar para la propiedad personalizada. El nombre no puede contener espacios y no puede superar los 75 caracteres de longitud.

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

8. En «Tipo», selecciona el tipo de propiedad que deseas añadir. Puede ser una cadena de texto, un único campo de selección, un campo de selección múltiple, o un valor booleano true/false.

   Si seleccionó un tipo de selección único o de selección múltiple, Copilot puede sugerir valores permitidos para la definición de propiedad. Seleccione Aceptar sugerencia para agregarla a la lista de valores permitidos.

9. 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.

10. 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.

    • 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.

11. Haz clic en Guardar propiedad.

Configurar valores para los repositorios de tu organización

Usted "Editar valores de propiedades personalizados 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, haz clic en la foto del perfil y luego en Your organizations.

2. Seleccione una organización haciendo clic en ella.

3. Debajo del nombre de la organización, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

4. En la barra lateral, en "Código, planeamiento y automatización", Haga clic en Repositorio y, a continuación, en Propiedades personalizadas.

   

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

6. Seleccione uno o varios repositorios de la lista y haga clic en Editar propiedades.

   

7. En el cuadro de diálogo modal que aparece, selecciona un valor para cada propiedad que quieras establecer para los repositorios seleccionados. Este valor no puede superar los 75 caracteres de longitud.

8. 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.

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

2. Debajo del nombre del repositorio, haz clic en Settings. 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 "Código y automatización" de la barra lateral, haga clic en Propiedades personalizadas.

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, haz clic en la foto del perfil y luego en Your organizations.
2. Haz clic en el nombre de tu organización.
3. En el nombre de la organización, haga 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.