Compartir a través de


Establecer configuración y directivas del repositorio de Git

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Hay varias maneras de personalizar los repositorios de Git de Azure Repos mediante el uso de configuraciones y directivas de rama y repositorio. En este artículo se describen configuraciones y directivas de nivel de repositorio.

  • Las configuraciones y directivas del repositorio establecen opciones globales para todos los repositorios de Git de un proyecto u organización, o bien para repositorios individuales.

    En este artículo se describen configuraciones y directivas del repositorio del lado servidor. Para obtener información sobre las preferencias de Git del lado cliente, consulte Preferencias y configuraciones de Git en Visual Studio.

  • Las directivas de rama abarcan controles específicos de la rama.

    Las directivas de rama incluyen opciones como requerir una PR, una compilación correcta o una revisión del código antes de que los cambios se puedan fusionar mediante combinación en una rama. Para obtener más información, consulte Directivas y configuraciones de rama.

  • Los permisos de seguridad de repositorio y rama controlan las asignaciones de usuarios.

    Estos permisos controlan quién puede leer, escribir, contribuir a las PR y realizar otras acciones específicas. Para obtener más información, consulte Establecimiento de permisos para un repositorio.

Resumen de todas las configuraciones y directivas de repositorio y rama

Puede establecer configuraciones y directivas para todos los repositorios de un proyecto, para repositorios individuales y para ramas de repositorios. Configurará todas estas opciones y directivas en el explorador a través deConfiguración del proyecto>Repositorios.

Nota

Puede establecer varias configuraciones y directivas de rama con la CLI de Azure mediante az repos policy.

En las tablas siguientes se resumen las configuraciones y directivas que puede habilitar y configurar para repositorios y ramas de Git.

Configuraciones de todos los repositorios

En la tabla siguiente se resumen las configuraciones que puede habilitar y establecer para todos los repositorios de Git nuevos de un proyecto o una organización.

Configuración

Valor predeterminado

Descripción


Desactivado

Inicialice los repositorios nuevos con el nombre de rama predeterminado que especifique. Puede cambiar la rama predeterminada de un repositorio concreto en cualquier momento. Si no habilita esta característica, los repositorios se inicializan con una rama predeterminada denominada main.

Activado

Permite que los usuarios administren los permisos para las ramas que creen en todos los repositorios nuevos.

Configuración del repositorio

En la tabla siguiente se resumen las configuraciones que se pueden habilitar o establecer para cada repositorio de Git individual.

Configuración

Valor predeterminado

Descripción


Activado

Permite que los usuarios creen bifurcaciones de este repositorio.

Activado

Crea vínculos automáticamente para los elementos de trabajo mencionados en un comentario de confirmación.

Activado

Permite menciones en comentarios de confirmación para cerrar los elementos de trabajo. Requiere la actualización 2020.1 de Azure DevOps Server o una versión posterior.

Activado

Recuerda las preferencias de usuario para completar elementos de trabajo con PR.

Activado

Permite que los usuarios administren permisos para las ramas que han creado.

Activado

Habilita el modo de voto estricto para el repositorio, que requiere permiso de Colaboración para votar en las PR.

Activado

Deshabilita el acceso al repositorio, incluidas las compilaciones y las PR, pero el repositorio sigue siendo detectable con una advertencia.

Activado

Especifica hasta cinco ramas más para participar en la búsqueda de código, que de forma predeterminada solo se aplica a la rama predeterminada. Requiere que la extensión de Code Search esté instalada y habilitada.

Directivas u opciones del repositorio

En la tabla siguiente se resumen las directivas u opciones que se pueden establecer para todos los repositorios o para repositorios individuales. Las directivas establecidas para Todos los repositorios establecen el valor predeterminado para los repositorios individuales que se agreguen en una fecha posterior.

Directiva u opción

Valor predeterminado

Descripción


Desactivado

Bloquea el envío de cambios con un correo electrónico del autor de la confirmación que no coincida con los patrones especificados. Esta configuración requiere Azure DevOps Server 2020.1 o una versión posterior.

Desactivado

Impide que los envíos de cambios introduzcan rutas de acceso de archivo que coincidan con los patrones especificados. Esta configuración requiere Azure DevOps Server 2020.1 o una versión posterior.

Desactivado

