Da JavaScript zu einer der beliebtesten Programmiersprachen zum Erstellen von Webanwendungen wurde, haben viele unserer Kunden die Sprache lieben gelernt.
Um jedoch skalierbare Browser- und Serveranwendungen zu erstellen, möchten sie häufig Node.js verwenden.
Diese plattformübergreifende Open-Source-Umgebung von Rockstar ermöglicht die schnelle Entwicklung von Anwendungen, was zu einer hohen Produktivität und damit zu einer schnelleren Bereitstellung führt.
Webhosting Magic bietet skalierbares und sicheres Webhosting, das von unseren Kunden oft als „eine großartige Alternative zu VPS beschrieben wird “.
Unser Node.js-Selektor ermöglicht es Ihnen als JavaScript-Entwickler, über den Webspace und die Ressourcen zu verfügen, die für Ihre Anwendung erforderlich sind, und gleichzeitig die Probleme bei der Anwendungsverwaltung zu minimieren.
So installieren Sie eine Node.js-Anwendung mit dem Node.js-Selektor
Node.js-Selektor ist eine CloudLinux-Komponente, die es jedem Benutzer ermöglicht, Node.js-Anwendungen einfach zu erstellen, die Node.js-Version und andere Parameter für Anwendungen basierend auf seinen Anforderungen auszuwählen.
Mit einer benutzerfreundlichen Benutzeroberfläche vereint es alle Funktionen an einem Ort und macht es sehr bequem zu verwalten.
Zum Zeitpunkt der Erstellung dieses Artikels unterstützt unser Node.js-Selektor die Node.js-Versionen 11.x, 12.x, 14.x und andere Versionen, die danach kommen werden.
Der Node.js-Selektor hat viele Vorteile gegenüber der manuellen Bereitstellung.
Es ermöglicht die Ausführung mehrerer verschiedener Anwendungen unter demselben Benutzer, auf die über die „Setup Node.js App zugegriffen wird ”-Seite in Ihrem cPanel-Konto.
Phusion Passenger wird für Anwendungsübergaben verwendet, sodass Sie keine .htaccess-Umleitungen einrichten müssen, um den Webserver anzuweisen, an den Anwendungsport weiterzuleiten.
Mit Node.js Selector wird all dies für Sie erledigt.
Rufen Sie zunächst cPanel auf → Softwarebereich → Node.js-Version auswählen .
Die Seite Webanwendungen wird angezeigt und Sie sehen mehrere Spalten in der Liste.
App-URI:Anwendungs-URI einschließlich der Domäne.
- App-Root-Verzeichnis:Anwendungs-Root-Verzeichnis relativ zum Home des Benutzers.
- Modus:kann Produktion oder Entwicklung sein.
- Status:gestartet/gestoppt – zeigt an, ob eine Anwendung ausgeführt wird oder nicht, und die Version der Anwendung.
- Aktionen:Ermöglicht das Starten, Neustarten, Stoppen, Bearbeiten und Entfernen einer bestimmten Anwendung.
Erstellen Sie ein cPanel-Konto
Bevor Sie auf cPanel zugreifen und es für Ihre Node.js-Bereitstellungen verwenden können, müssen Sie über ein cPanel-Konto verfügen.
Um ein cPanel-Konto zu erstellen, besuchen Sie https://dashboard.webhostingmagic.com/cart.php?gid=1 und wählen Sie ein Hosting-Paket aus.
Unser System führt Sie durch den Prozess, der weniger als 5 Minuten dauert, bis Sie Ihre cPanel-Logins erhalten.
So erstellen Sie eine Node.js-Anwendung
Bevor Sie Ihre Node.js-Anwendung konfigurieren können, müssen Sie diese Anwendung auf Ihren cPanel-Server übertragen.
Sie können einfach SFTP verwenden, um eine Kopie Ihrer Anwendung auf Ihren Server hochzuladen.
Oder Sie können auch die native Git-Unterstützung von cPanel verwenden, um das Repository auf Ihren Server zu klonen und von dort aus bereitzustellen.
Im folgenden Beispiel wurde die native Git-Unterstützung von cPanel verwendet, um die Anwendung auf den Server zu klonen und sie dann bereitzustellen.
Klonen Sie die Anwendung
- Melden Sie sich bei cPanel an.
- Im Dateibereich sehen Sie die Terminal-Oberfläche von cPanel (cPanel – Startseite – Erweitert – Terminal).
- Klicken Sie darauf, um zu sehen, wo Sie ein Git-Repository erstellen können.
- Kehren Sie jetzt zu Github zurück und klonen Sie mit HTTPS unter Verwendung der Web-URL. Um Ihre Anwendungsdaten sicher zu halten, sollten Sie darauf achten, dass Sie den Ordner public_html nicht klonen oder hochladen, da dies den Code selbst möglicherweise über das Internet zugänglich macht. Unser System ist bestrebt, Ihre Daten zu schützen, und während der Bereitstellung ist es nicht erforderlich, dass Ihre Anwendungsdaten öffentlich zugänglich sind.
Klonen auf einen cPanel-Server von einem privaten Github-Repo
Private Repositorys erfordern SSH-Zugriff, Sie müssen zusätzliche Schritte ausführen, um ein privat gehostetes Remote-Repository zu klonen.
Sie können die Terminal-Oberfläche von cPanel (cPanel – Startseite – Erweitert – Terminal) verwenden, um von der cPanel-Oberfläche aus auf die Befehlszeile zuzugreifen.
Generieren Sie einen SSH-Schlüssel
Wenn Sie noch keinen konfiguriert haben, führen Sie den folgenden Befehl aus, um einen SSH-Schlüssel zu generieren:
ssh-keygen -t rsa -b 4096 -C "[email protected]"
In diesem Beispiel „Benutzername “ steht für den Benutzernamen des cPanel-Kontos und „example.com ” steht für den Domänennamen.
Nachdem Sie diesen Befehl ausgeführt haben, werden Sie vom System aufgefordert, eine Passphrase einzugeben.
Geben Sie keine Passphrase ein.
Drücken Sie die Eingabetaste, um fortzufahren.
Vergewissern Sie sich, dass der Schlüssel verfügbar ist
Führen Sie den folgenden Befehl aus, um zu bestätigen, dass der Schlüssel vorhanden ist und sich an der richtigen Stelle befindet:
cat ~/.ssh/id_rsa.pub
Registrieren Sie unseren SSH-Schlüssel beim privaten Repository-Host
Führen Sie die folgenden Schritte aus, um einen SSH-Schlüssel bei GitHub zu registrieren:
- Melden Sie sich bei Ihrem GitHub-Konto an.
- Navigieren Sie zu Ihrem privaten Repository.
- Klicken Sie oben rechts auf der Seite auf Einstellungen. Eine neue Seite wird angezeigt.
- Klicken Sie im Menü auf der linken Seite auf Schlüssel bereitstellen. Eine neue Seite wird angezeigt.
- Klicken Sie oben rechts auf der Seite auf Bereitstellungsschlüssel hinzufügen. Eine neue Seite wird angezeigt.
- Geben Sie Ihre SSH-Schlüsseldaten ein:
- Geben Sie im Textfeld Titel einen Anzeigenamen für den Schlüssel ein.
- Fügen Sie im Textfeld Schlüssel den gesamten SSH-Schlüssel ein.
Wenn Sie Code von Ihrem cPanel-Konto auf Ihr GitHub-Konto übertragen möchten, wählen Sie „Schreibzugriff zulassen“. ” Kontrollkästchen.
Wenn Sie dieses Kontrollkästchen nicht aktivieren, können Sie nur Änderungen aus Ihrem GitHub-Repository in das von cPanel gehostete Repository bereitstellen.
- Klicken Sie auf Schlüssel hinzufügen.
Beachten Sie, dass einige Repository-Hosts Ihnen nicht erlauben, den Schreibzugriff für Ihre Zugriffsschlüssel zu konfigurieren.
Informationen zur Registrierung Ihres SSH-Schlüssels bei einem anderen privaten Repository-Host (Bitbucket, GitLab usw.) finden Sie auf der Website oder in der Dokumentation dieses Hosts.
Testen Sie den SSH-Schlüssel
Führen Sie den folgenden Befehl aus, um Ihren SSH-Schlüssel zu testen.
ssh -T [email protected]
wobei „example.com“ den Host des privaten Repositorys darstellt – z. B. ssh -T [email protected].
Klonen Sie das Repository auf cPanel
Um das Repository zu klonen, führen Sie den folgenden Befehl auf dem cPanel-Konto aus, wobei „git clone [email protected]:$name/private-repo.git “ steht für die Klon-URL des privaten Repositorys:
git clone [email protected]:$name/private-repo.git
Wenn „Fehler:Der WebSocket-Handshake ist fehlgeschlagen um … angezeigt wird ” Wenn Sie auf die Terminal-Oberfläche von cPanel zugreifen (cPanel – Startseite – Erweitert – Terminal), überprüfen Sie Ihre Verbindung erneut.
Wenn Sie VPN verwenden, trennen Sie die Verbindung und verwenden Sie Ihre normale Internetverbindung.
Sobald Sie auf „Erstellen klicken ” Dies bringt Sie zurück zur Repository-Seite, die den vollständigen Pfad der bereitgestellten Anwendung anzeigt.
Diese Seite ist wichtig, also speichern Sie diesen Pfad zur späteren Verwendung.
Zur Erinnerung:
- Wählen Sie eine Node.js-Version aus.
- Wählen Sie als Anwendungsmodus entweder „Entwicklung“ oder „Produktion“ aus.
- Wählen Sie den Anwendungsstamm aus. Dies muss eine physische Adresse für Ihre Anwendung auf einem Server sein, die ihrer URI entspricht.
- Wählen Sie die Anwendungs-URL aus. Dies ist ein HTTPS-Link zu Ihrer Anwendung.
- Füllen Sie das Formular aus, um auf die Startdatei der Anwendung zu verweisen. Sie können auch zusätzliche Umgebungsvariablen hinzufügen, indem Sie auf „Variable hinzufügen“ klicken.
- Klicken Sie auf Erstellen.
… eine genauere Erklärung.
Node.js-Anwendungskonfiguration
Wenn die Anwendungsdateien auf dem Server vorhanden sind, können Sie Node.js so konfigurieren, dass diese Anwendung aus dem Web gestartet wird.
Von cPanel auf demselben Konto unter „Software Wählen Sie auf der Registerkarte „Node.js-App einrichten“ aus “.
Auf diesem Einrichtungsbildschirm wählen Sie „Anwendung erstellen“. “, um die Optionen zur Auswahl der Node.js-Version sowie zur Verwendung einer Entwicklung aufzurufen oder Produktion Umgebung.
Die Entwicklung hat im Allgemeinen unterschiedliche Anwendungs-Hooks im Code der Anwendung, je nachdem, wie diese Umgebungsvariable gesetzt ist.
Als allgemeine Regel gilt, dass die Produktion mehr Caching-Ebenen sowie eine minimale Protokollierung haben wird.
Für eine Entwicklungsumgebung können Sie also das Gegenteil erwarten, mit weniger Anwendungs-Caching und ausführlicherer Protokollierung und Ausgabe von Fehlermeldungen.
Ein typisches Beispiel wäre, wenn es sich um eine Produktionsumgebung handelt, sehen Sie möglicherweise nur eine Fehlerseite.
In der Entwicklung sehen Sie möglicherweise einen vollständigen Stack-Trace zu einem Anwendungsfehler, mit dem Sie genau herausfinden können, wo der Fehler im Code aufgetreten ist.
Da Node.js-Anwendungen im Allgemeinen von mehreren Umgebungsvariablen abhängen, können Sie diese über „Variable hinzufügen“ hinzufügen ” unten rechts auf der Seite.
Die Produktions- oder Entwicklungsvariable von Node.js wird bereits separat im oberen Abschnitt über den „Application Mode“ gesetzt “, so dass es nicht notwendig ist, es erneut im Abschnitt Umgebungsvariablen festzulegen.
In demselben Menü können Sie die Version von Node.js auswählen, die Sie verwenden möchten, sowie die Startdatei der Anwendung.
Dies könnte index.js sein , app.js, oder eine beliebige Anzahl von Variationen; das hängt von der Anwendung ab.
Nachdem Sie Ihre Anwendung gespeichert haben, müssen Sie ihre Paketabhängigkeiten auflösen.
Der NPM-Paketmanager führt dies automatisch basierend auf der mit der Anwendung gepackten Datei „package.json“ durch, sodass Sie hier lediglich auf die Schaltfläche „NPM-Installation“ klicken müssen.
An diesem Punkt müssen Sie Ihre Domäne in eine IP-Adresse auflösen, oder das Installationsskript enthält einen Fehler.
Wenn Sie eine Subdomain verwenden, vergewissern Sie sich, dass diese erstellt wurde und dass Sie alle relevanten Einträge zu Ihrem DNS hinzugefügt haben.
Sie können dies bestätigen, indem Sie einfach Folgendes ausführen:
$ dig sub-domain.com
NPM liest den Inhalt der Datei „package.json“ und installiert die erforderlichen Pakete in einer für die Anwendung spezifischen virtuellen Umgebung.
Wenn Sie mit der Befehlszeile vertraut sind, können Sie den Anweisungen oben auf der Seite folgen, um Zugriff auf die Befehle „npm“ und „node“ zu erhalten, um zusätzliche Änderungen manuell vorzunehmen, was eine Vielzahl von Anpassungen ermöglicht.
Node.js-Anwendungsbereitstellung
Zu diesem Zeitpunkt haben Sie Ihre Anwendung konfiguriert und Node.js-Module installiert, sodass Sie bereit sind, die Anwendung zu starten.
Unsere cPanel-Systeme machen dies sehr einfach.
Klicken Sie auf derselben Seite, auf der Sie Ihre Anwendung konfiguriert haben, auf „Run JS Script“. ”
Dadurch wird die Startdatei der Anwendung ausgeführt, die Sie zuvor während des Setups definiert haben.
Da Node.js-Anwendungen mehrere verschiedene Optionen haben, kann dies ein weiteres Menü mit verschiedenen Optionen zur Auswahl anzeigen, je nachdem, welche Anwendung Sie ausführen.
Im Allgemeinen sollten Sie „Start“ auswählen ” Option weiter.
Abschließend können Sie die Datei „Öffnen“ auswählen ” Möglichkeit, Ihre Seite zu besuchen und Ihre Anwendung zu sehen!
So starten Sie eine Node.js-Anwendung
Gehen Sie wie folgt vor, um eine angehaltene Anwendung zu starten:
Klicken Sie auf Start Symbol in der Spalte „Aktionen“ in der Zeile einer angehaltenen Anwendung.
Wenn die Aktion abgeschlossen ist, ändert sich ein Start-Symbol in ein Stopp-Symbol.
So stoppen Sie eine Node.js-Anwendung
Um eine gestartete Anwendung zu stoppen, gehen Sie wie folgt vor:
Klicken Sie auf Stopp Symbol in der Spalte Aktionen in einer gestarteten Anwendungszeile.
Wenn die Aktion abgeschlossen ist, ändert sich das Stop-Symbol in das Start-Symbol.
So starten Sie eine Node.js-Anwendung
Gehen Sie wie folgt vor, um die Anwendung neu zu starten:
Klicken Sie auf Neu starten Symbol in der Spalte Aktionen in einer gestarteten Anwendungszeile.
Die aktuelle Zeile wird gesperrt und nach Abschluss des Vorgangs wieder freigegeben.
So entfernen Sie eine Node.js-Anwendung
Gehen Sie wie folgt vor, um die Anwendung zu entfernen:
Klicken Sie in einer bestimmten Anwendungszeile in der Spalte „Aktionen“ auf das Symbol „Mülleimer“.
Klicken Sie im Bestätigungs-Pop-up auf „Zustimmen“, um mit dem Entfernen zu beginnen, oder auf „Abbrechen“, um das Pop-up zu schließen.
Wenn die Aktion abgeschlossen ist, wird eine Anwendung aus der Tabelle Webanwendungen entfernt und ein Bestätigungs-Popup wird angezeigt.
So bearbeiten Sie Ihre Node.js-Anwendung
Gehen Sie wie folgt vor, um die Anwendung zu bearbeiten:
Klicken Sie auf das Stiftsymbol in der Spalte Aktionen in einer bestimmten Anwendungszeile.
Eine Anwendungsregisterkarte wird geöffnet.
Im Moment können Sie:
Anwendung neu starten – klicken Sie auf Neu starten Schaltfläche.
- Node.js stoppen – klicken Sie auf die Schaltfläche Node.js stoppen.
- JavaScript-Skript ausführen – Klicken Sie auf die Schaltfläche „JS-Skript ausführen“, um einen Befehl auszuführen, der im Abschnitt „Skripts“ der Datei „package.json“ angegeben ist. Geben Sie den Namen des auszuführenden Skripts sowie alle Parameter an und klicken Sie dann auf OK.
- Anwendung entfernen – klicken Sie auf die Schaltfläche „Löschen“ und bestätigen Sie die Aktion in einem Popup.
- Node.js-Version ändern – wählen Sie die Node.js-Version aus einem Dropdown-Menü aus.
- Anwendungsmodus ändern — Wählen Sie den Anwendungsmodus aus einer Dropdown-Liste aus. Verfügbare Modi sind Produktion und Entwicklung.
Anwendungsstamm angeben — Geben Sie in einem Feld eine physische Adresse der Anwendung auf einem Server an, die ihrer URI entspricht. - Anwendungs-URL angeben — Geben Sie in einem Feld einen HTTP/HTTPS-Link zur Anwendung an.
- Anwendungsstartdatei angeben – als NAME.js-Datei angeben.
- Führen Sie den Befehl „npm install“ aus und klicken Sie auf die Schaltfläche „Run npm install“, um das/die in der Datei „package.json“ beschriebene(n) Paket(e) zu installieren.
- Umgebungsvariablen hinzufügen — klicken Sie auf Variable hinzufügen und geben Sie einen Namen und einen Wert an.
So beheben Sie Fehler in Ihrer Node.js-Anwendung
Direktiven wie PassengerFriendlyErrorPages und PassengerAppEnv stehen zur Verwendung in einer .htaccess-Datei zur Verfügung.
Dadurch können cPanel-Benutzer eine Node.js-Anwendung während der Entwicklung debuggen.
Wenn Sie beispielsweise eine der folgenden Zeilen zur .htaccess-Datei auf der Anwendungsseite hinzufügen und ein Fehler auftritt, wird der Fehler aufgelistet:
PassengerAppEnv development
oder
PassengerFriendlyErrorPages on