Publicar uma aplicação no EasyPanel a partir do repositório ou de uma imagem

Há três origens possíveis: um repositório de código, uma imagem pronta ou um arquivo de construção do seu projeto. Partindo do repositório, o painel detecta a linguagem sozinho e monta a imagem — você não precisa escrever arquivo de construção para projetos comuns em PHP, Node.js, Python, Ruby, Go ou Java.

Qual origem escolher

• Repositório — para código seu. Cada publicação parte de um ramo, e atualizar é enviar o código e mandar construir de novo.
• Imagem pronta — para programas de terceiros que já publicam imagem oficial. É o caminho mais rápido e o que menos exige de você.
• Arquivo de construção próprio — quando o projeto tem exigência que a detecção automática não cobre, como uma biblioteca de sistema específica.

O que a aplicação precisa respeitar

Duas regras evitam a maioria dos casos de aplicação que sobe e não responde. A primeira: ouvir no endereço interno geral, e não apenas no endereço local — quem escuta só localmente fica inalcançável de fora do contêiner. A segunda: usar a porta informada pelo ambiente em vez de uma porta fixa escrita no código.

Variáveis de ambiente

Tudo o que muda entre a sua máquina e o servidor vai para as variáveis do serviço: dados do banco, chaves de serviços externos, endereço do site. Elas ficam no painel, fora do código — que é como deve ser. Depois de alterar uma variável, a aplicação precisa ser reiniciada para enxergá-la.

Arquivos que precisam sobreviver

Contêiner é descartável: ao publicar uma versão nova, o anterior é substituído e o que estava gravado dentro dele se perde. Pastas com arquivos enviados por usuários precisam ser declaradas como volume, para viverem fora do contêiner. Esquecer isso é o erro mais caro dessa arquitetura — e ele só aparece na segunda publicação.

Quando a construção falha

O registro da construção mostra o passo exato em que parou. As causas comuns são dependência declarada com versão que não existe, arquivo de trava desatualizado em relação ao arquivo de dependências, e falta de memória durante a montagem — esta última, frequente em servidor pequeno, resolve-se construindo em outro lugar e publicando a imagem pronta.