Base de Conhecimento

9.15 Como configurar deployment de repositório Git no cPanel

Configurar deployment de repositório Git no cPanel serve para definir como e para onde os arquivos do projeto serão publicados a partir do Git™ Version Control.

Na prática, isso é feito com o arquivo .cpanel.yml, que contém as tarefas executadas durante o deploy.

Como acessar o cPanel

https://seudominio.com.br/cpanel
https://seudominio.com.br:2083
área do cliente MyWay

COMO CONFIGURAR DEPLOYMENT DE REPOSITÓRIO GIT NO CPANEL

O que é o arquivo .cpanel.yml

O arquivo .cpanel.yml é o responsável por dizer ao cPanel quais tarefas executar durante a publicação.

Ele deve ficar na raiz do repositório.

Sem um .cpanel.yml válido, o deployment não funcionará como esperado.

Passo 1 – Decidir o destino do deploy

Antes de escrever o arquivo, defina com clareza para onde o projeto será publicado, por exemplo:

public_html do domínio principal
uma pasta de subdomínio
um diretório específico de aplicação

Passo 2 – Criar o .cpanel.yml na raiz do projeto

Na raiz do repositório, crie o arquivo .cpanel.yml.

Ele deve conter a estrutura de deployment com as tarefas a serem executadas.

Evite criar o arquivo em subpastas erradas. O local esperado é a raiz do repositório.

Passo 3 – Definir tarefas de forma segura

As tarefas devem ser planejadas com cuidado. Em vez de tentar publicar tudo indiscriminadamente, o ideal é definir exatamente o que deve ir para produção.

Você pode organizar tarefas como:

definir variável de destino
copiar arquivos específicos
copiar diretórios necessários
executar ações complementares que façam sentido ao projeto

Não use estratégias amplas e descuidadas para copiar tudo do repositório, pois isso pode enviar a pasta .git ou outros itens desnecessários para o ambiente público.

Passo 4 – Versionar o arquivo

O ideal é manter o .cpanel.yml versionado junto ao projeto, para que a configuração de deployment acompanhe o histórico do código.

Isso traz previsibilidade, facilita revisão em equipe e reduz divergência entre o que está no repositório e o que o servidor espera executar.

Passo 5 – Validar as condições do deployment

Além do arquivo, o projeto precisa estar em condição adequada para deploy, com branches reconhecidos e árvore limpa.

Passo 6 – Testar o processo

Depois da configuração, use o fluxo de pull/deploy para validar se o conteúdo correto está chegando ao destino esperado.

Teste o site ou aplicação após a publicação.

Como usar isso na prática

Um cenário muito comum é:

desenvolvimento e commits no projeto
push para repositório remoto
pull no cPanel, quando necessário
deploy do HEAD para a pasta pública do site

Também existe o fluxo automático, em que o repositório gerenciado pelo cPanel reage a push direto quando existe .cpanel.yml.

Resultado esperado

Ao final, o repositório estará preparado para publicação controlada, previsível e alinhada ao fluxo de produção da hospedagem.

1. Defina o destino do deploy
2. Crie o arquivo .cpanel.yml na raiz do repositório
3. Configure tarefas seguras e objetivas
4. Versione o arquivo junto ao projeto
5. Valide branch, árvore limpa e estrutura do projeto
6. Teste o deploy no ambiente correto

Atenciosamente,
MyWay Hosting
Servidores Otimizados por inteligência artificial
www.myway.com.br

0 Usuários acharam útil