Evita los conflictos de distinción de mayúsculas y minúsculas y bloquea los envíos de cambios que las cambian en el nombre de archivos, carpetas, ramas y etiquetas.

Desactivado

Bloquea los envíos de cambios que introducen nombres de archivos, carpetas o ramas que incluyen nombres reservados para la plataforma o caracteres no compatibles.

Desactivado

Bloquea los envíos de cambios que introducen rutas de acceso que superan la longitud especificada.

Desactivado

Bloquea los envíos de cambios que contienen archivos nuevos o actualizados superiores al límite seleccionado.

Directivas de rama

En la tabla siguiente se resumen las directivas que se pueden definir para personalizar una rama. Para obtener más información sobre cómo configurar estas opciones, consulte Mejora de la calidad del código con directivas de rama. Al establecer cualquier directiva en una rama, se aplican automáticamente las directivas siguientes:

  • Se requieren PR para actualizar la rama.
  • No se puede eliminar la rama.

Nota:

Las directivas de rama se aplican a las solicitudes de incorporación de cambios en función de la rama de destino de la solicitud de incorporación de cambios. Las directivas de rama no deben establecerse en ramas temporales que se eliminarán después de una solicitud de incorporación de cambios. La adición de directivas de rama a ramas temporales provocará un error en la eliminación automática de la rama.

Directiva

Valor predeterminado

Descripción


Desactivado

Sirve para requerir la aprobación de un número especificado de revisores en las solicitudes de incorporación de cambios.

Desactivado

Fomenta la rastreabilidad mediante la comprobación de los elementos de trabajo vinculados en las PR.

Desactivado

Comprueba si todos los comentarios de las PR se han resuelto.

Desactivado

Limita los tipos de fusión mediante combinación disponibles al completarse las PR para controlar el historial de ramas.

Desactivado

Agrega, habilita o deshabilita una o varias directivas para validar el código mediante la fusión mediante combinación previa y la creación de cambios en la PR.

Desactivado

Agrega, habilita o deshabilita una o varias directivas para requerir que otros servicios publiquen el estado correcto para completar las PR.

Desactivado

Agrega, habilita o deshabilita una o varias directivas para designar a los revisores de código que se incluirán automáticamente cuando las PR cambien determinadas áreas del código.

Prerrequisitos

  • Para configurar las directivas, hay que ser miembro del grupo de seguridad Administradores del proyecto o tener permisos de tipo Editar directivas de nivel de repositorio. Para obtener más información, consulte Establecimiento de permisos de repositorios Git.
  • Para configurar las directivas, hay que ser miembro del grupo de seguridad Administradores del proyecto o tener permisos de tipo Editar directivas de nivel de repositorio. Para obtener más información, consulte Establecimiento de permisos de repositorios Git.

Visualización y edición de las configuraciones y directivas

Puede establecer configuraciones para todos los repositorios de una organización o proyecto, o bien para repositorios individuales. Puede configurar directivas para todos los repositorios, para repositorios individuales o para ramas específicas de repositorios. Para obtener información sobre cómo establecer directivas de rama, consulte Directivas de rama.

Nota

Es mejor establecer las configuraciones del repositorio en el nivel de proyecto o en repositorios individuales, pero no en ambos. Si establece las configuraciones en más de un nivel, el sistema respeta la configuración más restrictiva. El establecimiento de las configuraciones en un solo nivel reduce la confusión y los problemas de rendimiento de Git.

