blog
Painéis

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.

JR · · 7 min de leitura · 1 tabela · 6 blocos de código

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
  1. O que o histórico do Git responde sem alterar nada no site
  2. O que você precisa ter antes de abrir o Git Version Control
  3. Do painel do cPanel até a lista de commits
  4. Os mesmos dados pelo Terminal, quando o Gitweb não basta
  5. Que pergunta cada tela e cada comando responde
  6. Quatro becos sem saída e como sair deles
  7. 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á:

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.

Do painel cPanel ao commit suspeitoAbrir Git Version ControlMenu Arquivos do cPanelConferir branch publicadoAnote o checked-out branchAbrir ManageHash, autor e dataLer o GitwebShortlog e commitdiff
Caminho de leitura no painel, sem alterar arquivos.

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
Quando o histórico não respondegit log mostra um commit sóAudite no repositório remotoHistórico limpo, site mudouConfira branch e .cpanel.ymlLog do arquivo vazioArquivo está no .gitignoreAchou o hashEntregue ao desenvolvedorNunca use reset --hardReversão vira commit novo
Saídas para cada beco sem saída da investigação.

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

  1. Documentação oficial (cpanel) — cPanel Gitweb. Consultado em 2026-10-14.
Leia também