Poiché JavaScript è diventato uno dei linguaggi di programmazione più popolari per la creazione di applicazioni Web, molti dei nostri clienti hanno imparato ad amare il linguaggio.
Ma per creare applicazioni server e browser scalabili, spesso vogliono usare Node.js.
Questo ambiente multipiattaforma open source rockstar consente il rapido sviluppo di applicazioni, che porta a un'elevata produttività e quindi a un'implementazione più rapida.
Web Hosting Magic offre un hosting web scalabile e sicuro, spesso descritto dai nostri clienti come "un'ottima alternativa al VPS “.
Il nostro selettore Node.js ti consente, come sviluppatore JavaScript, di avere lo spazio web e le risorse necessarie per la tua applicazione, riducendo al minimo i problemi di gestione delle applicazioni.
Come installare un'applicazione Node.js utilizzando il selettore Node.js
Selettore Node.js è un componente di CloudLinux che consente a ciascun utente di creare facilmente applicazioni Node.js, scegliere la versione di Node.js e altri parametri per le applicazioni in base alle proprie esigenze.
Con un'interfaccia utente intuitiva, unisce tutte le funzionalità in un unico posto e lo rende molto comodo da gestire.
Al momento della stesura di questo, il nostro selettore Node.js supporta le versioni Node.js 11.x, 12.x, 14.x e altre versioni successive.
Il selettore Node.js presenta molti vantaggi rispetto alla distribuzione manuale.
Consente l'esecuzione di diverse applicazioni con lo stesso utente, accessibile tramite la "App Node.js di installazione ” nel tuo account cPanel.
Il passeggero Phusion viene utilizzato per il trasferimento delle applicazioni, quindi non sarà necessario impostare alcun reindirizzamento .htaccess per dire al server web di inoltrare alla porta dell'applicazione.
Con Node.js Selector, tutto questo viene gestito per te.
Per iniziare, vai su cPanel → Sezione Software → Seleziona versione Node.js .
Verrà visualizzata la pagina Applicazioni Web e vedrai diverse colonne nell'elenco.
URI dell'app:URI dell'applicazione incluso il dominio.
- App Root Directory:directory principale dell'applicazione relativa alla home dell'utente.
- Modalità:può essere produzione o sviluppo.
- Stato:avviato/arrestato:mostra se un'applicazione è in esecuzione o meno e la versione dell'applicazione.
- Azioni:consente di avviare, riavviare, interrompere, modificare e rimuovere una particolare applicazione.
Crea un account cPanel
Prima di poter accedere e utilizzare cPanel per le tue implementazioni Node.js, devi disporre di un account cPanel.
Per creare un account cPanel, visita https://dashboard.webhostingmagic.com/cart.php?gid=1 e seleziona un pacchetto di hosting.
Il nostro sistema ti guiderà attraverso il processo che richiede meno di 5 minuti per ottenere i tuoi accessi cPanel.
Come creare un'applicazione Node.js
Prima di poter configurare la tua applicazione Node.js, dovrai portare quell'applicazione sul tuo server cPanel.
Puoi semplicemente utilizzare SFTP per caricare una copia della tua applicazione sul tuo server.
Oppure puoi anche utilizzare il supporto Git nativo di cPanel per clonare il repository sul tuo server e distribuirlo da lì.
L'esempio seguente ha utilizzato il supporto Git nativo di cPanel per clonare l'applicazione sul server e quindi distribuirla.
Clone l'applicazione
- Accedi a cPanel.
- Nel pannello File, vedi l'interfaccia Terminale di cPanel (cPanel – Home – Avanzate – Terminale).
- Fai clic su di esso per vedere dove puoi creare un repository Git.
- Ora torna su Github e clona con HTTPS usando l'URL web. Per proteggere i dati della tua applicazione assicurati di non clonare o caricare nella cartella public_html poiché ciò rende il codice stesso potenzialmente accessibile dal web. Il nostro sistema si impegna a mantenere i tuoi dati al sicuro e, durante l'implementazione, non è necessario che i dati delle tue applicazioni siano pubblicamente accessibili.
Clonazione su un server cPanel da un repository Github privato
I repository privati richiedono l'accesso SSH, devi eseguire passaggi aggiuntivi per clonare un repository remoto ospitato privatamente.
Puoi utilizzare l'interfaccia Terminale di cPanel (cPanel – Home – Advanced – Terminal) per accedere alla riga di comando dall'interfaccia di cPanel.
Genera una chiave SSH
Se non ne hai già configurato uno, esegui il seguente comando per generare una chiave SSH:
ssh-keygen -t rsa -b 4096 -C "[email protected]"
In questo esempio, "nome utente ” rappresenta il nome utente dell'account cPanel e “example.com ” rappresenta il nome di dominio.
Dopo aver eseguito questo comando, il sistema ti chiederà di inserire una passphrase.
Non inserire una passphrase.
Premi Invio per continuare.
Verifica che la chiave sia disponibile
Per confermare che la chiave esiste e si trova nella posizione corretta, esegui il comando seguente:
cat ~/.ssh/id_rsa.pub
Registra la nostra chiave SSH con l'host del repository privato
Per registrare una chiave SSH con GitHub, procedi nel seguente modo:
- Accedi al tuo account GitHub.
- Vai al tuo repository privato.
- Nell'angolo in alto a destra della pagina, fai clic su Impostazioni. Apparirà una nuova pagina.
- Nel menu a sinistra, fai clic su Distribuisci chiavi. Apparirà una nuova pagina.
- Nell'angolo in alto a destra della pagina, fai clic su Aggiungi chiave di distribuzione. Apparirà una nuova pagina.
- Inserisci i dati della tua chiave SSH:
- Nella casella di testo Titolo, inserisci un nome visualizzato per la chiave.
- Nella casella di testo Chiave, incolla l'intera chiave SSH.
Se desideri inviare il codice dal tuo account cPanel al tuo account GitHub, seleziona "Consenti accesso in scrittura casella di controllo.
Se non selezioni questa casella di controllo, puoi distribuire le modifiche solo dal tuo repository GitHub al repository ospitato da cPanel.
- Fai clic su Aggiungi chiave.
Tieni presente che alcuni host di repository non ti consentono di configurare l'accesso in scrittura per le tue chiavi di accesso.
Per informazioni su come registrare la tua chiave SSH con un altro host di repository privato (Bitbucket, GitLab, ecc.), consulta il sito Web o la documentazione di tale host.
Testare la chiave SSH
Per testare la tua chiave SSH, esegui il comando seguente.
ssh -T [email protected]
dove "example.com" rappresenta l'host del repository privato, ad esempio ssh -T [email protected].
Clone il repository su cPanel
Per clonare il repository, esegui il comando seguente sull'account cPanel, dove "git clone [email protected]:$name/private-repo.git ” rappresenta l'URL clone del repository privato:
git clone [email protected]:$name/private-repo.git
Se viene visualizzato "Errore:l'handshake WebSocket non è riuscito a... ” quando accedi all'interfaccia Terminale di cPanel (cPanel – Home – Advanced – Terminal), ricontrolla la connessione.
Se stai usando una VPN, disconnetti e usa la tua normale connessione Internet.
Dopo aver fatto clic su "Crea ” questo ti riporterà alla pagina del repository che mostra il percorso completo dell'applicazione in fase di distribuzione.
Questa pagina è importante, quindi salva quel percorso per un uso successivo.
Per ricapitolare:
- Seleziona una versione di Node.js.
- Seleziona "Sviluppo" o "Produzione" per la modalità dell'applicazione.
- Seleziona la radice dell'applicazione. Deve essere un indirizzo fisico della tua applicazione su un server che corrisponde al suo URI.
- Seleziona l'URL dell'applicazione. Questo è un collegamento HTTPS alla tua applicazione.
- Compila il modulo per puntare al file di avvio dell'applicazione. Puoi anche aggiungere ulteriori variabili d'ambiente facendo clic su "Aggiungi variabile".
- Fai clic su Crea.
... una spiegazione più dettagliata.
Configurazione dell'applicazione Node.js
Con i file dell'applicazione sul server, sei pronto per configurare Node.js per avviare quell'applicazione dal Web.
Da cPanel sullo stesso account in "Software ”, seleziona “Imposta app Node.js ”.
In questa schermata di configurazione, selezionerai "Crea applicazione ” per visualizzare le opzioni per scegliere la versione di Node.js e se utilizzare uno Sviluppo o Produzione ambiente.
Lo sviluppo ha generalmente diversi hook dell'applicazione nel codice dell'applicazione, a seconda di come è impostata questa variabile di ambiente.
Come regola generale, Produzione avrà più livelli di memorizzazione nella cache, oltre a una registrazione minima.
Quindi, per un ambiente di sviluppo impostato, puoi aspettarti il contrario, con meno livelli di memorizzazione nella cache dell'applicazione e registrazione più dettagliata e output di messaggi di errore.
Un tipico esempio potrebbe essere dove, se si tratta di un ambiente di produzione, potresti visualizzare solo una pagina di errore.
In fase di sviluppo, potresti vedere una traccia completa dello stack su un errore dell'applicazione che ti consente di capire esattamente dove si è verificato l'errore all'interno del codice.
Poiché le applicazioni Node.js, in generale, dipendono da diverse variabili di ambiente, puoi aggiungerle utilizzando "Aggiungi variabile ” vicino alla parte inferiore destra della pagina.
La variabile di produzione o sviluppo di Node.js è già impostata separatamente nella sezione superiore utilizzando la "Modalità applicazione ”, quindi non è necessario reimpostarlo nella sezione Variabili d'ambiente.
Nello stesso menu puoi selezionare la versione di Node.js che desideri utilizzare e il file di avvio dell'applicazione.
Potrebbe essere index.js , app.js, o qualsiasi numero di variazioni; dipende dall'applicazione.
Dopo aver salvato la tua applicazione, dovrai risolvere le sue dipendenze dal pacchetto.
Il gestore di pacchetti NPM lo fa automaticamente in base al file package.json incluso nell'applicazione, quindi tutto ciò che devi fare qui è fare clic sul pulsante "Installazione NPM".
A questo punto, richiederai che il tuo dominio si risolva in un indirizzo IP, altrimenti lo script di installazione visualizzerà un errore.
Se stai utilizzando un sottodominio, assicurati di averlo creato e di aver aggiunto tutti i record rilevanti al tuo DNS.
Puoi confermarlo semplicemente eseguendo:
$ dig sub-domain.com
NPM leggerà il contenuto del file package.json e installerà i pacchetti necessari in un ambiente virtuale specifico per l'applicazione.
Se hai familiarità con la riga di comando, puoi seguire le istruzioni nella parte superiore della pagina per accedere ai comandi "npm" e "node" per apportare ulteriori modifiche manualmente, consentendo una grande personalizzazione.
Distribuzione dell'applicazione Node.js
A questo punto, avrai la tua applicazione configurata e i moduli Node.js installati, quindi sarai pronto per avviare l'applicazione.
I nostri sistemi cPanel lo rendono molto semplice.
Nella stessa pagina in cui hai configurato l'applicazione, fai clic su "Esegui script JS ”
Questo eseguirà il file di avvio dell'applicazione che hai definito in precedenza durante l'installazione.
Poiché le applicazioni Node.js hanno diverse opzioni, questo può far apparire un altro menu con diverse opzioni da selezionare a seconda dell'applicazione in esecuzione.
In generale, ti consigliamo di selezionare "Inizia ” opzione successiva.
Infine, puoi selezionare "Apri ” opzione per visitare la tua pagina e vedere la tua applicazione!
Come avviare un'applicazione Node.js
Per avviare un'applicazione interrotta, procedi come segue:
Fai clic su Inizia icona nella colonna Azioni in una riga dell'applicazione interrotta.
Quando l'azione è completata, un'icona Avvia cambia nell'icona Interrompi.
Come interrompere un'applicazione Node.js
Per interrompere un'applicazione avviata, procedi come segue:
Fai clic su Interrompi icona nella colonna Azioni in una riga dell'applicazione avviata.
Al termine dell'azione, l'icona Interrompi diventa l'icona Avvia.
Come avviare un'applicazione Node.js
Per riavviare l'applicazione, procedi come segue:
Fai clic su Riavvia icona nella colonna Azioni in una riga dell'applicazione avviata.
La riga corrente verrà bloccata e verrà sbloccata al termine del processo.
Come rimuovere un'applicazione Node.js
Per rimuovere l'applicazione, procedi come segue:
Fare clic sull'icona "Cestino" nella colonna Azioni in una particolare riga dell'applicazione.
nella finestra di conferma, fai clic su Accetto per iniziare la rimozione o su Annulla per chiudere la finestra.
Al termine dell'azione, un'applicazione verrà rimossa dalla tabella Applicazioni Web e verrà visualizzato un popup di conferma.
Come modificare la tua applicazione Node.js
Per modificare l'applicazione, procedi come segue:
Fai clic sull'icona a forma di matita nella colonna Azioni in una riga specifica dell'applicazione.
Verrà aperta una scheda dell'applicazione.
Al momento, puoi:
riavvia l'applicazione:fai clic su Riavvia pulsante.
- Interrompi Node.js:fai clic sul pulsante Interrompi Node.js.
- esegui script JavaScript:fai clic sul pulsante Esegui script JS per eseguire un comando specificato nella sezione Script del file package.json. Specificare il nome dello script da eseguire più eventuali parametri, quindi fare clic su OK.
- Rimuovi applicazione:fai clic sul pulsante Elimina e conferma l'azione in un popup.
- cambia la versione di Node.js:scegli la versione di Node.js da un menu a discesa.
- cambia la modalità dell'applicazione:scegli la modalità dell'applicazione da un menu a discesa. Le modalità disponibili sono Produzione e Sviluppo.
specifica radice dell'applicazione:specifica in un campo un indirizzo fisico dell'applicazione su un server che corrisponde al suo URI. - Specifica URL applicazione:specifica in un campo un collegamento HTTP/HTTPS all'applicazione.
- Specifica il file di avvio dell'applicazione:specificalo come file NAME.js.
- esegui il comando npm install e fai clic sul pulsante Esegui npm install per installare i pacchetti descritti nel file package.json.
- aggiungi variabili d'ambiente:fai clic su Aggiungi variabile e specifica un nome e un valore.
Come eseguire il debug degli errori sulla tua applicazione Node.js
Direttive come PassengerFriendlyErrorPages e PassengerAppEnv sono disponibili per l'uso da un file .htaccess.
Ciò consente agli utenti di cPanel di eseguire il debug di un'applicazione Node.js durante lo sviluppo.
Ad esempio, se aggiungi una delle seguenti righe al file .htaccess nella pagina dell'applicazione e si verifica un errore, vedrai l'errore elencato:
PassengerAppEnv development
o
PassengerFriendlyErrorPages on