Neste tutorial vamos explicar com um passo a passo como configurar & clonar um repositório git (GitHub) no cPanel da sua hospedagem.
OBS.: Para que funcione corretamente o repositório precisa estar público.
01. Acesse o cPanel da hospedagem e procure pela ferramenta Git™ Version Control.
02. Clique no botão Criar.
03. Localize o endereço do seu repositório no GitHub. No nosso exemplo https://github.com/nuvemhospedagem/respositorio.git
04. Preencha os campos:
Repository Name: um nome de identificação para o repositório
Clone URL: cole o endereço HTTPS do repositório
Repository Path: caminho onde o repositório será clonado na hospedagem (ex: /home/usuario/repositorios/meusite)
05. Para finalizar clique no botão Criar no final da página.
06. Para atualizar o repositório com as alterações mais recentes do GitHub, clique em Gerenciar → Pull or Deploy → Update from Remote.
Parte 2 — Clonando um repositório privado (com chave SSH)
Para repositórios privados é necessário configurar uma chave SSH no cPanel e cadastrá-la no GitHub como Deploy Key. Esse processo é feito inteiramente pelo painel, sem necessidade de acesso ao terminal.
2.1 Gerar a chave SSH no cPanel
01. No cPanel, acesse a ferramenta Gerenciar Chaves do SSH.
02. Clique em Gerar uma Nova Chave.
03. Preencha os campos:
- Key Name: um nome para a chave (ex:
github_deploy) - Senha (passphrase): deixe em branco (caso contrário, o Git Version Control não conseguirá usar a chave automaticamente)
- Tipo da chave: RSA
- Tamanho: 4096
04. Clique em Gerar Chave.
2.2 Autorizar a chave privada
05. De volta à tela de Gerenciar Chaves do SSH, localize a chave que acabou de gerar na lista de Chaves Privadas e clique em Manage → Authorize.
Esse passo é essencial. Sem autorizar a chave, ela não fica disponível para uso pelo Git Version Control.
2.3 Copiar a chave pública
06. Na lista de Chaves Públicas, clique em View/Download ao lado da chave gerada.
07. Copie todo o conteúdo da chave pública (começa com ssh-rsa AAAA...). Você usará esse conteúdo no próximo passo.
2.4 Cadastrar a chave como Deploy Key no GitHub
08. Acesse seu repositório no GitHub e vá em Settings → Deploy keys → Add deploy key.
09. Preencha os campos:
- Title: um nome identificável (ex: “cPanel Nuvem Hospedagem”)
- Key: cole o conteúdo da chave pública copiada no passo anterior
- Allow write access: marque apenas se o servidor precisar enviar alterações para o GitHub (na maioria dos casos, deixe desmarcado)
10. Clique em Add key.
2.5 Clonar o repositório privado no cPanel
11. No cPanel, acesse novamente o Git™ Version Control e clique em Criar.
12. Em Clone URL, utilize o endereço SSH do repositório (não o HTTPS):
[email protected]:usuario/repositorio.gitAtenção: o endereço precisa começar com
[email protected]:— esse é o erro mais comum nesse processo. Endereços HTTPS não funcionam com chaves SSH.
13. Preencha Repository Path e Repository Name normalmente e clique em Criar.