blog
Painéis

Commit, push e deploy no Git do cPanel: o que cada um faz

Do commit ao botão Deploy HEAD Commit: o que cada botão da tela faz e o ponto exato em que o arquivo entra no ar em public_html, sem abrir cliente de FTP.

JR · · 7 min de leitura · 1 tabela · 1 bloco de código

Resposta curta: Commit grava a alteração no histórico do repositório. Push envia esse histórico para o repositório remoto. Deploy é o único dos três que copia arquivos para a pasta pública do site. Sem um .cpanel.yml commitado na raiz do repositório, o deploy não roda e nada é publicado, por mais commits que existam.

Neste artigo
  1. Faça o backup antes, porque o Git não versiona o banco
  2. Repositório e working copy não são a pasta pública do site
  3. Como ler clone, branch, checkout e HEAD na listagem do cPanel
  4. Commit, push e pull mexem no repositório, não no site
  5. Sem .cpanel.yml commitado na raiz, o Deploy não publica nada
  6. Deploy que não publica: três sintomas e o que cada um indica
  7. O caminho inteiro, de editar o arquivo até publicar

A tela Git Version Control do cPanel mostra nove termos que vieram do Git, repositório, working copy, clone, branch, checkout, HEAD, commit, push e pull, mais um que é do próprio cPanel: deploy. Quem nunca usou Git lê "commit", "branch", "HEAD" e clica no botão que parece mais definitivo. Não é assim que o arquivo no ar muda.

Este texto percorre o caminho até o arquivo entrar no ar sem cliente de FTP, e explica cada termo pelo que ele faz naquela tela, na ordem em que você encontra. As definições seguem o Guide to Git: Common Git Terms da documentação oficial do cPanel. Esse documento cobre só o vocabulário. Os passos de .cpanel.yml, o comportamento do botão Deploy e os nomes de menu das telas de Backup e File Manager descrevem a interface do cPanel como ela se apresenta e não vêm dessa fonte: confira os rótulos na sua conta, porque mudam entre versões e temas do painel. Os caminhos de arquivo e nomes de repositório usados aqui são exemplos fictícios, identificados como tais.

Faça o backup antes, porque o Git não versiona o banco

Git versiona o repositório. Ele não versiona o banco de dados do WordPress, nem os arquivos enviados que você nunca colocou no repositório (a pasta de uploads, por exemplo). Um deploy mal configurado pode sobrescrever arquivo de produção.

Faça o backup pelo próprio cPanel antes de experimentar:

  1. Na busca do cPanel, digite Backup.
  2. Em *Download a Full Account Backup*, clique em Generate Backup. Em contas grandes isso demora, e o cPanel avisa por e-mail quando termina.
  3. Se quiser algo mais rápido e suficiente para um teste, use Download a Home Directory Backup e, em *Download a MySQL Database Backup*, baixe o banco do site.

Para voltar atrás, separe os três arquivos. O backup completo da conta serve para download e para uma restauração assistida pelo suporte do provedor: não há botão nessa tela que devolva a conta inteira sozinho. Já o backup do diretório home e o dump do banco você mesmo envia de volta em *Restore*, na própria seção de Backup, e o File Manager permite subir de volta um arquivo individual. Com esses dois na sua máquina, você consegue devolver os arquivos do site e o banco ao estado em que estavam antes do teste.

Repositório e working copy não são a pasta pública do site

Repositório é a pasta que contém seus arquivos mais o histórico de todas as versões deles. Na prática, é um diretório comum com uma subpasta oculta .git dentro. Essa subpasta é o histórico; apagá-la não apaga os arquivos, apaga a memória.

Quando você cria um repositório em Files > Git Version Control > Create, o cPanel pede um Repository Path, por exemplo /home/usuario/repositories/meusite (exemplo fictício). Esse caminho normalmente não é a pasta pública do site. public_html é a pasta pública. São duas coisas distintas, e é justamente essa separação que explica por que um commit não muda o site.

A working copy (cópia de trabalho) é a versão dos arquivos que você vê e edita naquele diretório agora. Ela pode estar diferente do histórico: é isso que o Git chama de alterações não commitadas.

Como ler clone, branch, checkout e HEAD na listagem do cPanel

Clone é copiar um repositório inteiro, com histórico, para outro lugar. Quando você informa uma *Clone URL* na criação do repositório, o cPanel baixa o repositório remoto para dentro da sua conta. Clonar não é baixar um zip: o clone carrega junto todos os commits anteriores.

Branch é uma linha de desenvolvimento paralela dentro do mesmo repositório. O branch padrão costuma se chamar main ou master. A tela do cPanel mostra qual branch está ativo e permite trocar (*checkout*) entre os que existem.

Checkout é trocar a working copy para outro branch ou outro ponto do histórico. Os arquivos na pasta mudam na hora.

HEAD é um apontador: indica o commit em que a sua working copy está posicionada neste momento. Por isso o botão se chama Deploy HEAD Commit: ele publica o commit onde o HEAD está, não necessariamente o último que você escreveu em outro branch.

Commit, push e pull mexem no repositório, não no site

