10.6 Git Internals (Por Dentro do Git) - Protocolos de Transferência

Por exemplo, digamos que você execute git push origin master em seu projeto, e a origin é definida como uma URL que usa o protocolo de SSH. O Git aciona o processo send-pack, que inicia uma conexão via SSH com seu servidor. Ele tenta executar um comando no servidor remoto por meio de uma chamada num processo provindo pelo respectivo SSH de modo em que se pareça com algo mais como desta exata assimilação disposta que venha logo a seguir logo abaixo, em seguida:

O comando git-receive-pack responde imediatamente com uma linha para cada referência que possui naquele momento – nesse caso, apenas a branch master e seu SHA-1. A primeira linha também contém uma lista das capacidades do servidor (aqui, report-status, delete-refs, e algumas outras mais à sua exatidão, incluindo nelas até mesmo o identificador do cliente).

Os dados são transmitidos em blocos. Cada bloco começa com um valor hexadecimal de 4 caracteres que especifica seu comprimento (incluindo os 4 bytes do próprio tamanho). Os blocos geralmente contêm uma única linha de dados e um avanço de linha ao final. Seu primeiro bloco começa com 00a5, que é 165 em hexadecimal, indicando que o bloco tem 165 bytes. O próximo trecho é 0000, o que significa que o servidor concluiu a listagem de suas próprias referências.

Agora que ele conhece o estado do servidor, seu processo de send-pack determina quais são os commits que ele tem e por fim quais são eles os quais o servidor não detém consigo em partes correspondentes nos referidos termos presentes nas suas referenciadas partes da parte provinda dele próprio, que se restam ali, com as faltas destes. Para cada referência que o push atualizará, o processo send-pack transmite essa informação ao processo receive-pack. Por exemplo, se você estiver atualizando o branch master e adicionando um branch experiment, a resposta send-pack pode ficar parecida com isso:

O Git envia uma linha para cada referência que você está atualizando, com o comprimento da linha, o SHA-1 antigo, o novo SHA-1 e a referência que está sendo atualizada. A primeira linha também contém as capacidades do cliente. O valor SHA-1 formados de todos os termos contendo apenas os números constituídos em '0’s significa que não havia nada ali antes – porque você está adicionando a referência de experiment. Se você estivesse excluindo uma referência, veria o oposto: apenas '0’s do lado direito.

Em seguida, o cliente envia um packfile com todos os objetos que o servidor ainda não possui. Por fim, o servidor responde com uma indicação de sucesso (ou falha):

Esse processo é praticamente o mesmo via HTTP, embora a negociação inicial seja um pouco diferente. A conexão é iniciada com esta requisição:

Esse é o fim da primeira troca de informações entre cliente e servidor. O cliente então faz outra requisição, dessa vez um POST, com os dados fornecidos pelo send-pack.

A requisição POST inclui a saída do send-pack e o packfile como sua carga útil. O servidor então indica sucesso ou falha com a sua correspondente resposta HTTP que a responde.

Lembre-se de que o protocolo HTTP ainda pode encapsular esses dados em uma codificação de transferência em blocos.

Se você está fazendo o fetch via SSH, o fetch-pack roda algo assim:

Depois que o fetch-pack se conecta, o upload-pack devolve algo semelhante a isto:

Isso é muito semelhante à resposta do receive-pack, mas as capacidades são diferentes. Além disso, ele informa para onde HEAD aponta (symref=HEAD:refs/heads/master), permitindo ao cliente saber o que deve colocar em checkout caso se trate de um clone.

Nesse ponto, o processo fetch-pack examina os objetos que possui e responde com os objetos de que precisa, enviando “want” seguido pelo SHA-1 desejado. Ele envia todos os objetos que já possui com “have”, seguido pelo SHA-1. Ao final da lista, escreve “done” para fazer o processo upload-pack começar a enviar o packfile com os dados necessários:

A negociação inicial de uma operação de fetch requer duas requisições HTTP. A primeira é uma requisição GET para o mesmo endpoint usado no protocolo burro:

Isso é muito semelhante a invocar git-upload-pack por uma conexão SSH, mas a segunda troca é realizada como uma requisição separada:

Novamente, este é o exato e mesmo formato que o disposto e baseador correspondido logo acima, e anteriormente. A resposta a essa requisição indica sucesso ou falha e inclui o packfile.