Registrando seu aplicativo Node.JS no cPanel Application Manager
O registro informa ao gerenciador de aplicativos do Passenger e ao cPanel onde encontrar seu aplicativo e qual domínio você gostaria de usar.
No cPanel, abra o Application Manager, que você encontrará em Software na página principal.
Clique no botão Registrar Aplicativo .
Na tabela Application Configuration , precisamos fornecer quatro informações:
- Nome do aplicativo: um nome de exibição para o aplicativo. Você pode escolher qualquer nome, mas deve começar com um número ou letra e não pode conter pontos.
- Domínio de implantação: o nome de domínio do aplicativo. O domínio já deve estar associado à conta cPanel.
- URL base do aplicativo: a página inicial do aplicativo estará disponível no domínio de implantação + a URL base. Por exemplo, se o domínio de implantação for “example.com” e você inserir “nodeapp” nesse campo, o aplicativo será exibido em “example.com/nodeapp”. A extensão da URL não precisa ser a mesma do diretório que armazena os arquivos do app.
- Caminho do aplicativo: a localização dos arquivos do aplicativo em relação à casa do usuário. Em nosso exemplo, criamos um diretório em home chamado “nodejsapp”, portanto, inseriríamos “nodejsapp” aqui.
O seletor Deployment Environment indica se o aplicativo está em desenvolvimento ou pronto para implantação em um ambiente de produção.
Abaixo da tabela de configuração do aplicativo , há uma interface para configurar as variáveis de ambiente. Vamos analisá-los com mais profundidade na próxima seção.
Por enquanto, clicaremos no botão Deploy na parte inferior da página e o cPanel configurará o ambiente e o domínio do aplicativo. Depois de concluído, você pode abrir seu novo aplicativo em um navegador da Web no URL que acabou de configurar: “example.com/nodeapp” em nossos exemplos.
Ao contrário de um aplicativo real, nosso one-pager não possui dependências externas. Se tivesse, o cPanel Application Manager exibiria o botão Garantir dependências para instalação com um clique. O botão está disponível apenas para aplicativos com um arquivo package.json que lista as dependências.
Se você está seguindo nossos exemplos e gostaria de ver as Dependências de Garantia em ação, adicione um arquivo chamado package,json ao diretório do aplicativo com o seguinte conteúdo:
{
"name": "nodejsapp",
"version": "1.0.0",
"description": "A Node App",
"main": "app.js",
"author": "",
"license": "ISC",
"dependencies": {
"express": "^4.17.1"
}
}Como você pode ver, listamos a estrutura da Web Express como uma dependência. O botão Garantir Dependências agora deve estar disponível no Gerenciador de Aplicativos. Quando você clica nele , o cPanel instala o Express e todos os aplicativos e bibliotecas dos quais ele depende.
Adicionando variáveis de ambiente ao ambiente do seu aplicativo Node.JS
Variáveis de ambiente são pares nome-valor que armazenam um pedaço de informação. Eles funcionam como variáveis em programação, exceto que não são internos ao programa, mas parte de seu ambiente externo. Os servidores usam variáveis de ambiente para armazenar dados de configuração úteis.
Por exemplo, o CentOS usa a variável de ambiente PATH para armazenar uma lista de diretórios que contêm programas de linha de comando. Quando você insere um comando como “ls”, o shell procura nesses diretórios um arquivo executável com esse nome. Se não houvesse variável PATH, você teria que inserir o caminho completo de cada comando: “/usr/bin/ls” em vez de apenas “ls”.
O administrador do servidor pode alterar a variável de ambiente PATH, controlando os diretórios que o shell procura sem modificar seu código interno. Com o Application Manager do cPanel , você pode adicionar variáveis de ambiente ao ambiente do seu aplicativo Node.js para configurar seu comportamento da mesma forma.
Em nosso arquivo app.js simples , essa linha de JavaScript informa ao aplicativo a porta em que ele deve escutar as conexões.
const port = 3000;Na realidade, é improvável que um desenvolvedor saiba a porta correta ao escrever o código. Para dar mais flexibilidade aos usuários, eles podem dizer ao aplicativo para procurar em seu ambiente uma variável chamada PORT e usar seu valor ao configurar o aplicativo.
No Node.js, o código JavaScript é mais ou menos assim:
const PORT = process.env.PORT || 3000;Isso define a variável PORT interna do aplicativo para o valor da variável de ambiente chamada PORT ou para um padrão de 3000 se uma variável de ambiente não estiver definida.
Agora, o usuário pode informar ao aplicativo a qual porta se conectar definindo uma variável PORT no ambiente do aplicativo. Para fazer isso no Gerenciador de aplicativos do cPanel , localize a interface Variáveis de ambiente abaixo de Configuração do aplicativo e clique em Adicionar variável.
Insira um nome e valor de variável e clique em Salvar.
Editando seu aplicativo Node.JS
Você pode editar a configuração de registro de um aplicativo Node no Application Manager.
Clique no link Editar na coluna Ações . Nesta interface, você pode editar todos os valores definidos ao registrar seu aplicativo pela primeira vez, incluindo as variáveis de ambiente.
Desinstalando seu aplicativo Node.JS
Para desinstalar ou “cancelar o registro” de um aplicativo Node.js do cPanel, clique no link cancelar registro à direita da tabela do Gerenciador de aplicativos .
Quando você cancela o registro de um aplicativo, o cPanel o remove da lista, exclui seu arquivo de configuração e o dissocia do domínio. O cPanel não exclui os arquivos do aplicativo, mas você mesmo pode excluí-los no Gerenciador de Arquivos ou na linha de comando.
