Skip to main content

Sobre armazenamento de arquivo grande do Git

GitHub limita o tamanho dos arquivos permitidos em repositórios. Para acompanhar arquivos além desse limite, você pode usar Armazenamento de Arquivos Grandes do Git.

Sobre o Armazenamento de Arquivos Grandes do Git

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

Usando Git LFS, você pode armazenar arquivos de até 5 GB em seu repositório.

Quando você excede o limite por arquivo de 5 GB, o arquivo é rejeitado pelo Git LFS com uma mensagem de erro.

Você também pode usar Git LFS com GitHub Desktop. Para obter mais informações sobre como clonar repositórios Git LFS em GitHub Desktop, consulte Clonar um repositório do GitHub para o GitHub Desktop.

Formato do arquivo de ponteiro

O arquivo de ponteiro de Git LFS é assim:

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

Ele registra o version de Git LFS que você está usando, seguido de um identificador exclusivo do arquivo (oid). Além disso, armazena o size do arquivo final.

Observação

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

Leitura adicional