Para establecer las configuraciones y directivas del repositorio a través del portal web, abra Configuración del proyecto>Repositorios en el explorador web.

  1. Para ver o modificar las configuraciones o directivas de todos los repositorios de Git, abra la página Todos los repositorios y seleccione Configuración o Directivas.

    Captura de pantalla en la que se muestran las configuraciones para todos los repositorios.

    Para establecer las configuraciones y directivas de un repositorio específico, seleccione la pestaña Repositorios , elija el repositorio y seleccione la pestaña Configuración o Directivas.

    Captura de pantalla en la que se muestran las configuraciones para el repositorio de Fabrikam.

  2. En la captura de pantalla siguiente se muestra la pestaña Configuración seleccionada. Puede definir estas configuraciones para todos los repositorios de Git o para un repositorio individual.

    Captura de pantalla en la que se muestra la pestaña Configuración del proyecto del repositorio seleccionada.

  3. En la captura de pantalla siguiente se muestra la pestaña Directivas seleccionada. Puede definir estas directivas para todos los repositorios de Git o para un repositorio individual.

    Captura de pantalla en la que se muestra la pestaña Directivas del repositorio seleccionada.

  1. En el explorador web, abra el proyecto, seleccione Configuración del proyecto, Repositorios y elija el repositorio.

    Captura de pantalla de la Configuración del proyecto del repositorio.

  2. Para ver y configurar las configuraciones del repositorio, seleccione Opciones o Directivas.

    En la captura de pantalla siguiente se muestran las opciones de todos los repositorios:

    Captura de pantalla de las opciones de todos los repositorios.

    En la captura de pantalla siguiente se muestran las opciones de los repositorios de Fabrikam:

    Captura de pantalla de opciones del repositorio de Fabrikam.

Nombre de rama predeterminado

Puede establecer un nombre de rama de repositorio predeterminado en el nivel de organización o proyecto. La configuración de nivel de organización surte efecto para todos los repositorios nuevos de todos los proyectos de la organización. La configuración de nivel de proyecto afecta a todos los repositorios nuevos de un proyecto y reemplaza cualquier nombre establecido en el nivel de organización.

Puede:

  • Elegir cualquier nombre de rama legal para usarlo cuando se inicialice un repositorio.
  • Cambiar el nombre predeterminado en cualquier momento para que afecte a todos los repositorios futuros.
  • Cambiar el nombre de rama predeterminado de un repositorio concreto en cualquier momento.

Si no habilita la característica de nombre de rama predeterminado, los repositorios se inicializan con el nombre de rama predeterminado de Azure Repos main.

Para establecer un nombre de rama predeterminado en el nivel de organización:

  1. En la página de la organización de Azure DevOps, seleccione Configuración de la organización en la parte inferior izquierda y, después, Repositorios en el panel de navegación de la izquierda.
  2. En la página Todos los repositorios, establezca Default branch name for new repositories (Nombre de rama predeterminado de los nuevos repositorios) en Activado y escriba un nombre de rama predeterminado.

Captura de pantalla en la que se muestra la configuración de nivel de organización para el nombre de rama predeterminado de los nuevos repositorios.

Para establecer un nombre de rama predeterminado en el nivel de proyecto:

  1. En la página del proyecto de Azure DevOps, seleccione Configuración del proyecto en la parte inferior izquierda y, después, Repositorios en el panel de navegación de la izquierda.
  2. En la pestaña Configuración de la página Todos los repositorios, establezca Default branch name for new repositories (Nombre de rama predeterminado de los nuevos repositorios) en Activado y escriba un nombre de rama predeterminado.

Captura de pantalla en la que se muestra la configuración de nivel de proyecto para el nombre de rama predeterminado de los nuevos repositorios.

Nota

La configuración Default branch name for new repositories (Nombre de rama predeterminado de los nuevos repositorios) requiere Azure DevOps Server 2020.1 o una versión posterior.

Administración de permisos de rama

Es posible controlar quién puede administrar los permisos de las ramas del repositorio. Para ello, establezca una configuración de administración de permisos para todos los repositorios de Git o para repositorios individuales. Si habilita la opción Allow users to manage permissions for their created branches (Permitir que los usuarios administren los permisos de sus ramas creadas) en el nivel Todos los repositorios, todos los repositorios de proyectos nuevos se configuran de modo que permitan que los usuarios administren los permisos de sus ramas creadas.

Para administrar esta configuración:

  1. En la página del proyecto de Azure DevOps, seleccione Configuración del proyecto en la parte inferior izquierda y, después, Repositorios en el panel de navegación de la izquierda.
  2. En la pestaña Configuración de la página Todos los repositorios, establezca Allow users to manage permissions for their created branches (Permitir que los usuarios administren los permisos de sus ramas creadas) en Activado o Desactivado.

Captura de pantalla en la que se muestra la configuración Allow users to manage permissions for their created branches (Permitir que los usuarios administren los permisos de sus ramas creadas) de nivel de proyecto.

