Nota:
Las directivas de repositorio se encuentran actualmente en versión preliminar pública y están sujetas a cambios. Puedes tener hasta 75 conjuntos de reglas y directivas totales por organización y hasta 75 directivas y conjuntos de reglas totales por empresa.
Para controlar los eventos clave en el ciclo de vida de los repositorios, como quién puede crear o eliminar repositorios, puedes crear una directiva de repositorio. Una directiva de repositorio es una colección de restricciones que proporcionan un control flexible sobre qué usuarios se ven afectados y qué repositorios están incluidos.
En una directiva de repositorio, puedes restringir:
- Qué visibilidades se permiten para los nuevos repositorios y los cambios de visibilidad.
- Quién puede crear repositorios.
- Quién puede eliminar repositorios.
- Quién puede transferir repositorios fuera de una organización.
- Cómo las personas pueden asignar un nombre a los repositorios.
Examples
Puedes usar una directiva de repositorio para hacer cosas como:
- Asegurarte de que todos los repositorios nuevos usen una determinada convención de nomenclatura, como
kebab-case. - Impedir eliminaciones del repositorio excepto las de los administradores de la organización.
- Permitir que los repositorios públicos se creen solo en la organización de "código abierto" de tu empresa.
- Evitar que los repositorios públicos se cambien a privados para evitar la posible pérdida de metadatos.
Creación de una directiva de repositorio
- Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
- En la parte superior de la página, haz clic en Policies.
- En "Policies", haz clic en Repository.
- Haga clic en Nueva directiva.
- Configure la nueva directiva y haga clic en Crear. Para obtener ayuda, consulte las siguientes subsecciones.
Nombre de la política
Use algo descriptivo para comunicar el propósito de la directiva. Los propietarios de la organización pueden ver la directiva, así que unos nombres adecuados aportan una mayor claridad. Por ejemplo: Prevent public repos on production.
Estado de aplicación
Si no deseas que se aplique la directiva cuando se cree, establécela en "Disabled". De lo contrario, establécela en "Active".
Lista de permitidos
Elige qué roles pueden omitir las restricciones de esta directiva.
Targets
Elija a qué organizaciones y repositorios se aplica la directiva.
Organizaciones de destino
Seleccione todas las organizaciones, elija una selección de organizaciones existentes o establezca una lista dinámica por nombre. Si usa Enterprise Managed Users, también puede elegir dirigirse a todos los repositorios que pertenezcan a usuarios de su empresa.
Si establece una lista dinámica, agregará uno o varios patrones de nomenclatura mediante la sintaxis fnmatch. Por ejemplo, la cadena *open-source coincidiría con cualquier organización con un nombre que termine con open-source. Para obtener más información sobre la sintaxis, consulte Creación de conjuntos de reglas de un repositorio.
Repositorios de destino
Elija los repositorios (actuales o futuros) a los que dirigirse en las organizaciones seleccionadas. Puede seleccionar todos los repositorios o establecer una lista dinámica por propiedad personalizada.
Policies
Elige qué restricciones se incluyen. Cuando la directiva está activa, las restricciones se aplican en todos los repositorios de destino, pero los usuarios o equipos pueden omitirlas en la lista de permitidas.
Si eliges la directiva "Restrict names", debes usar la sintaxis de expresiones regulares para establecer un patrón con el que los nombres de repositorio deben o no coincidir. Por ejemplo, un patrón para aplicar la nomenclatura kebab-case tendría un aspecto similar a ^([a-z][a-z0-9]*)(-[a-z0-9]+)*$.
- Los patrones admiten la sintaxis RE2. Consulta la guía de sintaxis de Google.
- Para validar las expresiones, haz clic en Test pattern y escribe un patrón y un valor de prueba.
Delegación de omisión de directivas
Nota:
La omisión delegada de directiva de repositorio está en versión preliminar pública y sujeta a cambios.
La omisión delegada para las directivas de repositorio te permite controlar quién puede omitir las directivas de repositorio para las eliminaciones del repositorio y los cambios de visibilidad.
Con la omisión delegada, los administradores del repositorio deben enviar una solicitud para cambiar la visibilidad del repositorio o eliminar el repositorio. La solicitud se envía a un grupo designado de revisores, que aprueban o deniegan la solicitud para omitir las directivas de repositorio.
Si se aprueba la solicitud para omitir las directivas de repositorio, el cambio de solicitud se completa inmediatamente. Si se deniega la solicitud, no se realizará el cambio solicitado, pero se podrá volver a solicitar.
Para configurar la omisión delegada, los propietarios de la empresa o los propietarios de la organización crean primero una "lista de omisión". La lista de omisión incluye roles y equipos específicos, como administradores de equipos o repositorios, que supervisan las solicitudes para omitir las directivas de repositorio.
Pasos siguientes
Cree conjuntos de reglas para controlar de forma coherente las ramas importantes en los repositorios de la empresa. Consulta Protección de las ramas en el entorno empresarial mediante conjuntos de reglas.