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ê.
Diferentes limites de tamanho máximo para o Git LFS se aplicam conforme o seu plano do GitHub.
| Produto | Tamanho máximo do arquivo |
|---|---|
| GitHub Free | 2 GB |
| GitHub Pro | 2 GB |
| GitHub Team | 4 GB |
| GitHub Enterprise Cloud | 5 GB |
Quando você excede o limite por arquivo de 5 GB, o arquivo é rejeitado pelo Git LFS com uma mensagem de erro.
Também é possível usar o Git LFS com o GitHub Desktop. Para obter mais informações de como clonar repositórios LFS do Git no GitHub Desktop, confira "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 "Gerenciando objetos LFS do Git em arquivos do seu 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.