Deploy pelo Git quebrou o site: achar o commit culpado
O caminho clicável dentro do Git Version Control do cPanel para ler o histórico de commits, comparar versões do arquivo suspeito e sair com o hash do culpado anotado, sem rodar nada que altere o site.

Resposta curta: abra Git Version Control no cPanel, clique em Manage no repositório, leia o último commit e use o Gitweb (ou `git log --stat` no Terminal) para ver data, autor e arquivos de cada alteração. Anote o hash do commit suspeito e peça a reversão: nunca rode reset na pasta de produção.
Neste artigo
- O que o histórico do Git responde sem alterar nada no site
- O que você precisa ter antes de abrir o Git Version Control
- Do painel do cPanel até a lista de commits
- Os mesmos dados pelo Terminal, quando o Gitweb não basta
- Que pergunta cada tela e cada comando responde
- Quatro becos sem saída e como sair deles
- O relatório que você entrega a quem vai reverter
O que o histórico do Git responde sem alterar nada no site
Depois de um deploy pelo Git, a pergunta é sempre a mesma: o que entrou nessa última publicação. O repositório hospedado na conta cPanel guarda a resposta, porque cada commit traz data, autor, mensagem e a lista exata de arquivos tocados.
Tudo o que este guia pede é leitura. Nenhum comando aqui grava, apaga ou reverte arquivo. A reversão em si é decisão do desenvolvedor e deve sair de um commit novo, não de um reset dentro da pasta que o visitante acessa.
Ao final desta leitura você terá:
- a data e o autor da última publicação;
- a lista de arquivos alterados em cada commit;
- a diferença linha a linha do arquivo suspeito entre a versão atual e a anterior;
- o hash do commit culpado, anotado para entregar a quem vai reverter.
O que você precisa ter antes de abrir o Git Version Control
A interface Git Version Control do cPanel aparece em *Arquivos* no menu principal. Ela lista os repositórios hospedados na própria conta. Se a lista estiver vazia, não há o que auditar por aqui: o site provavelmente foi publicado por FTP ou gerenciador de arquivos, e o caminho é outro.
Para os comandos de leitura você precisa de acesso ao Terminal do cPanel ou a SSH. Alguns provedores mantêm o Terminal desabilitado por política. Se for o caso, a tela do Git Version Control ainda mostra o último commit implantado, e isso já ajuda a cercar o problema.
Antes de qualquer coisa, faça um backup do diretório do site e do banco. Mesmo um roteiro só de leitura pode virar um "deixa eu testar uma coisinha" às três da manhã. Com o backup pronto, o custo do erro cai para o tempo de restaurar.
Do painel do cPanel até a lista de commits
Onde o cPanel lista os repositórios da conta
No cPanel, vá em *Arquivos* e clique em Git Version Control. A tela lista cada repositório com nome, caminho no servidor e o branch ativo (*checked-out branch*).
Resultado esperado: uma ou mais linhas, cada uma com os botões de gerenciamento à direita.
Por que conferir o branch publicado resolve metade dos casos
Anote o branch que aparece na linha do repositório. Esse detalhe resolve metade dos mistérios: se o desenvolvedor commitou em develop e o deploy acompanha main, o commit que você procura pode nem estar no histórico que você está lendo.
Hash, autor e data do último commit na tela Manage
Clique em Manage na linha do repositório. A aba de informações mostra dados do último commit do branch ativo: hash abreviado, autor, data e mensagem. É a primeira pista do "o que entrou".
Resultado esperado: um bloco com o identificador do commit e a data. Compare a data com o horário em que o site quebrou. Se a quebra é anterior ao último commit, o culpado está mais atrás no histórico, ou não é o Git.
Ler o diff de cada commit pelo Gitweb
Ainda em Manage, o cPanel oferece acesso ao Gitweb, a interface web de leitura do repositório, descrita na documentação oficial do cPanel. Ela abre em uma aba nova e mostra o resumo do repositório, a lista de commits (*shortlog*), as árvores de arquivos e o conteúdo de cada versão.
No Gitweb, clique em log ou shortlog para ver a sequência de commits em ordem cronológica inversa. Cada linha traz data, autor e mensagem. Clicando no commit, você vê a lista de arquivos alterados e pode abrir o commitdiff, que mostra as linhas adicionadas e removidas.
Resultado esperado: uma página com blocos em verde e vermelho por arquivo. É aqui que quase sempre aparece a linha solta, a chave de API trocada ou o require apontando para um caminho que não existe mais.
Os mesmos dados pelo Terminal, quando o Gitweb não basta
A interface web é confortável, mas filtrar por arquivo é mais rápido na linha de comando. Abra *Avançado > Terminal* no cPanel, ou conecte por SSH, e entre na pasta do repositório (o caminho está na tela do Git Version Control).
cd ~/repositories/meusite
git log --oneline -10
A primeira linha entra na pasta do repositório. O caminho acima é exemplo: use o que o cPanel mostrou. A segunda lista os dez commits mais recentes, um por linha, com hash abreviado e mensagem.
Para ver quem e quando, com os arquivos de cada commit:
git log --stat -5
Saída esperada: para cada commit, o hash completo, a linha Author:, a linha Date:, a mensagem e a relação de arquivos com quantas linhas mudaram em cada um.
Suspeita de um arquivo específico? Peça o histórico só dele:
git log --oneline -- wp-content/themes/meutema/functions.php
E para ver a diferença entre a versão atual e a imediatamente anterior desse arquivo:
git diff HEAD~1 HEAD -- wp-content/themes/meutema/functions.php
HEAD é o commit atual do branch; HEAD~1 é o anterior. O comando imprime as linhas removidas com - e as adicionadas com +. Se não imprimir nada, o arquivo não mudou entre esses dois commits, e a causa está em outro lugar.
Todos esses comandos são de leitura. Nenhum deles altera arquivo no disco.
Que pergunta cada tela e cada comando responde
| Pergunta | Onde responder | O que você anota |
|---|---|---|
| Qual branch está publicado | Git Version Control, linha do repositório | Nome do branch |
| Quando foi a última publicação | Manage, bloco do último commit | Data e hora |
| Quais commits entraram | Gitweb > shortlog, ou git log --oneline |
Hashes em ordem |
| Quem fez e o que dizia | git log --stat |
Autor, data, mensagem |
| Quais arquivos mudaram | Gitweb > commit, ou git log --stat |
Lista de caminhos |
| O que mudou dentro do arquivo | Gitweb > commitdiff, ou git diff |
Linhas + e - |
| Histórico de um arquivo só | git log -- caminho/do/arquivo |
Hash do commit suspeito |
Quatro becos sem saída e como sair deles
Quando o git log mostra um commit só
Se git log devolve um único commit, ou o Gitweb mostra uma lista curtíssima que não bate com meses de trabalho, o repositório provavelmente foi criado a partir de uma cópia de arquivos, não de um clone completo. Nesse caso não existe histórico anterior para comparar: a auditoria tem que acontecer na origem (o repositório remoto no serviço de hospedagem de código) e não na conta.
Quando o site mudou e o branch que você leu não
Você lê o histórico de main e não encontra nada suspeito, mas o site mudou. Volte à tela do Git Version Control e confira o branch ativo. Vale também olhar o arquivo .cpanel.yml do repositório, que descreve as tarefas de implantação: se ele copia arquivos de um caminho específico, o que chega à pasta pública pode não ser o que você está lendo.
Quando o arquivo quebrado nunca esteve versionado
Clássico em WordPress. wp-config.php, a pasta wp-content/uploads e muitas vezes os plugins ficam de fora do versionamento, listados no .gitignore. Se o arquivo que causou a quebra é um desses, o Git não tem o que mostrar: ele nunca viu esse arquivo. Confirme assim:
git log --oneline -- wp-config.php
Saída vazia significa que o arquivo não está no histórico. A investigação muda de ferramenta: log de acesso FTP, registro do gerenciador de arquivos, data de modificação do arquivo.
Por que git reset --hard na pasta de produção piora o problema
É tentador digitar git reset --hard para "voltar ao que funcionava". Dentro da pasta que atende os visitantes, isso descarta alterações locais não commitadas, e tudo o que foi gerado em produção e não está versionado pode ir junto. Pior: não resolve o problema, apenas o esconde até o próximo deploy trazê-lo de volta.
O caminho correto é devolver o hash ao desenvolvedor e pedir uma reversão registrada no histórico, que depois é publicada pelo fluxo normal de deploy. Assim o repositório continua contando a verdade sobre o que aconteceu.
O relatório que você entrega a quem vai reverter
Termine a investigação com um texto curto, não com um print de tela sem contexto. Algo nesta forma (os valores abaixo são exemplo):
Repositório: meusite
Branch publicado: main
Site quebrou por volta de: 14/10, 22h
Último commit implantado: 9f2c1ab
Autor: [email protected]
Data do commit: 14/10, 21h48
Arquivo suspeito: wp-content/themes/meutema/functions.php
Commit anterior do mesmo arquivo: 4d8e07c
Sintoma: tela branca no front, admin responde normal
Com hash, branch, arquivo e horário, quem vai reverter não precisa refazer a sua investigação. E se o veredito for que nada disso explica a quebra, você já eliminou o Git da lista de suspeitos, o que também é resultado.
Duas verificações de fechamento antes de encerrar: confirme que você leu o branch que realmente está publicado e que o arquivo suspeito aparece no histórico. Se qualquer uma das duas falhar, o problema não está no último deploy, e insistir no git log só queima tempo.
Referências
- Documentação oficial (cpanel) — cPanel Gitweb. Consultado em 2026-10-14.