Skip to main content

Sobre arquivos grandes no GitHub

GitHub Enterprise Server limita o tamanho dos arquivos que você pode rastrear em repositórios do Git regulares. Aprenda a rastrear ou remover arquivos que estão além do limite.

Sobre limites de tamanho em GitHub Enterprise Server

GitHub Enterprise Server limita o tamanho dos arquivos permitidos nos repositórios. Se você tentar adicionar ou atualizar um arquivo maior do que 50 MB, você receberá um aviso do Git. As alterações ainda serão carregadas no seu repositório com sucesso, mas você pode considerar remover o commit para minimizar o impacto no desempenho. Para obter mais informações, confira "Como remover arquivos do histórico de um repositório".

Observação: se você adicionar um arquivo a um repositório por meio de um navegador, o arquivo não poderá ser maior que 25 MB. Para obter mais informações, confira "Como adicionar um arquivo a um repositório".

Por padrão, o GitHub Enterprise Server bloqueia arquivos maiores que 100 MB. No entanto, um administrador do site pode configurar um limite diferente para o your GitHub Enterprise Server instance. Para obter mais informações, confira "Como definir limites de push do Git".

Para rastrear arquivos além desse limite, você deverá usar Git Large File Storage (Git LFS). Para obter mais informações, confira "Sobre o Git Large File Storage".

Se você precisar distribuir arquivos grandes no repositório, crie versões no your GitHub Enterprise Server instance em vez de acompanhar os arquivos. Para obter mais informações, confira "Como distribuir binários grandes".

O Git não é projetado para lidar com arquivos SQL grandes. Para compartilhar bancos de dados grandes com outros desenvolvedores, recomendamos usar o Dropbox.

Remover arquivos do histórico do repositório

Aviso: estes procedimentos removem definitivamente os arquivos do repositório no computador e no your GitHub Enterprise Server instance. Se o arquivo for importante, faça uma cópia de backup local em um diretório fora do repositório.

Remover um arquivo adicionado ao commit não processado mais recente

Se o arquivo foi adicionado ao commit mais recente e você ainda não fez push deles no your GitHub Enterprise Server instance, exclua o arquivo e corrija o commit:

  1. Abra TerminalTerminalGit Bash. 1. Mude o diretório de trabalho atual para o seu repositório local.
  2. Para remover o arquivo, insira git rm --cached:
    $ git rm --cached GIANT_FILE
    # Stage our giant file for removal, but leave it on disk
  3. Faça commit dessa alteração usando --amend -CHEAD:
    $ git commit --amend -CHEAD
    # Amend the previous commit with your change
    # Simply making a new commit won't work, as you need
    # to remove the file from the unpushed history as well
  4. Faça push dos commits no your GitHub Enterprise Server instance:
    $ git push
    # Push our rewritten, smaller commit

Remover um arquivo adicionado em um commit anterior

Se você adicionou um arquivo em um commit anterior, você deverá removê-lo do histórico do repositório. Para remover arquivos do histórico do repositório, use o BFG Repo-Cleaner ou o comando git filter-branch. Para obter mais informações, confira "Como remover dados confidenciais de um repositório".

Distribuir binários grandes

Se você precisar distribuir arquivos grandes no seu repositório, crie versões no your GitHub Enterprise Server instance. As versões permitem que você empacote software, notas de versão e links para arquivos binários para que outras pessoas possam usar. Para obter mais informações, acesse "Sobre as versões".