Como verificar se o arquivo .cpanel.yml está válido para deployment no cPanel
O que é?
O arquivo
O arquivo
.cpanel.yml define como e para onde o cPanel implantará as alterações do repositório durante o deployment.Para que serve?
- Definir as tarefas de deployment
- Controlar o destino dos arquivos implantados
- Permitir que o cPanel habilite o recurso de deployment
- Automatizar a cópia e organização dos arquivos do projeto
Observação: O cPanel exige um arquivo
.cpanel.yml válido, versionado e no diretório principal do repositório. Sem isso, a interface não exibirá as informações de deployment e a função ficará desabilitada.1) Confirme onde o arquivo deve ficar
O .cpanel.yml precisa estar no diretório principal do repositório, também chamado de diretório de topo.
2) Verifique se o arquivo foi versionado
O cPanel exige que o arquivo esteja checked-in no repositório, ou seja, ele precisa fazer parte do versionamento Git.
Importante: Criar o arquivo no servidor sem commitá-lo no repositório pode não atender ao requisito documentado pelo cPanel.
3) Revise a estrutura do arquivo
O arquivo precisa usar a estrutura YAML esperada pelo cPanel para deployment.
Exemplo oficial simplificado
---
deployment:
tasks:
- export DEPLOYPATH=/home/user/public_html/
- /bin/cp index.html $DEPLOYPATH
- /bin/cp style.css $DEPLOYPATH4) Confirme se as tarefas fazem sentido
As tarefas definidas em deployment: e tasks: devem apontar para caminhos e comandos válidos dentro da sua conta.
Atenção: Caminhos errados ou comandos mal definidos podem impedir a implantação correta dos arquivos.
5) Confira os requisitos adicionais do repositório
Além do .cpanel.yml, o cPanel exige:
- uma ou mais branches locais ou remotas
- working tree limpa
Se o repositório não atender a esses requisitos, o deployment ficará desabilitado.
6) Verifique a interface Git Version Control
No cPanel, acesse:
Arquivos (Files) > Git Version Control
Depois abra o repositório desejado e veja se as informações de deployment estão disponíveis.
Resultado esperado:
Se o
Se o
.cpanel.yml estiver válido e os demais requisitos forem atendidos, o cPanel exibirá as informações de deployment e permitirá a implantação.7) O que revisar se não funcionar
Checklist rápido
- Arquivo no diretório principal do repositório
- Arquivo versionado no Git
- Estrutura YAML válida
- Tarefas de deploy coerentes
- Branch existente
- Working tree limpa
8) Resumo prático
Resumo:
Para verificar se o arquivo
Para verificar se o arquivo
.cpanel.yml está válido para deployment no cPanel, confirme que ele está no diretório principal, foi versionado no repositório, usa a estrutura YAML esperada e que o repositório também possui branch e working tree limpa.Em caso de dúvidas, abra um ticket de suporte.
Estamos à disposição para ajudar.
Estamos à disposição para ajudar.
Atenciosamente,
MyWay Hosting
www.myway.com.br
