No cPanel, o Node.js configura-se em «Setup Node.js App». A ferramenta oferece 13 versões, de 10.24.1 a 24.x, e cada aplicação escolhe a sua. O ponto principal é este: a versão tem de ser a que o seu código espera, e se a mudar, as dependências têm de ser instaladas outra vez. Este artigo trata de escolher a versão e de usar o npm. Para pôr uma aplicação a correr de raiz, veja pôr uma aplicação Node.js a funcionar.
Escolher e mudar a versão
| 1 |
Descubra o que o projecto pede. No package.json procure o campo engines; se não existir, leia o README do projecto. Uma aplicação feita para uma versão recente pode nem arrancar numa antiga.
|
|
| 2 |
Abra «Setup Node.js App» no cPanel (secção Software) e crie a aplicação, ou abra a que já tem. No campo da versão do Node.js escolha a que o projecto pede. Para um projecto novo, a regra geral é a versão de suporte prolongado (LTS) mais recente que a lista tenha; as datas de suporte estão em nodejs.org.
|
|
| 3 |
Escolha o modo (desenvolvimento ou produção), a raiz da aplicação, o endereço, e o ficheiro de arranque. Guarde.
|
|
| 4 |
Instale as dependências: no ecrã da aplicação, o botão «Run NPM Install» lê o package.json e instala. Não envie a pasta node_modules por FTP: o cPanel gere-a por si, no ambiente virtual da aplicação.
|
|
| 5 |
Reinicie. O botão de reinício aplica as alterações. Sem ele, a aplicação continua com o código e a versão antigos.
|
|
Usar o npm a partir da linha de comandos
Se a sua conta tem acesso por terminal (depende da conta; há o Terminal do cPanel), o ecrã da aplicação mostra, no topo, o comando para entrar no ambiente virtual da aplicação: um source de um ficheiro activate dentro de uma pasta nodevenv. Copie-o tal como lá está. Depois de entrar, o node e o npm passam a ser os da versão escolhida:node -v
npm -v
npm install
npm run build
npm ls
| Comando |
Para quê |
node -v |
Confirma a versão do Node.js em que está. |
npm install |
Instala as dependências do package.json. |
npm ci |
Instala exactamente o que o package-lock.json diz, de raiz. É o indicado para repetir uma instalação. |
npm run build |
Corre o script de construção do projecto, se ele tiver um (muitos frameworks têm). |
npm ls |
Mostra as dependências instaladas e acusa as que faltam. |
|
Mudou a versão do Node.js? Reinstale as dependências. Algumas dependências trazem partes compiladas para uma versão específica. Se trocar de versão e não correr outra vez o «Run NPM Install» (ou npm ci), a aplicação pode arrancar com erros estranhos ou nem arrancar. Se a aplicação deixa de abrir e o erro é 503, vá a erro 503 numa aplicação Node.js.
|
|
Há limites na conta. Uma pasta node_modules tem milhares de ficheiros pequenos e pode bater no limite de inodes da conta. Veja os limites que ninguém anuncia. E não use sudo nem instalações globais (npm install -g): numa conta partilhada não há root.
|
|
A versão que precisa não aparece na lista, ou o botão de instalação dá erro? Diga-nos o domínio e a mensagem, e vemos o lado do servidor.
Abrir um pedido de suporte
|
PRODUTO RECOMENDADO Alojamento de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 5.940,00 Kz/mês (plano de 3 anos, com cupão) Ver planos |
Português
English
