11.08 Como registrar uma aplicação Passenger no Application Manager

Registrar uma aplicação Passenger no Application Manager serve para publicar oficialmente a aplicação no cPanel, ligando o código-fonte a um domínio, a uma URL base e a um ambiente de execução. Esse é o passo que transforma uma pasta de projeto em uma aplicação acessível pela web.
Na prática, registrar a aplicação significa informar ao cPanel onde está o código, em qual domínio ele deve responder e em qual caminho público ele será aberto pelo visitante.

Como acessar o cPanel

Antes de registrar a aplicação, acesse o cPanel usando um dos endereços abaixo:

  • https://seudominio.com.br/cpanel
  • https://seudominio.com.br:2083
  • pela área do cliente MyWay, através do atalho de login no cPanel
É importante que os arquivos da aplicação já estejam no servidor antes do registro, pois o Application Manager normalmente registra um projeto já existente.

Como registrar uma aplicação Passenger no Application Manager

Antes de começar

Antes do registro, confirme os pontos abaixo:

  • o recurso Application Manager está visível no cPanel
  • o código da aplicação já foi enviado ao servidor
  • você sabe em qual domínio ou subdomínio o app ficará disponível
  • o diretório do projeto está organizado corretamente
Registrar a aplicação sem conhecer o domínio correto ou o diretório real do projeto é um dos erros mais comuns durante a implantação.

Passo 1 – Abrir o Application Manager

No cPanel, vá até a seção Software e clique em Application Manager.

Ao abrir a ferramenta, procure a opção para registrar uma nova aplicação.

Passo 2 – Clicar em Register Application

Na interface do gerenciador, clique em Register Application.

Tradução útil:

  • Register Application = Registrar Aplicação

Isso abrirá o formulário de cadastro da aplicação.

Esse formulário é onde você define os dados principais de publicação do projeto.

Passo 3 – Definir o nome da aplicação

No campo Application Name, informe um nome identificador para o app.

Esse nome é usado para organização dentro do próprio gerenciador.

Exemplos práticos:

  • minha-api
  • sistema-interno
  • portal-python
Escolher um nome claro facilita bastante a administração quando há mais de uma aplicação registrada na mesma conta.

Passo 4 – Escolher o domínio de implantação

No campo Deployment Domain, selecione o domínio, addon domain ou subdomínio onde a aplicação será publicada.

Tradução útil:

  • Deployment Domain = Domínio de implantação

Exemplos:

  • domínio principal da conta
  • subdomínio como app.seudominio.com.br
  • addon domain adicionado à hospedagem
Se você escolher o domínio errado, a aplicação poderá ser publicada em um endereço diferente do esperado.

Passo 5 – Informar a URL base da aplicação

No campo Base Application URL, informe o caminho público da aplicação.

Exemplos comuns:

  • / para a raiz do domínio
  • /app para publicar em uma subpasta da URL
  • /api para uma API acessível por esse caminho

Tradução útil:

  • Base Application URL = URL base da aplicação
Esse campo define como o visitante chegará ao aplicativo no navegador.

Passo 6 – Informar o caminho da aplicação

No campo Application Path, informe o diretório do código-fonte relativo à pasta home da conta.

Exemplo prático:

  • se a aplicação estiver em /home/usuario/minhaapp, você normalmente informará algo como minhaapp

Tradução útil:

  • Application Path = Caminho da aplicação
Esse caminho precisa apontar para a pasta correta do projeto. Se estiver incorreto, a aplicação não será implantada corretamente.

Passo 7 – Escolher o ambiente

O formulário normalmente permite escolher o ambiente de execução:

  • Development = Desenvolvimento
  • Production = Produção

Em geral:

  • use Development durante testes e ajustes
  • use Production quando a aplicação já estiver pronta para uso real
Para ambientes públicos e aplicações em uso, a opção Production costuma ser a escolha mais adequada.

Passo 8 – Adicionar variáveis de ambiente, se necessário

Se o projeto exigir parâmetros extras, você poderá usar a área de Environment Variables.

Tradução útil:

  • Environment Variables = Variáveis de ambiente
  • Add Variable = Adicionar variável

Essas variáveis podem ser usadas para informar dados de configuração ao app.

Só adicione variáveis quando souber exatamente o que o projeto precisa. Parâmetros incorretos podem impedir a inicialização da aplicação.

Passo 9 – Clicar em Deploy

Depois de preencher todos os campos, clique em Deploy.

Esse passo conclui o registro e tenta publicar a aplicação com base nas informações fornecidas.

Quando tudo está correto, a aplicação passa a constar na lista do Application Manager e pode ser acessada pela URL configurada.

Como validar o registro

Após o deploy, confira:

  • se a aplicação aparece na listagem
  • se o domínio exibido está correto
  • se o caminho da aplicação confere com o projeto
  • se a URL abre no navegador
Essa validação final é essencial para confirmar que o registro foi feito corretamente e que a aplicação realmente entrou no ar.

Cuidados importantes

  • não registre uma aplicação em domínio errado
  • não informe caminho incorreto do projeto
  • não use URL base incompatível com a estrutura do app
  • não esqueça de revisar dependências e arquivos do projeto
Quando o registro falha, o problema quase sempre está em caminho, estrutura do projeto, dependências ou configuração inadequada do app.

Resultado esperado

Ao final do processo, a aplicação Passenger ficará registrada no Application Manager e disponível para administração futura.

O resultado esperado é:

  • registro da aplicação concluído
  • domínio e URL configurados
  • projeto associado ao caminho correto
  • publicação acessível via navegador
Depois disso, você poderá editar, monitorar, reaplicar ou remover o registro da aplicação diretamente pelo cPanel.

Resumo

Para registrar uma aplicação Passenger no Application Manager:

1. Acesse o cPanel
2. Entre em Application Manager
3. Clique em Register Application
4. Informe nome, domínio, URL base e caminho do projeto
5. Escolha o ambiente adequado
6. Adicione variáveis, se necessário
7. Clique em Deploy
8. Teste a URL da aplicação

Na prática, esse é o procedimento que publica oficialmente a aplicação na hospedagem.
Se a URL não abrir após o registro, revise primeiro o caminho da aplicação e a URL base informada no cadastro.

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

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

Artigos Relacionados

11.01 Como acessar o gerenciador de aplicações no cPanel

A opção Application Manager do cPanel serve para registrar, publicar e gerenciar aplicações...

11.02 Como visualizar aplicações instaladas

A opção Application Manager permite visualizar aplicações já registradas na hospedagem,...

11.03 Como editar configurações de aplicações

A opção de editar aplicações no Application Manager serve para alterar a configuração...

11.04 Como reiniciar aplicações hospedadas

Reiniciar aplicações hospedadas serve para fazer o Passenger recarregar a aplicação após...

11.05 Como remover aplicações do servidor

Remover aplicações do servidor pode significar duas coisas diferentes: desregistrar a...