Para habilitar o deshabilitar esta configuración para repositorios individuales:

  1. Seleccione Configuración del proyecto>Repositorios y elija un repositorio.
  2. En la pestaña Configuración de la página <Nombre del repositorio>, establezca Permissions management (Administración de permisos) en Activado o Desactivado.

Captura de pantalla en la que se muestra la configuración del repositorio Permissions management (Administración de permisos).

Imágenes de Gravatar

Esta configuración habilita o deshabilita el uso de imágenes de Gravatar para los usuarios de fuera de la empresa.

Imágenes de Gravatar es una configuración de nivel de organización.

  1. En la página de la organización de Azure DevOps, seleccione Configuración de la organización en la parte inferior izquierda y, después, Repositorios en el panel de navegación de la izquierda.
  2. En la página Todos los repositorios, establezca Imágenes de Gravatar en Activado o Desactivado.

Captura de pantalla en la que se muestra la configuración de nivel de organización para Imágenes de Gravatar.

Imágenes de Gravatar es una configuración de nivel de proyecto para Todos los repositorios.

  1. En la página del proyecto de Azure DevOps, seleccione Configuración del proyecto en la parte inferior izquierda y, después, Repositorios en el panel de navegación de la izquierda.
  2. En la pestaña Configuración de la página Todos los repositorios, establezca Imágenes de Gravatar en Activado o Desactivado.

Imágenes de Gravatar es una configuración de nivel de proyecto para Todos los repositorios.

  1. En la página del proyecto de Azure DevOps, seleccione Configuración del proyecto en la parte inferior izquierda y, después, Repositorios en el panel de navegación de la izquierda.
  2. En la pestaña Configuración de la página Todos los repositorios, establezca Imágenes de Gravatar en Activado o Desactivado.

Habilitación de bifurcaciones

Esta configuración del repositorio controla si los usuarios pueden crear bifurcaciones del lado servidor. Si se deshabilita esta configuración, no se quitan las bifurcaciones existentes.

  1. En Configuración del proyecto, seleccione Repositorios en el panel de navegación de la izquierda.
  2. En la pestaña Repositorios de la página Todos los repositorios, seleccione un repositorio.
  3. En la pestaña Configuración de la página <Nombre del repositorio>, establezca Bifurcaciones en Activado o Desactivado.

Captura de pantalla en la que se muestra la configuración del repositorio Bifurcaciones.

Configuración de vinculación de elementos de trabajo

Esta configuración del repositorio administra la vinculación de elementos de trabajo.

  1. Seleccione Configuración del proyecto>Repositorios y elija un repositorio.
  2. En la pestaña Configuración de la página <Nombre del repositorio>, establezca la configuración en Activado o Desactivado.

Captura de pantalla en la que se muestra la configuración del repositorio de vinculación de elementos de trabajo.

Confirmar vinculación de mención

Cuando se habilita, los mensajes de confirmación que contienen # seguidos de un identificador de elemento de trabajo válido vinculan automáticamente la confirmación a ese elemento de trabajo. Deshabilite esta configuración si el repositorio usó previamente una cuenta o servicio diferente. Esos repositorios podrían tener mensajes de confirmación con menciones # que no coinciden con los identificadores de elemento de trabajo de la cuenta actual.

Confirmar resolución de elemento de trabajo de mención

Habilite esta configuración para finalizar automáticamente los elementos de trabajo cuando se completen las PR vinculadas. Esta configuración también permite especificar otros estados de transición de elementos de trabajo en los mensajes de confirmación de PR. Para obtener más información, consulte Automatización de la finalización de elementos de trabajo con PR.

Confirmar resolución de elemento de trabajo de mención

Habilite esta opción para finalizar de forma automática los elementos de trabajo cuando se complete correctamente la PR. Para obtener más información, consulte Automatización de la finalización de elementos de trabajo con PR.

Preferencias de transición de elementos de trabajo

De forma predeterminada, la opción para finalizar los elementos de trabajo vinculados cuando se completa una PR recuerda la última opción de cada usuario. Los equipos que quieren impedir que los usuarios completen los elementos de trabajo con sus PR pueden deshabilitar esta configuración. A partir de entonces, los usuarios deberán optar por finalizar los elementos de trabajo cada vez que completen una PR.

Configuración del modo de voto estricto

