Como funciona o deploy automático por push no Git Version Control do cPanel

Como funciona o deploy automático por push no Git Version Control do cPanel

O que é?
O deploy automático por push é um fluxo em que as alterações enviadas para um repositório gerenciado pelo cPanel são implantadas automaticamente, desde que o repositório esteja configurado corretamente para deployment.
Para que serve?
  • Automatizar a publicação de alterações no site
  • Reduzir etapas manuais no processo de deploy
  • Integrar o Git ao fluxo de atualização da hospedagem
  • Facilitar o uso do Git Version Control em projetos com versionamento
Observação: O cPanel documenta que, em um cenário de push deployment, o sistema pode implantar automaticamente as mudanças enviadas ao repositório gerenciado pelo cPanel quando o arquivo .cpanel.yml já estiver presente e válido.

1) Entenda onde esse recurso fica no cPanel

O gerenciamento do repositório acontece em:

Arquivos (Files) > Git Version Control

É nessa interface que o cPanel gerencia os repositórios hospedados na conta.


2) Saiba o que é push deployment

Segundo a documentação oficial, no modelo de push deployment, você primeiro atualiza seu repositório local e depois envia essas alterações para o repositório gerenciado pelo cPanel.

Na prática:
você faz o push para o repositório da conta cPanel, e o sistema pode disparar automaticamente a implantação das mudanças.

3) Tenha um repositório gerenciado pelo cPanel

Antes do deploy automático funcionar, você precisa já ter um repositório criado ou hospedado na interface Git Version Control.


4) Garanta que o arquivo .cpanel.yml exista

O cPanel exige um arquivo .cpanel.yml válido e versionado no diretório principal do repositório para habilitar o deployment.

Importante: Sem esse arquivo, o cPanel não exibirá as informações de deployment e desativará a funcionalidade.

5) Faça o push para o repositório gerenciado pelo cPanel

No fluxo recomendado pelo cPanel, o repositório da conta cPanel recebe as alterações por push.

Exemplo citado na documentação

git push -u origin HEAD


6) Entenda o que dispara o deploy automático

O cPanel informa que adiciona automaticamente um post-receive hook em todos os repositórios gerenciados por ele. Esse hook executa os comandos definidos no .cpanel.yml sempre que as mudanças são implantadas.

Resultado esperado:
Após o push para o repositório gerenciado pelo cPanel, o sistema executa as tarefas definidas no .cpanel.yml e atualiza os arquivos no destino configurado.

7) Evite editar diretamente o repositório gerenciado pelo cPanel

O guia de troubleshooting do cPanel recomenda fortemente que você faça deploy a partir de um repositório remoto ou de um clone local, e não altere diretamente o conteúdo do repositório gerenciado pelo cPanel.

Atenção: Alterar diretamente o repositório gerenciado pelo cPanel pode atrapalhar o fluxo de deployment e dificultar o controle das mudanças.

8) Verifique os requisitos básicos

Checklist para o deploy automático funcionar
  • Arquivo .cpanel.yml válido no diretório principal
  • Uma ou mais branches locais ou remotas
  • Working tree limpa
  • Repositório já gerenciado pelo cPanel

9) Resumo prático

Resumo:
O deploy automático por push no cPanel funciona quando você envia mudanças para um repositório gerenciado pelo Git Version Control e esse repositório possui um arquivo .cpanel.yml válido. O sistema usa um post-receive hook para executar automaticamente as tarefas de implantação.

Em caso de dúvidas, abra um ticket de suporte.
Estamos à disposição para ajudar.

Atenciosamente,
MyWay Hosting
www.myway.com.br

  • 0 Usuários acharam útil
Esta resposta lhe foi útil?

Artigos Relacionados

Como usar o Terminal do cPanel

Como usar o Terminal do cPanel O que é?O Terminal do cPanel é um recurso que permite...

Como descobrir o usuário, hostname e porta para acesso SSH

Como descobrir o usuário, hostname e porta para acesso SSH O que é?Para conectar via...

Como usar o Git Version Control do cPanel

Como usar o Git Version Control do cPanel O que é?O Git Version Control do cPanel...

Como clonar um repositório Git privado na hospedagem via SSH

Como clonar um repositório Git privado na hospedagem via SSH O que é?Clonar um...

Como revogar uma chave SSH no cPanel

Como revogar uma chave SSH no cPanel O que é?Revogar uma chave SSH significa remover a...