Git na hospedagem: clonar repositório privado e erros comuns

Para quem publica sites a partir do GitHub (ou outro repositório Git) na hospedagem da ValueHost, usando o Git do painel ou o terminal SSH, e não consegue clonar, atualizar ou abrir a ferramenta.

Onde fica o Git

• cPanel: função Git Version Control (Controle de Versão do Git). Documentação oficial: https://docs.cpanel.net/cpanel/files/git-version-control/
• Plesk: opção Git do domínio.
• Terminal SSH: o acesso SSH da hospedagem usa a porta 1157, com o usuário do painel.

ssh -p 1157 [email protected]

Repositório privado: autenticação

O GitHub não aceita a senha da conta para clonar repositórios privados por HTTPS. Se aparecer um erro como could not read Password for 'https://github.com', a autenticação falhou. Use uma destas opções.

Opção 1: chave SSH (recomendada)

1. Gere uma chave na hospedagem pelo terminal:

ssh-keygen -t ed25519 -f ~/.ssh/github_deploy -C "deploy-hospedagem"

2. Mostre a chave pública e copie o conteúdo:

cat ~/.ssh/github_deploy.pub

3. No GitHub, abra o repositório e vá em Settings, Deploy keys, Add deploy key. Cole a chave pública e salve.
4. Indique ao SSH qual chave usar para o GitHub, criando ou editando o arquivo ~/.ssh/config:

Host github.com
  IdentityFile ~/.ssh/github_deploy

5. Clone pelo endereço SSH do repositório:

git clone [email protected]:usuario/repositorio.git

Opção 2: token de acesso pessoal (HTTPS)

Crie um token de acesso pessoal no GitHub e use-o no lugar da senha quando o Git pedir. Não salve o token em arquivos dentro da pasta pública do site.

Erro ao abrir o Git no painel

Se a tela do Git dá erro ou não carrega, e outras ferramentas do painel também falham, a causa costuma ser o limite de processos da conta atingido (por exemplo, por uma aplicação Node.js ou um build travado). Peça no ticket o encerramento dos processos travados e veja o artigo sobre o limite de processos.

Publicar pelo GitHub Actions ou outro CI

Para publicar por SSH a partir do GitHub Actions ou de outra ferramenta de CI, configure a conexão com o endereço da hospedagem, a porta 1157 e o usuário do painel. Prefira autenticação por chave SSH e guarde a chave nos segredos do CI.

Se não resolver

Abra um ticket no departamento Suporte Técnico e Dúvidas com:

• o painel (cPanel, DirectAdmin ou Plesk) e o domínio ou usuário;
• o endereço do repositório e se ele é público ou privado;
• a mensagem de erro completa (print).

Não envie senhas nem tokens no ticket.