# 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.

> 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.

João Rizzon · 2026-10-17 · Painéis

---

## 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](https://docs.cpanel.net/cpanel/files/gitweb/). 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: fulano@exemplo.com
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.

