Dieser Leitfaden erklärt, wie Sie die Konfiguration einer Node.js-Website anpassen, die auf der Infomaniak-Infrastruktur gehostet wird, um das Verhalten Ihrer Anwendung entsprechend ihrer Entwicklung, ihrer Abhängigkeiten oder Ihrer technischen Präferenzen anzupassen.

Voraussetzungen

• Installieren Sie eine Node.js-Website auf Ihrem Hosting.
• Testen Sie Ihre Änderungen lokal, bevor Sie sie in der Produktion anwenden.
• Stellen Sie sicher, dass Ihre Skripte (start, build) in Ihrer Datei package.json definiert sind.
• Wenn Sie die Struktur Ihres Projekts ändern, denken Sie daran, den Ausführungsordner und die zugehörigen Befehle anzupassen.
• Der im Manager definierte Listening-Port muss unbedingt mit dem in Ihrem Anwendungscode verwendeten übereinstimmen.

Auf die Konfiguration zugreifen

Jede Website verfügt über ein eigenes Dashboard, um die Anwendung zu steuern (start, stop, neustarten), die Ausführungsconsole zu konsultieren, die Node.js-Versionen zu verwalten, die Domänen zu konfigurieren und die SSL-Zertifikate zu aktivieren:

1. Klicken Sie hier, um auf die Verwaltung Ihres Produkts im Infomaniak-Manager zuzugreifen (Hilfe benötigt?).
2. Klicken Sie direkt auf den Namen des betreffenden Produkts.
3. Sie können die Konsole öffnen, das Projekt stoppen (es wird eine Wartungsseite angewendet) oder es neu starten.
4. Um auf die erweiterten Einstellungen zuzugreifen, klicken Sie auf Verwalten unter Erweiterte Einstellungen:
   
5. Klicken Sie auf die Registerkarte Node.js, um auf die Einstellungen zuzugreifen:
   

Änderungen anwenden

Dazu:

1. Speichern Sie die Änderungen über die Manager-Oberfläche.
2. Starten Sie Ihre Anwendung neu, damit die Änderungen übernommen werden.

Nehmen Sie sich diesen anderen Leitfaden im Falle von Problemen zur Kenntnis.

Hauptbefehle

Ausführungsverzeichnis

Das Ausführungsverzeichnis gibt den Speicherort auf dem Server an, an dem die Build- und Startbefehle ausgeführt werden. Es muss auf das Stammverzeichnis Ihrer Anwendung zeigen, d.h. dort, wo sich Ihre Datei package.json befindet.

Zum Beispiel können Sie für die Projektwurzel angeben:

./

oder wenn sich Ihre Anwendung in einem Unterverzeichnis namens app befindet:

./app

oder wenn sie sich in einem Verzeichnis backend befindet:

./backend

Build-Befehl (optional)

Wenn Ihre Node.js-Anwendung einen Kompilierungsschritt vor der Ausführung benötigt, geben Sie einen Build-Befehl in das dafür vorgesehene Feld ein. Dieser Befehl wird automatisch vor dem Start der Anwendung ausgeführt.

Zum Beispiel können Sie angeben:

npm install && npm run build

oder, wenn Sie yarn :

yarn install && yarn build

verwenden, wenn Ihr Projekt keine Kompilierung benötigt, kann dieses Feld leer gelassen werden.

Start-Befehl

Der Start-Befehl entspricht dem Befehl, der zum Starten Ihrer Anwendung verwendet wird. Er muss identisch mit dem sein, den Sie lokal verwenden, um das Projekt auszuführen.

Zum Beispiel können Sie angeben:

node index.js

npm start

oder

yarn start

Dieser Befehl muss es ermöglichen, den Server oder den Einstiegspunkt Ihrer Anwendung direkt zu starten, wie er in Ihrer Entwicklungsumgebung definiert ist.

Listening Port

Ihre Anwendung muss auf einem bestimmten Port “hören”, der im Manager definiert ist. Dieser Port wird Ihrer Anwendung über eine Umgebungsvariable PORT übermittelt.
Beispiel in Ihrem Node.js-Code:

const port = process.env.PORT || 8080;
app.listen(port, () => {
  console.log(`Anwendung gestartet auf Port ${port}`);
});

Stellen Sie sicher, dass dieser Port in Ihrem Code berücksichtigt wird.

Node.js-Version

Sie können die Node.js-Version auswählen, die Ihre Website verwenden soll. Es wird empfohlen, eine stabile und stets unterstützte Version zu verwenden, um die Sicherheit und Kompatibilität Ihrer Anwendung zu gewährleisten.