Neste tutorial você verá as principais restrições e limitações do recurso Git Version Control (Controle de Versão do Git) no cPanel, para evitar erros na criação, clonagem e gerenciamento de repositórios.
1. O Git do cPanel não funciona exatamente como o Git padrão
A documentação oficial informa que o recurso Git Version Control do cPanel possui algumas diferenças em relação à configuração padrão do Git e também impõe certas restrições aos repositórios hospedados na conta.
Isso significa que um repositório pode existir no servidor e ainda assim não aparecer ou não funcionar como esperado dentro da interface do cPanel.
2. Sem acesso Shell, os recursos ficam limitados
Sem acesso Shell, o cPanel permite apenas ações mais básicas, como:
- criar repositórios;
- clonar repositórios;
- excluir repositórios;
- visualizar informações.
3. O cPanel impõe restrições em clone URLs
Ao clonar repositórios pelo Git Version Control, o cPanel informa que existem restrições nas clone URLs.
Além disso, para URLs no formato
Além disso, para URLs no formato
ssh://, o sistema verifica as chaves públicas SSH do host remoto.4. Nem todo caminho é aceito
O repositório precisa estar em um caminho aceitável para o cPanel. Se ele estiver em uma pasta controlada pelo sistema ou em um caminho inválido, a interface pode não exibir esse repositório corretamente.
5. Nem todo nome ou caminho é aceito
O cPanel também aplica restrições aos nomes e caminhos usados nos repositórios. Certos caracteres não são permitidos, e isso pode impedir o gerenciamento correto do repositório pela interface.
6. URLs com usuário e senha não devem ser usadas
A documentação do cPanel informa que a interface do Git Version Control não permite URLs remotas com par de usuário e senha embutidos na URL.
7. Repositórios privados exigem configuração adicional
Se o repositório for privado, o acesso geralmente exige etapas extras, principalmente relacionadas a SSH Access (Acesso SSH) e chaves SSH autorizadas.
Se essas etapas extras não forem feitas, você poderá receber falhas ao clonar, puxar ou enviar alterações.
8. O deployment depende de arquivo .cpanel.yml
Para usar deployment em repositórios gerenciados pelo cPanel, é necessário que exista um arquivo
.cpanel.yml no diretório principal do repositório. Sem esse arquivo, o fluxo de publicação não fica configurado.9. Resumo prático
Antes de usar o Git Version Control no cPanel, verifique sempre:
- se a conta possui acesso Shell;
- se o caminho do repositório é válido;
- se o nome do repositório não contém caracteres proibidos;
- se a clone URL é aceita;
- se o repositório privado tem acesso SSH configurado;
- se o
.cpanel.ymlexiste quando houver deployment.
Pronto! Agora você já conhece as principais restrições e limitações do Git Version Control no cPanel.
