Git no cPanel: como fazer deploy do site com o Git Version Control

Comente! ,

Tempo de leitura: 4 minutos

Usar o Git no cPanel acaba com o vai e vem de arquivos por FTP: você faz o commit no computador, envia para o repositório e publica o site com um clique, sabendo exatamente qual versão está no ar. O recurso se chama Git Version Control e já vem no painel. Nas hospedagens com cPanel da Rubfy, como a Hospedagem de Sites com LiteSpeed, ele está disponível para qualquer conta.

Por que usar Git no cPanel

  • histórico: cada publicação corresponde a um commit, e voltar para uma versão anterior é simples;
  • menos erro manual: nada de esquecer um arquivo no upload por FTP;
  • trabalho em equipe: várias pessoas no mesmo projeto, sem sobrescrever o trabalho umas das outras.

Se hoje você publica por FTP, vale comparar com o nosso guia de conexão via SFTP para entender o que muda.

Passo 1: criar ou clonar o repositório

No cPanel, abra Arquivos > Git Version Control e clique em Create. Você tem duas opções:

  • clonar um repositório existente (GitHub, GitLab, Bitbucket): ative Clone a Repository e cole a URL de clone;
  • criar um repositório vazio no servidor e enviar o código para ele a partir do seu computador.

Em Repository Path, escolha uma pasta fora do public_html, por exemplo /home/usuario/repositorios/meusite. Assim os arquivos internos do projeto, como a pasta .git, não ficam acessíveis pelo navegador.

Repositórios privados

Para clonar um repositório privado, o servidor precisa de uma chave SSH autorizada no GitHub ou GitLab. Gere a chave em Segurança > Acesso SSH no cPanel e cadastre a chave pública como deploy key do repositório, com permissão só de leitura.

Passo 2: o arquivo .cpanel.yml

O cPanel não publica sozinho: ele copia os arquivos para o site seguindo as instruções de um arquivo chamado .cpanel.yml, que fica na raiz do repositório. Um exemplo para um site estático:

---
deployment:
  tasks:
    - export DEPLOYPATH=/home/usuario/public_html/
    - /bin/cp -R index.html css js img $DEPLOYPATH

Troque usuario pelo usuário da sua conta e liste as pastas e arquivos que devem ir para o ar. O arquivo precisa estar commitado, senão o botão de deploy fica desativado. A documentação oficial de deploy com Git traz exemplos para outros cenários.

Passo 3: publicar com o Git no cPanel

Existem dois fluxos de publicação:

  1. Pull deployment: o código fica no GitHub. Em Manage > Pull or Deploy, clique em Update from Remote para baixar os commits novos e depois em Deploy HEAD Commit para publicar.
  2. Push deployment: você envia direto para o repositório do cPanel usando a URL de clone por SSH que aparece na tela. Com o .cpanel.yml no lugar, o deploy roda automaticamente a cada push.

Erros comuns ao usar Git no cPanel

  • botão de deploy desativado: falta o .cpanel.yml commitado, ou existem alterações não commitadas no repositório do servidor;
  • arquivos apagados continuam no site: o cp copia, mas não remove. Arquivos excluídos do projeto precisam ser apagados manualmente do public_html, pelo Gerenciador de Arquivos;
  • permissão negada no clone privado: a chave SSH não foi cadastrada como deploy key.

Boas práticas para o repositório

  • nunca commite senhas: arquivos como wp-config.php ou .env com dados de banco devem ficar fora do Git, listados no .gitignore, e ser criados direto no servidor;
  • publique a partir de uma branch estável, como main, e deixe o desenvolvimento em outra branch;
  • teste antes de publicar: um ambiente de homologação num subdomínio evita que um erro vá direto para o site principal. Veja como criar um subdomínio no cPanel;
  • mantenha backup mesmo usando Git: o repositório guarda o código, mas não o banco de dados nem os arquivos enviados pelos usuários.

Perguntas frequentes

Preciso de acesso SSH para usar o Git Version Control?

Para clonar e publicar pela interface, não. O acesso SSH só é necessário no fluxo de push, quando você envia o código direto do seu computador para o servidor.

Serve para WordPress?

Serve para versionar tema e plugins próprios. O núcleo do WordPress, os uploads e o banco não devem ir para o repositório, porque mudam pelo próprio painel do site.

E para projetos Node.js?

O mesmo repositório pode alimentar uma aplicação Node.js criada pelo Setup Node.js App do cPanel. Depois do deploy, basta reiniciar a aplicação pelo painel. O artigo sobre Node.js no cPanel explica essa configuração.

Publique seus projetos na Rubfy

A Hospedagem de Sites da Rubfy combina cPanel, LiteSpeed com CloudLinux, discos NVMe, SSL grátis, JetBackup e Imunify360 em servidores no Brasil, com ativação imediata. Se o seu projeto já pede recursos dedicados e acesso root, o Cloud VPS cPanel traz o mesmo painel em um servidor só seu.

Artigos relacionados