Alors que JavaScript est devenu l'un des langages de programmation les plus populaires pour créer des applications Web, nombre de nos clients en sont venus à aimer ce langage.
Mais pour créer des applications de navigateur et de serveur évolutives, ils souhaitent souvent utiliser Node.js.
Cet environnement multiplateforme open source rockstar permet le développement rapide d'applications, ce qui conduit à une productivité élevée et donc à un déploiement plus rapide.
Web Hosting Magic offre un hébergement Web évolutif et sécurisé souvent décrit par nos clients comme "une excellente alternative au VPS ".
Notre sélecteur Node.js vous permet, en tant que développeur JavaScript, de disposer de l'espace Web et des ressources nécessaires à votre application tout en minimisant les maux de tête liés à la gestion des applications.
Comment installer une application Node.js à l'aide du sélecteur Node.js
Sélecteur Node.js est un composant CloudLinux qui permet à chaque utilisateur de créer facilement des applications Node.js, de choisir la version de Node.js et d'autres paramètres pour les applications en fonction de ses besoins.
Avec une interface utilisateur conviviale, il réunit toutes les fonctionnalités en un seul endroit et le rend très pratique à gérer.
Au moment d'écrire ces lignes, notre sélecteur Node.js prend en charge les versions 11.x, 12.x, 14.x de Node.js et les autres versions qui suivront.
Le sélecteur Node.js présente de nombreux avantages par rapport au déploiement manuel.
Il permet à plusieurs applications différentes d'être exécutées sous le même utilisateur, accessible sous "Setup Node.js App ” page dans votre compte cPanel.
Le passager Phusion est utilisé pour les transferts d'applications, vous n'aurez donc pas besoin de configurer de redirections .htaccess pour indiquer au serveur Web de transférer vers le port d'application.
Avec Node.js Selector, tout cela est géré pour vous.
Pour commencer, accédez à cPanel → Section Logiciels → Sélectionnez la version de Node.js .
La page Applications Web s'affichera et vous verrez plusieurs colonnes dans la liste.
URI de l'application :URI de l'application, y compris le domaine.
- Répertoire racine de l'application :répertoire racine de l'application relatif au domicile de l'utilisateur.
- Mode :peut être production ou développement.
- Statut :démarré/arrêté :indique si une application est en cours d'exécution ou non, ainsi que la version de l'application.
- Actions :permet de démarrer, redémarrer, arrêter, modifier et supprimer une application particulière.
Créer un compte cPanel
Avant de pouvoir accéder et utiliser cPanel pour vos déploiements Node.js, vous devez avoir un compte cPanel.
Pour créer un compte cPanel, visitez https://dashboard.webhostingmagic.com/cart.php?gid=1 et sélectionnez un pack d'hébergement.
Notre système vous guidera tout au long du processus qui vous prendra moins de 5 minutes pour obtenir vos identifiants cPanel.
Comment créer une application Node.js
Avant de pouvoir configurer votre application Node.js, vous devrez obtenir cette application sur votre serveur cPanel.
Vous pouvez simplement utiliser SFTP pour télécharger une copie de votre application sur votre serveur.
Ou vous pouvez également utiliser le support Git natif de cPanel pour cloner le référentiel sur votre serveur et le déployer à partir de là.
L'exemple suivant utilise le support Git natif de cPanel pour cloner l'application sur le serveur, puis la déployer.
Cloner l'application
- Connectez-vous à cPanel.
- Sur le volet Fichiers, vous voyez l'interface Terminal de cPanel (cPanel - Accueil - Avancé - Terminal).
- Cliquez dessus pour voir où vous pouvez créer un dépôt Git.
- Retournez maintenant à Github et clonez avec HTTPS à l'aide de l'URL Web. Pour assurer la sécurité de vos données d'application, assurez-vous de ne pas cloner ou télécharger dans le dossier public_html, car cela rend le code lui-même potentiellement accessible depuis le Web. Notre système s'efforce de protéger vos données, et pendant le déploiement, il n'est pas obligatoire que les données de votre application soient accessibles au public.
Clonage vers un serveur cPanel à partir d'un dépôt Github privé
Les référentiels privés nécessitent un accès SSH, vous devez effectuer des étapes supplémentaires afin de cloner un référentiel distant hébergé en privé.
Vous pouvez utiliser l'interface Terminal de cPanel (cPanel - Accueil - Avancé - Terminal) pour accéder à la ligne de commande depuis l'interface cPanel.
Générer une clé SSH
Si vous n'en avez pas encore configuré, exécutez la commande suivante pour générer une clé SSH :
ssh-keygen -t rsa -b 4096 -C "[email protected]"
Dans cet exemple, "nom d'utilisateur " représente le nom d'utilisateur du compte cPanel et "example.com ” représente le nom de domaine.
Après avoir exécuté cette commande, le système vous demandera d'entrer une phrase de passe.
Ne saisissez pas de phrase de passe.
Appuyez sur Entrée pour continuer.
Vérifiez que la clé est disponible
Pour confirmer que la clé existe et se trouve au bon emplacement, exécutez la commande suivante :
cat ~/.ssh/id_rsa.pub
Enregistrer notre clé SSH auprès de l'hôte de référentiel privé
Pour enregistrer une clé SSH avec GitHub, procédez comme suit :
- Connectez-vous à votre compte GitHub.
- Accédez à votre dépôt privé.
- Dans l'angle supérieur droit de la page, cliquez sur Paramètres. Une nouvelle page apparaîtra.
- Dans le menu de gauche, cliquez sur Déployer les clés. Une nouvelle page apparaîtra.
- Dans l'angle supérieur droit de la page, cliquez sur Ajouter une clé de déploiement. Une nouvelle page apparaîtra.
- Saisissez vos données de clé SSH :
- Dans la zone de texte Titre, saisissez un nom d'affichage pour la clé.
- Dans la zone de texte Clé, collez la clé SSH entière.
Si vous souhaitez transférer le code de votre compte cPanel vers votre compte GitHub, sélectionnez l'option "Autoriser l'accès en écriture ” case à cocher.
Si vous ne cochez pas cette case, vous ne pouvez déployer les modifications de votre référentiel GitHub que vers le référentiel hébergé par cPanel.
- Cliquez sur Ajouter une clé.
Notez que certains hôtes de référentiel ne vous permettent pas de configurer l'accès en écriture pour vos clés d'accès.
Pour plus d'informations sur l'enregistrement de votre clé SSH auprès d'un autre hôte de référentiel privé (Bitbucket, GitLab, etc.), consultez le site Web ou la documentation de cet hôte.
Testez la clé SSH
Pour tester votre clé SSH, exécutez la commande suivante.
ssh -T [email protected]
où "example.com" représente l'hôte du référentiel privé - par exemple ssh -T [email protected].
Cloner le dépôt sur cPanel
Pour cloner le référentiel, exécutez la commande suivante sur le compte cPanel, où "git clone [email protected]:$name/private-repo.git " représente l'URL de clonage du référentiel privé :
git clone [email protected]:$name/private-repo.git
Si vous voyez "Erreur :La poignée de main WebSocket a échoué à … " lorsque vous accédez à l'interface Terminal de cPanel (cPanel - Accueil - Avancé - Terminal), revérifiez votre connexion.
Si vous utilisez un VPN, déconnectez-vous et utilisez votre connexion Internet normale.
Une fois que vous avez cliqué sur "Créer " Cela vous ramènera à la page du référentiel indiquant le chemin complet de l'application en cours de déploiement.
Cette page est importante, alors enregistrez ce chemin pour une utilisation ultérieure.
Pour récapituler :
- Sélectionnez une version de Node.js.
- Sélectionnez "Développement" ou "Production" pour le mode d'application.
- Sélectionnez la racine de l'application. Il doit s'agir d'une adresse physique de votre application sur un serveur qui correspond à son URI.
- Sélectionnez l'URL de l'application. Il s'agit d'un lien HTTPS vers votre application.
- Remplissez le formulaire pour pointer vers le fichier de démarrage de l'application. Vous pouvez également ajouter des variables d'environnement supplémentaires en cliquant sur "Ajouter une variable".
- Cliquez sur Créer.
… une explication plus détaillée.
Configuration de l'application Node.js
Une fois les fichiers d'application en place sur le serveur, vous êtes prêt à configurer Node.js pour lancer cette application à partir du Web.
Depuis cPanel sur le même compte sous le "Logiciel ", sélectionnez "Configurer l'application Node.js ”.
Sur cet écran de configuration, vous sélectionnerez "Créer une application ” pour afficher les options de choix de la version de Node.js ainsi que l'utilisation d'un Développement ou Production environnement.
Le développement a généralement différents crochets d'application dans le code de l'application, selon la façon dont cette variable d'environnement est définie.
En règle générale, la production aura plus de niveaux de mise en cache, ainsi qu'une journalisation minimale.
Ainsi, pour un ensemble d'environnements de développement, vous pouvez vous attendre à l'inverse, avec moins de niveaux de mise en cache des applications, et plus de journalisation détaillée et de messages d'erreur.
Un exemple typique serait celui où, s'il s'agit d'un environnement de production, vous ne verrez peut-être qu'une page d'erreur.
En développement, vous pouvez voir une trace complète de la pile sur une erreur d'application, ce qui vous permet de déterminer exactement où l'erreur s'est produite dans le code.
Étant donné que les applications Node.js dépendent en général de plusieurs variables d'environnement, vous pouvez les ajouter à l'aide de la commande "Ajouter une variable ” bouton en bas à droite de la page.
La variable de production ou de développement Node.js est déjà définie séparément dans la section supérieure à l'aide du "mode d'application ”, il n'est donc pas nécessaire de le redéfinir dans la section Variables d'environnement.
Ce même menu vous permet de sélectionner la version de Node.js que vous souhaitez utiliser ainsi que le fichier de démarrage de l'application.
Il peut s'agir de index.js , app.js, ou n'importe quel nombre de variantes ; cela dépend de l'application.
Une fois que vous avez enregistré votre application, vous devrez résoudre ses dépendances de package.
Le gestionnaire de packages NPM le fait automatiquement en fonction du fichier package.json fourni avec l'application, donc tout ce que vous aurez à faire ici est de cliquer sur le bouton "Installer NPM".
À ce stade, vous aurez besoin que votre domaine soit résolu en adresse IP, sinon le script d'installation contiendra une erreur.
Si vous utilisez un sous-domaine, assurez-vous qu'il a été créé et que vous avez ajouté tous les enregistrements pertinents à votre DNS.
Vous pouvez le confirmer en exécutant simplement :
$ dig sub-domain.com
NPM lira le contenu du fichier package.json et installera les packages nécessaires dans un environnement virtuel spécifique à l'application.
Si vous êtes familier avec la ligne de commande, vous pouvez suivre les instructions en haut de la page pour accéder aux commandes "npm" et "node" afin d'apporter des modifications supplémentaires manuellement, ce qui permet une grande personnalisation.
Déploiement d'applications Node.js
À ce stade, votre application est configurée et les modules Node.js installés, vous êtes donc prêt à lancer l'application.
Nos systèmes cPanel rendent cela très facile.
Sur la même page où vous avez configuré votre application, cliquez sur "Exécuter le script JS ”
Cela exécutera le fichier de démarrage de l'application que vous avez défini précédemment lors de l'installation.
Comme les applications Node.js ont plusieurs options différentes, cela peut faire apparaître un autre menu avec différentes options à sélectionner en fonction de l'application que vous exécutez.
En général, vous voudrez sélectionner le "Démarrer ” option suivante.
Enfin, vous pouvez sélectionner l'option "Ouvrir ” option pour visiter votre page, et voir votre candidature !
Comment démarrer une application Node.js
Pour démarrer une application arrêtée, procédez comme suit :
Cliquez sur Démarrer icône dans la colonne Actions d'une ligne d'application arrêtée.
Lorsque l'action est terminée, une icône Démarrer se transforme en icône Arrêter.
Comment arrêter une application Node.js
Pour arrêter une application démarrée, procédez comme suit :
Cliquez sur Arrêter icône dans la colonne Actions d'une ligne d'application démarrée.
Lorsque l'action est terminée, une icône Arrêter se transforme en icône Démarrer.
Comment démarrer une application Node.js
Pour redémarrer l'application, procédez comme suit :
Cliquez sur Redémarrer icône dans la colonne Actions d'une ligne d'application démarrée.
La ligne actuelle sera bloquée et sera débloquée lorsque le processus sera terminé.
Comment supprimer une application Node.js
Pour supprimer l'application, procédez comme suit :
Cliquez sur l'icône "Corbeille" dans la colonne Actions d'une ligne d'application particulière.
dans la fenêtre de confirmation, cliquez sur Accepter pour commencer la suppression ou sur Annuler pour fermer la fenêtre contextuelle.
Une fois l'action terminée, une application sera supprimée du tableau des applications Web et une fenêtre contextuelle de confirmation s'affichera.
Comment modifier votre application Node.js
Pour modifier l'application, procédez comme suit :
Cliquez sur l'icône Crayon dans la colonne Actions d'une ligne d'application particulière.
Un onglet d'application sera ouvert.
Pour le moment, vous pouvez :
redémarrer l'application - cliquez sur Redémarrer bouton.
- arrêter Node.js :cliquez sur le bouton Arrêter Node.js.
- exécuter le script JavaScript :cliquez sur le bouton Exécuter le script JS pour exécuter une commande spécifiée dans la section Scripts du fichier package.json. Spécifiez le nom du script à exécuter ainsi que tous les paramètres, puis cliquez sur OK.
- supprimer l'application :cliquez sur le bouton Supprimer et confirmez l'action dans une fenêtre contextuelle.
- modifier la version de Node.js :choisissez la version de Node.js dans une liste déroulante.
- modifier le mode d'application :choisissez le mode d'application dans une liste déroulante. Les modes disponibles sont Production et Développement.
spécifier la racine de l'application — spécifiez dans un champ une adresse physique de l'application sur un serveur qui correspond à son URI. - spécifiez l'URL de l'application :spécifiez dans un champ un lien HTTP/HTTPS vers l'application.
- spécifiez le fichier de démarrage de l'application — spécifiez en tant que fichier NAME.js.
- exécutez la commande npm install-cliquez sur le bouton Exécuter npm install pour installer le(s) package(s) décrit(s) dans le fichier package.json.
- ajouter des variables d'environnement :cliquez sur Ajouter une variable et spécifiez un nom et une valeur.
Comment déboguer les erreurs sur votre application Node.js
Des directives telles que PassengerFriendlyErrorPages et PassengerAppEnv peuvent être utilisées à partir d'un fichier .htaccess.
Cela permet aux utilisateurs de cPanel de déboguer une application Node.js pendant le développement.
Par exemple, si vous ajoutez l'une des lignes suivantes au fichier .htaccess sur la page de l'application et qu'il y a une erreur, vous verrez l'erreur répertoriée :
PassengerAppEnv development
ou
PassengerFriendlyErrorPages on