Termo O que faz Onde o arquivo muda
Commit Registra as alterações atuais no histórico local, com mensagem e autor Só no histórico do repositório, no servidor onde o commit foi feito
Push Envia commits locais para um repositório remoto No repositório remoto (GitHub, GitLab ou o repositório da conta cPanel)
Pull Busca commits do remoto e aplica na cópia local Nos arquivos do repositório local, não na pasta pública
Checkout Muda a working copy para outro branch ou commit Nos arquivos do repositório local
Deploy Executa as tarefas do .cpanel.yml Onde o .cpanel.yml mandar copiar, normalmente public_html

Leia a coluna da direita duas vezes. Commit, push e pull mexem no repositório. Nenhum deles toca na pasta que o visitante acessa. O único que atravessa essa fronteira é o deploy, e ele só atravessa porque alguém escreveu um arquivo dizendo que caminho seguir.

Do arquivo editado até o site no arEditarMuda a working copyCommitGrava no histórico localPush/PullMove commits entre repositóriosDeployCopia para a pasta pública
Só o deploy atravessa a fronteira entre repositório e pasta pública do site.

Sem .cpanel.yml commitado na raiz, o Deploy não publica nada

O deploy do cPanel lê um arquivo chamado .cpanel.yml, que precisa estar na raiz do repositório e dentro de um commit. Arquivo salvo mas não commitado não conta. O conteúdo descreve tarefas de deploy, em geral comandos de cópia.

Exemplo fictício, para um repositório em /home/usuario/repositories/meusite que publica em public_html:

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/usuario/public_html/
    - /bin/cp -R index.php $DEPLOYPATH
    - /bin/mkdir -p $DEPLOYPATH/wp-content/themes/
    - /bin/cp -R wp-content/themes/meutema $DEPLOYPATH/wp-content/themes/

Linha a linha:

O cPanel mostra o retorno dos comandos na própria aba *Pull or Deploy*, depois do clique em Deploy HEAD Commit. Se um cp falhar por falta de pasta ou por caminho errado, a mensagem de erro aparece nessa área de saída. Leia esse retorno antes de concluir que o deploy funcionou: o botão ter sido clicado não garante que todas as tarefas terminaram bem.

A indentação em YAML é por espaço, nunca por tabulação. Um tab faz o arquivo ser rejeitado.

Como criar o .cpanel.yml pelo File Manager, sem terminal

  1. Files > File Manager, entre na raiz do repositório.
  2. No menu *Settings* (canto superior direito), marque Show Hidden Files (dotfiles). Sem isso você não enxerga arquivos iniciados por ponto.
  3. Clique em + File, nomeie .cpanel.yml, clique com o botão direito e escolha Edit.
  4. Cole o conteúdo, ajuste os caminhos, salve.
  5. Volte em Git Version Control, clique em Manage no repositório, aba Pull or Deploy. Se o cPanel ainda não reconhecer, é porque falta o commit do arquivo.

Deploy que não publica: três sintomas e o que cada um indica

Por que o botão Deploy HEAD Commit aparece cinza

O botão só fica ativo quando o cPanel encontra um .cpanel.yml válido no commit em que o HEAD está. Verifique, nesta ordem: o arquivo existe na raiz do repositório (não dentro de uma subpasta), o nome começa com ponto e não tem extensão extra como .cpanel.yml.txt, e ele está commitado. Se você criou o arquivo pelo File Manager, ele ainda é uma alteração não commitada até alguém registrar o commit.

Commitei e o site continua igual, o que ainda falta

Comportamento esperado. Commit grava histórico. A publicação acontece no deploy. Vá em Manage > Pull or Deploy e clique em Deploy HEAD Commit. Se o botão estiver ativo e mesmo assim nada mudou, o destino no .cpanel.yml provavelmente aponta para outra pasta que não a do site.

Fiz push no GitHub e nada apareceu no site

Push atualiza o repositório remoto. Se o repositório que está na conta cPanel foi clonado de lá, ele precisa receber um Update from Remote (pull) para enxergar os novos commits, e só depois um deploy. São dois cliques, não um.

Deploy não publicou: onde olhar primeiroBotão Deploy cinzaFalta .cpanel.yml commitado na raizCommit feito, site igualClique em Deploy HEAD CommitDeploy rodou, nada mudouDestino errado no YAMLPush no GitHub ignoradoFalta Update from Remote
Quatro sintomas comuns e a causa que cada um costuma indicar.

O caminho inteiro, de editar o arquivo até publicar

  1. Você edita um arquivo: muda a working copy.
  2. Commit: a mudança entra no histórico.
  3. Push: o histórico chega ao repositório remoto.
  4. Pull (ou *Update from Remote* no cPanel): o repositório da conta recebe esses commits.
  5. Checkout/HEAD: define qual commit está ativo.
  6. Deploy: executa o .cpanel.yml e copia os arquivos para a pasta pública. É aqui, e só aqui, que o arquivo no ar muda.

Depois do primeiro deploy bem-sucedido, confira no File Manager a data de modificação do arquivo em public_html. Se a data bate com o horário do clique, o caminho está correto. Se não bate, o problema está no destino declarado no YAML, não no Git.

Fonte das definições de termos: cPanel, Guide to Git: Common Git Terms.

Referências

  1. Documentação oficial (cpanel) — Guide to Git: Common Git Terms. Consultado em 2026-10-15.
Leia também