Base de Conhecimento

11.04 Como reiniciar aplicações hospedadas

Reiniciar aplicações hospedadas serve para fazer o Passenger recarregar a aplicação após alterações em arquivos, dependências ou configurações. Isso é essencial para que mudanças no projeto sejam realmente aplicadas ao ambiente em execução.

Na prática, reiniciar a aplicação significa forçar um novo carregamento do app, evitando que ele continue rodando com código antigo em memória.

Como acessar o cPanel

Antes de trabalhar com a aplicação, acesse o cPanel usando uma destas formas:

https://seudominio.com.br/cpanel
https://seudominio.com.br:2083
área do cliente MyWay, usando o acesso automático ao cPanel

Para que o reinício funcione corretamente, a aplicação já deve estar registrada e o código deve estar no local esperado pelo Application Manager.

Como reiniciar aplicações hospedadas

Entendendo o conceito de reinício

Em aplicações hospedadas com Passenger, reiniciar não significa necessariamente reiniciar todo o servidor.

Na maioria dos casos, significa pedir ao Passenger para:

descartar a instância atual
ler novamente o código
aplicar mudanças recentes
subir o processo da aplicação com a nova versão

Isso é especialmente importante após atualizar arquivos, instalar dependências ou alterar configuração do projeto.

Quando o reinício é necessário

Você normalmente deve reiniciar a aplicação quando:

editar arquivos do código
mudar a configuração do app
instalar novas dependências
corrigir um erro e publicar a correção
alterar arquivo de entrada ou rotas

Sem reiniciar, é comum a aplicação continuar servindo a versão anterior, dando a impressão de que a alteração “não funcionou”.

Forma 1 – Reimplantar pelo Application Manager

Em muitos casos, ao editar a aplicação e clicar em Deploy, o cPanel já reaplica a implantação e provoca o recarregamento necessário.

Por isso, um caminho comum é:

abrir o Application Manager
clicar em Edit
revisar ou manter os campos
clicar em Deploy

Esse método é útil quando você também precisa ajustar parâmetros da aplicação e aproveitar para reaplicar a configuração.

Forma 2 – Reinício pelo arquivo restart.txt

Em aplicações Passenger, uma forma bastante conhecida de reiniciar o app é criar ou atualizar o arquivo:

tmp/restart.txt

Isso sinaliza ao Passenger que a aplicação deve ser recarregada.

Esse método é muito usado após alterações no código, especialmente quando você já sabe exatamente em qual pasta o projeto está instalado.

Como fazer isso na prática

Se a sua aplicação estiver em uma pasta como minhaapp, normalmente o arquivo ficará em:

minhaapp/tmp/restart.txt

Você pode fazer isso por:

SSH
Terminal do cPanel
Gerenciador de Arquivos, criando ou atualizando o arquivo

A pasta tmp precisa existir dentro da estrutura da aplicação. Em muitos projetos ela já existe, mas em alguns cenários pode ser necessário verificar a estrutura do framework.

Exemplo prático de uso

Imagine que você alterou um arquivo importante da aplicação e quer garantir que a nova versão entre em uso.

O procedimento típico é:

salvar os arquivos alterados
confirmar que estão no diretório correto
forçar o restart da aplicação
testar novamente no navegador

Esse processo reduz a chance de você diagnosticar um erro antigo achando que ele pertence ao novo código.

Como validar se o reinício funcionou

Depois do reinício, faça os seguintes testes:

atualize a página no navegador
confira se a nova alteração apareceu
verifique se o erro anterior desapareceu
teste rotas importantes da aplicação

Quando possível, também consulte os logs da aplicação para verificar se ela subiu novamente sem falhas.

Problemas comuns ao tentar reiniciar

alteração feita no diretório errado
arquivo restart.txt criado fora da pasta tmp
dependências faltando
erro de código impedindo a inicialização
estrutura da aplicação incompleta

Se a aplicação não voltar corretamente após o reinício, o problema pode não ser o restart em si, mas sim um erro interno do projeto ou dependência ausente.

Cuidados importantes

reiniciar não corrige erro de código automaticamente
o restart apenas aplica de novo o que está no projeto atual
sempre teste após reiniciar
se houver alteração estrutural grande, valide arquivos e dependências antes

Muitos usuários reiniciam várias vezes sem perceber que a aplicação está com problema de caminho, importação ou biblioteca ausente.

Resultado esperado

Ao final do processo, a aplicação deverá ser recarregada e passar a usar a versão atual do código e da configuração.

O resultado esperado é:

mudanças refletidas no site
novo carregamento da aplicação
redução de inconsistências entre código salvo e app em execução

Quando o reinício ocorre corretamente, a aplicação publicada passa a responder de acordo com o estado atual do projeto.

Resumo

Para reiniciar aplicações hospedadas:

1. Confirme que a aplicação está registrada
2. Salve suas alterações de código ou configuração
3. Reimplante pelo Application Manager ou use o arquivo tmp/restart.txt
4. Atualize a URL da aplicação no navegador
5. Verifique logs e funcionamento geral

Na prática, isso força o Passenger a recarregar a aplicação com a versão mais recente do projeto.

Se a aplicação continuar igual após o restart, confira se os arquivos realmente foram alterados no diretório correto da aplicação.

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

0 Usuários acharam útil