Usando git-lfs com Git Credential Manager

git-lfs permite que se adicione arquivos grandes em um repositório do git sem que o arquivo faça parte do histórico. Basicamente ele adiciona um ponteiro para o arquivo, que vai ser armazenado no provedor git que você utilizar (por exemplo, github).

Git Credential Manager (GCM) é uma forma de gerenciar credenciais do git para um determinado sistema, com suporte para Windows, Linux e Mac.

Acontece que quando usamos os dois juntos, particularmente no caso de múltiplos usuários, as coisas não são tão suaves.

Para múltiplos usuários, o GCM espera que o seu username apareça antes do domínio na URL do remote. Por exemplo:

[remote "origin"]
-  url = https://github.com/marcelocra/blog.git
+  url = https://marcelocra@github.com/marcelocra/blog.git

O problema é que o git-lfs parece não entender essa url por algum motivo, não sendo capaz de identificar as credenciais.

Dessa forma, ao tentar rodar o comando para enviar os arquivos para o storage do GitHub, temos o seguinte erro:

# Apesar de ser dry-run, ele contacta o servidor.
> git lfs push origin main --dry-run --all
error: Authentication error: Authentication required: You must have push access to verify locks

Desfazendo a mudança que o GCM espera (removendo marcelocra no remote acima), comando funciona¹, retornando os arquivos que serão adicionados:

> git lfs push origin main --dry-run --all
push ... => file1
push ... => file2
...

e populando o .git/config (git config local do repositório) automaticamente com a seguinte entrada:

[lfs "https://github.com/marcelocra/blog.git/info/lfs"]
  access = basic

E esse é o segredo!

Essa linha que o git-lfs adiciona no .git/config é o que parece permiti-lo identificar as credenciais, dado que a partir desse ponto tudo funciona, até mesmo se você colocar o username novamente na URL do remote (o que você provavelmente vai querer fazer)!