= git LFS
{{tag>git comando}}

Large File Storage
/via: [[https://support.atlassian.com/bitbucket-cloud/docs/use-git-lfs-with-bitbucket/]]

== install
<code bash>sudo apt install git-lfs</code>

== setup (nuevos repos)
  * instalación cliente:<code bash>git lfs install --local # si no se especifica --local, afecta a todos los repos de la sesión, con --local solo al actual</code>
  * configuración:<code bash>git lfs track # ver que seguimientos se estan realizando
git lfs track "<pattern>" # puede ser directorio o tipo de archivo (entre comillas)</code>
    * se realizan cambios en ''.gitattributes'' que se tienen que commitear

== add
  * como en cualquer commit, se añaden los ficheros:<code bash>git add <files></code>

== other
  * problemes amb configuració ~/.ssh/config 
  * <code bash>git lfs env</code>
  * ''.lfsconfig''
  * <code bash>git push --no-verify origin main</code>

== .gitattributes
[[tech:git:dotfiles:gitattributes]]

== migración de repositorios
Este es un problema muy común tras una migración. Lo que tienes ahora en Gitea son los Pointers (archivos de texto de ~3 líneas con el hash sha256), pero el almacenamiento de Gitea no contiene los objetos binarios reales.

Para solucionarlo, tienes que hacer un "LFS Push" desde una copia local que sí tenga los archivos originales.

  - Asegúrate de tener los archivos en local
  - Configurar el nuevo Gitea como remoto:<code bash>git remote add nuevo-gitea ssh://git@git.fidmag.org:2222/usuario/repo.git</code>
  - Forzar la subida de todos los objetos LFS:<code bash>git lfs push nuevo-gitea --all</code>

== migración a LFS
En caso de querer migrar archivos existentes en el repositorio a LFS:<code bash>
git lfs migrate import --include="*.mp4" --everything
git push --force
</code>