En determinadas situaciones, los usuarios que no son colaboradores de un repositorio pueden enviar una PR y hacer que se fusione mediante combinación, según las directivas. Para impedirlo, habilite el modo de voto estricto para cambiar el permiso necesario para votar en las PR del repositorio a Colaborar. Se recomienda habilitar esta configuración si confía en bifurcaciones de usuario en Azure Repos.

  1. Seleccione Configuración del proyecto>Repositorios y elija un repositorio.
  2. En la pestaña Configuración de la página <Nombre del repositorio>, establezca Strict Vote Mode (Modo de voto estricto) en Activado o Desactivado.

Captura de pantalla en la que se muestra la configuración del repositorio Strict Vote Mode (Modo de voto estricto).

Deshabilitar repositorio

Si se deshabilita esta configuración, se deshabilita el acceso al repositorio, incluidas las compilaciones y las PR, pero el repositorio sigue siendo detectable con una advertencia.

  1. Seleccione Configuración del proyecto>Repositorios y elija un repositorio.
  2. En la pestaña Configuración de la página <Nombre del repositorio>, en Disable Repository (Deshabilitar repositorio), establezca Disable Repository (Deshabilitar repositorio) en Activado o Desactivado.

Captura de pantalla en la que se muestra la configuración Disable Repository (Deshabilitar repositorio).

Configuración de ramas que se pueden buscar

De forma predeterminada, la búsqueda de código en archivos solo se aplica a la rama predeterminada. Puede agregar hasta cinco ramas más en las búsquedas.

Importante

Para buscar código en repositorios, debe instalar la extensión Code Search de Marketplace. Si no ve Ramas incluidas en las búsquedas en la pestaña Configuración del repositorio, asegúrese de que tiene instalada la extensión.

Para agregar ramas a la búsqueda de código:

  1. Seleccione Configuración del proyecto>Repositorios y elija un repositorio.
  2. En la pestaña Configuración de la página <Nombre del repositorio>, seleccione el signo + en Ramas incluidas en las búsquedas.
  3. Elija una rama para incluirla en la búsqueda y seleccione Agregar rama.

Captura de pantalla en la que se muestra la configuración del repositorio Ramas incluidas en las búsquedas.

Directivas de rama entre repositorios

Puede establecer directivas en un nombre de rama específico, o en la rama predeterminada, en todos los repositorios de un proyecto. Por ejemplo, podría requerir dos revisores como mínimo para todas las PR de cada rama main de todos los repositorios de proyectos.

Para establecer directivas para proteger nombres de rama específicos o predeterminados en un proyecto:

  1. En Configuración del proyecto, seleccione Repositorios en el panel de navegación de la izquierda.

  2. En la página Todos los repositorios, seleccione la pestaña Directivas.

  3. Seleccione el signo más (+) en Directivas de rama en la parte inferior de la página.

  4. En la pantalla Agregar protección de rama, seleccione Proteger la rama predeterminada de cada repositorio o Proteger las ramas actuales y futuras que coincidan con un patrón especificado.

    Si selecciona la segunda opción, escriba el nombre de la rama que quiere proteger. Un mensaje informativo le permite saber cuántas ramas actuales se ven afectadas. Tenga en cuenta que el nombre de rama (o el patrón especificado) distingue mayúsculas de minúsculas. El nombre de la rama se puede proteger aunque la rama todavía no exista.

  5. Seleccione Crear.

    Captura de pantalla en la que se muestra cómo habilitar directivas de rama entre repositorios.

  6. En la página Cross-Repository policies for <branch name> (Directivas entre repositorios para ), establezca las directivas que quiera para las ramas protegidas. Para obtener más información sobre las directivas de rama, consulte Directivas de rama.

    Captura de pantalla en la que se muestra la configuración de directivas de rama entre repositorios.

Directiva Confirmar validación del correo electrónico del autor

Esta directiva bloquea las confirmaciones en un repositorio si los autores de las confirmaciones tienen direcciones de correo electrónico que no coinciden con un patrón.

  1. Seleccione Configuración del proyecto>Repositorios y seleccione un repositorio si quiere configurar solo dicho repositorio.

  2. En la pestaña Directivas de la página Todos los repositorios o <Nombre del repositorio>, en Repository Policies (Directivas de repositorio), establezca Confirmar validación del correo electrónico del autor en Activado o Desactivado.

  3. Si activa la directiva, especifique las direcciones de correo electrónico que deben coincidir.

    Puede especificar direcciones de correo electrónico exactas o usar caracteres comodín. Use ; como separador para varios patrones de correo electrónico. Los patrones de correo electrónico con el prefijo ! se excluyen. El orden es importante.

