Skip to main content

Acerca de los archivos grandes en GitHub

GitHub limita el tamaño de los archivos que puedes rastrear en los repositorios regulares de Git. Aprende cómo rastrear o eliminar archivos que sobrepasan el límite.

Platform navigation

Acerca de los límites de tamaño en GitHub

GitHub intenta proporcionar almacenamiento abundante para todos los repositorios de Git, aunque hay límites estrictos para los tamaños de archivo y repositorio. Para garantizar el rendimiento y la confiabilidad para nuestros usuarios, monitoreamos activamente las señales del estado general de los repositorios. El estado de los repositorios es una función de varios factores de interacción, incluyendo el tamaño, la frecuencia de confirmaciones y la estructura.

Límites de tamaño de archivo

GitHub limita el tamaño de los archivos permitidos en los repositorios. Recibirás una advertencia de Git si intentas añadir o actualizar un archivo mayor a 50 MiB. Los cambios aún se subirán a tu repositorio, pero puedes considerar eliminar la confirmación para minimizar el impacto en el rendimiento. Para obtener más información, consulte "Eliminación de archivos del historial de un repositorio".

Nota: Si agrega un archivo a un repositorio por medio de un explorador, el archivo no puede ser mayor de 25 MiB. Para obtener más información, vea «Agregar un archivo a un repositorio».

GitHub bloquea los archivos con un tamaño superior a 100 MiB.

Para rastrear archivos que sobrepasen este límite, debes utilizar Almacenamiento de archivos de gran tamaño de Git (Git LFS). Para obtener más información, vea «Acerca de Large File Storage de Git».

Si necesitas distribuir archivos grandes dentro de tu repositorio, puedes crear lanzamientos en GitHub.com en vez de rastrear los archivos. Para obtener más información, consulte "Distribución de archivos binarios grandes".

Git no se diseñó para manejar archivos grandes de SQL. Para compartir bases de datos grandes con otros desarrolladores, se recomienda usar un servicio para compartir archivos.

Límites de tamaño de repositorio

Te recomendamos que los repositorios sean siempre pequeños, idealmente, de menos de 1 GB, y se recomienda ampliamente que sean de menos de 5GB. Los repositorios más pequeños se clonan más rápido y se puede mantenerlos mejor y trabajar en ellos más fácilmente. Si tu repositorio impacta excesivamente nuestra infraestructura, puede que recibas un mensaje de correo electrónico de Soporte de GitHub, el cual te solicitará que tomes acciones correctivas. Intentamos ser flexibles, especialmente con proyectos grandes que tienen muchos colaboradores, y trabajaremos junto contigo para encontrar una resolución cada que sea posible. Puedes prevenir que tu repositorio impacte nuestra infraestructura si administras el tamaño de tu repositorio y su salud general con eficacia. Puede encontrar consejos y una herramienta para el análisis de repositorios en el repositorio github/git-sizer.

Las dependencias externas pueden causar que los repositorios de Git se hagan muy grandes. Para evitar llenar un repositorio con dependencias externas, te recomendamos utilizar un administrador de paquetes. Entre los administradores de paquetes más populares para los lenguajes comunes se incluyen Bundler, el Administrador de paquetes de Node y Maven. Estos administradores de paquetes soportan la utilización directa de repositorios de Git para que no dependas de fuentes pre-empacadas.

Git no está diseñado para fungir como una herramienta de respaldo. Sin embargo, hay muchas soluciones diseñadas específicamente para realizar copias de seguridad, como Arq, Carbonite y CrashPlan.

Eliminar archivos del historial de un repositorio

Advertencia: Estos procedimientos eliminarán archivos de manera permanente del repositorio de su equipo y de GitHub.com. Si el archivo es importante, haz una copia de seguridad local en un directorio por fuera del repositorio.

Eliminar un archivo agregado en la confirmación más reciente no subida

Si el archivo se agregó con tu confirmación más reciente, y no lo subiste a GitHub.com, puedes eliminar el archivo y modificar la confirmación:

  1. Abra TerminalTerminalGit Bash.

  2. Cambia el directorio de trabajo actual por tu repositorio local.

  3. Para quitar el archivo, escriba git rm --cached:

    $ git rm --cached GIANT_FILE
    # Stage our giant file for removal, but leave it on disk
    
  4. Confirme este cambio con --amend -CHEAD:

    $ git commit --amend -CHEAD
    # Amend the previous commit with your change
    # Simply making a new commit won't work, as you need
    # to remove the file from the unpushed history as well
    
  5. Sube tus confirmaciones a GitHub.com:

    $ git push
    # Push our rewritten, smaller commit
    

Eliminar un archivo que se añadió en una confirmación de cambios previa

Si añadiste un archivo en una confirmación previa, necesitas eliminarlo del historial del repositorio. Para quitar archivos del historial del repositorio, puede usar BFG Repo-Cleaner o el comando git filter-repo. Para más información, consulta "Eliminación de datos confidenciales de un repositorio".

Distribuir binarios grandes

Si necesitas distribuir archivos grandes dentro de tu repositorio, puedes crear lanzamientos en GitHub.com. Los lanzamientos te permiten empaquetar el software, notas de lanzamiento y enlaces a los archivos binarios para que otras personas puedan utilizarlos. Para obtener más información, consulta "Acerca de los lanzamientos".

No limitamos el tamaño total de los archivos binarios en los lanzamientos o anchos de banda que se utilizan para entregarlos. Sin embargo, cada archivo individual debe ser menor a 2 GiB.