git lfs (large file system) - Como adicionar arquivos grandes no repositório

Criado em: 28/10/2021




Neste post descrevo como adicionar arquivos com mais de 100.00 MB no repositório git.


Partindo de um erro no terminal

Vamos imaginar que você se deparou com a seguinte mensagem de erro após tentar fazer push.

remote: error: GH001: Large files detected. You may want to try Git Large File Storage - https://git-lfs.github.com.
remote: error: File folder/large-file.zip is 160.08 MB; this exceeds GitHub file size limit of 100.00 MB

E o caminho mais rápido, ou necessário, seja cometer um crime. Bom, pra isso siga os passos abaixo.

Abrindo caminho para o crime

É necessário instalar o git lfs no seu computador.

Assumindo que está usando um MacOS com homebrew, o comando é o seguinte:

brew install git-lfs

Sujando as mãos

Na pasta raiz do seu repositório execute:

git lfs install

Vamos imaginar que você quer adicionar arquivos ZIP meio grandinhos, então execute:

git lfs track "*.zip"

Agora marque isso no seu repositório:

git add .gitattributes

Pronto, a partir daqui seu repositório está preparado para receber arquivos ZIP (neste exemplo) grandes.

PS: Não recomendo seguir os passos deste artigo.