Captura de pantalla en la que se muestra la configuración de la directiva Confirmar validación del correo electrónico del autor.

Directiva Validación de la ruta de acceso del archivo

Puede establecer una directiva que impida las confirmaciones en un repositorio desde rutas de acceso de archivo que coincidan con un patrón.

  1. Seleccione Configuración del proyecto>Repositorios y seleccione un repositorio si quiere configurar solo dicho repositorio.

  2. En la pestaña Directivas de la página Todos los repositorios o <Nombre del repositorio>, en Repository Policies (Directivas de repositorio), establezca Validación de la ruta de acceso del archivo en Activado o Desactivado.

  3. Si activa la directiva, especifique las rutas de acceso que se deben bloquear.

    Puede especificar rutas de acceso exactas y caracteres comodín. Las rutas de acceso exactas comienzan por /. También se pueden especificar varias rutas de acceso si se usa ; como separador. Las rutas de acceso con el prefijo ! se excluyen. El orden es importante.

Captura de pantalla en la que se muestra la configuración de la directiva Validación de la ruta de acceso del archivo.

Directiva Cumplimiento de mayúsculas y minúsculas

Git distingue mayúsculas de minúsculas, lo que significa que un archivo denominado Foo.txt es diferente de un archivo denominado foo.txt. Pero Windows y macOS tienen como valor predeterminado sistemas de archivos que no distinguen mayúsculas de minúsculas, lo que significa que Foo.txt y foo.txt son el mismo nombre. Esta discrepancia puede causar problemas si un usuario de un sistema que no distingue mayúsculas de minúsculas inserta archivos, carpetas, ramas o etiquetas que solo difieren por el uso de mayúsculas y minúsculas. Para obtener más información, consulte Compatibilidad multiplataforma de Git.

Si la mayoría de los colaboradores usan Windows o macOS, es mejor habilitar la directiva Cumplimiento de mayúsculas y minúsculas. La directiva Cumplimiento de mayúsculas y minúsculas cambia el servidor de su modo predeterminado que distingue entre mayúsculas y minúsculas, donde File.txt y file.txt son diferentes, a un modo compatible con Windows y macOS, donde File.txt y file.txt se consideran el mismo archivo. Esta opción afecta a archivos, carpetas, ramas y etiquetas.

Esta configuración impide que los colaboradores introduzcan diferencias basadas exclusivamente en el uso de mayúsculas y minúsculas. La configuración evita los conflictos de distinción de mayúsculas y minúsculas y bloquea los envíos de cambios que las cambian en el nombre de archivos, carpetas, ramas y etiquetas. El usuario tiene que volver a escribir el historial sin cambios enviados para corregir el problema y, luego, intentar enviar los cambios de nuevo.

Esta configuración no corregirá un repositorio que ya contenga objetos que solo difieren por el uso de mayúsculas y minúsculas. Es mejor corregir estos problemas antes de activar la directiva. Cambie el nombre de los archivos y las carpetas, o bien vuelva a crear las ramas y las etiquetas para usar nombres no conflictivos.

Para establecer la directiva Cumplimiento de mayúsculas y minúsculas:

  1. Seleccione Configuración del proyecto>Repositorios y seleccione un repositorio si quiere configurar solo dicho repositorio.
  2. En la pestaña Directivas de la página Todos los repositorios o <Nombre del repositorio>, en Repository Policies (Directivas de repositorio), establezca Cumplimiento de mayúsculas y minúsculas en Activado o Desactivado.

Captura de pantalla en la que se muestra la configuración de la directiva Cumplimiento de mayúsculas y minúsculas.

Directiva Nombres reservados

No todos los nombres de archivo están permitidos en los sistemas de archivos de los tres principales sistemas operativos: Windows, macOS y Linux. Las confirmaciones en un repositorio compartido pueden contener nombres de archivo o carpeta que no son válidos en una o varias plataformas. Si se capturan y extraen del repositorio archivos o carpetas no válidos en estas plataformas, los directorios de trabajo pueden dañarse. Para obtener más información, consulte Compatibilidad multiplataforma de Git.

