Skip to main content

Sobre armazenamento de arquivo grande do Git

GitHub limita o tamanho dos arquivos permitidos nos repositórios. Para rastrear arquivos além desse limite, você pode usar Git Large File Storage.

Sobre o Git Large File Storage

O Git LFS manipula arquivos grandes armazenando referências ao arquivo no repositório, mas não no próprio arquivo. Para explorar a arquitetura do Git, o Git LFS cria um arquivo de ponteiro que funciona como uma referência ao arquivo real (que é armazenado em outro lugar). O GitHub gerencia esse arquivo de ponteiro no seu repositório. Quando você clona o repositório, o GitHub usa o arquivo de ponteiro como um mapa para encontrar o arquivo grande para você.

Usando o Git LFS, você pode armazenar arquivos até:

ProdutoTamanho máximo do arquivo
GitHub Free2 GB
GitHub Pro2 GB
GitHub Team4 GB
GitHub Enterprise Cloud5 GB

Se você exceder o limite de 5 GB, os novos arquivos adicionados ao repositório serão rejeitados silenciosamente pelo Git LFS.

Também é possível usar o Git LFS com o GitHub Desktop. Para obter mais informações sobre como clonar repositórios do Git LFS no GitHub Desktop, confira "Como clonar um repositório do GitHub para o GitHub Desktop".

Você pode escolher se os objetos do Git LFS são incluídos nos arquivos de código-fonte, como arquivos ZIP e tarballs, que o GitHub cria para o repositório. Para obter mais informações, confira "Como gerenciar objetos do Git LFS nos arquivos do repositório".

Formato do arquivo de ponteiro

O arquivo de ponteiro do Git LFS tem esta aparência:

version https://git-lfs.github.com/spec/v1
oid sha256:4cac19622fc3ada9c0fdeadb33f88f367b541f38b89102a3f1261ac81fd5bcb5
size 84977953

Ele rastreia a version do Git LFS que está sendo usada, seguido de um identificador exclusivo para o arquivo (oid). Além disso, armazena o size do arquivo final.

Observações:

  • Git LFS não pode ser usado com sites de GitHub Pages.
  • Git LFS não pode ser usado com repositórios de modelos.

Leitura adicional