Puede habilitar o deshabilitar directivas para establecer restricciones en los nombres de archivo y carpeta. La configuración Nombres reservados bloquea el envío de cambios a un repositorio que contiene nombres de archivo o carpeta que no son válidos en todas las plataformas. Para ver qué nombres no son válidos, consulte Compatibilidad multiplataforma de Git.

Para establecer la directiva Nombres reservados:

  1. Seleccione Configuración del proyecto>Repositorios y seleccione un repositorio si quiere configurar solo dicho repositorio.
  2. En la pestaña Directivas de la página Todos los repositorios o <Nombre del repositorio>, en Repository Policies (Directivas de repositorio), establezca Nombres reservados en Activado o Desactivado.

Captura de pantalla en la que se muestra la configuración de la directiva Nombres reservados.

Directiva Longitud máxima de la ruta de acceso

No todas las longitudes de la ruta de acceso están permitidas en los sistemas de archivos de los tres principales sistemas operativos: Windows, macOS y Linux. Las confirmaciones en un repositorio compartido pueden contener archivos o directorios con longitudes de la ruta de acceso que no son válidas en una o varias plataformas. Si estos archivos o directorios se capturan y extraen del repositorio en una plataforma en la que no son válidos, los directorios de trabajo pueden dañarse. Para obtener más información, consulte Compatibilidad multiplataforma de Git.

La configuración Longitud máxima de la ruta de acceso bloquea los envíos de cambios que contienen archivos o directorios con longitudes de la ruta de acceso que no son válidas en todas las plataformas. Para ver qué longitudes de la ruta de acceso no son válidas, consulte Compatibilidad multiplataforma de Git. Al habilitar esta configuración, el valor máximo predeterminado es 248, porque esa longitud máxima es totalmente compatible con las tres plataformas principales.

Puede modificar el valor máximo de la ruta de acceso. Por ejemplo, si solo tiene desarrolladores de macOS o Linux en la organización, puede optar por establecer la longitud máxima en el valor que se admite en ambas plataformas (1016). También puede optar por establecer un valor máximo inferior para la ruta de acceso, a fin de aplicar las convenciones de nomenclatura de directorios de la organización.

Para establecer la directiva Longitud máxima de la ruta de acceso:

  1. Seleccione Configuración del proyecto>Repositorios y seleccione un repositorio si quiere configurar solo dicho repositorio.
  2. En la pestaña Directivas de la página Todos los repositorios o <Nombre del repositorio>, en Repository Policies (Directivas de repositorio), establezca Longitud máxima de la ruta de acceso en Activado o Desactivado.
  3. Si ha activado la configuración, escriba una longitud máxima de la ruta de acceso.

Captura de pantalla en la que se muestra la configuración de la directiva Longitud máxima de la ruta de acceso.

Directiva Tamaño máximo de archivo

Los archivos grandes insertados en el repositorio de Git permanecen en el repositorio indefinidamente, lo que aumenta los tiempos de clonación y el uso del disco. Para obtener instrucciones sobre cómo administrar archivos grandes, consulte Administración y almacenamiento de archivos grandes en Git.

La configuración de la directiva Tamaño máximo de archivo impide que los archivos con un tamaño superior al determinado entren en el repositorio. Si un envío de cambios contiene un archivo nuevo o actualizado con un tamaño superior al límite establecido en esta configuración, el envío de cambios se bloquea. El usuario debe volver a escribir el historial sin cambios enviados para quitar el archivo grande e intentar enviar los cambios de nuevo.

Para configurar la directiva Tamaño máximo de archivo:

  1. Seleccione Configuración del proyecto>Repositorios y seleccione un repositorio si quiere configurar solo dicho repositorio.
  2. En la pestaña Directivas de la página Todos los repositorios o <Nombre del repositorio>, en Repository Policies (Directivas de repositorio), establezca Tamaño máximo de archivo en Activado o Desactivado.
  3. Si ha activado la configuración, seleccione un tamaño máximo de archivo.

Captura de pantalla en la que se muestra la configuración de la directiva Tamaño máximo de archivo.

Pasos siguientes