Diese Anleitung 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, Abhängigkeiten oder technischen Präferenzen anzupassen.

Voraussetzungen

• Installieren Sie eine Node.js-Website auf Ihrem Hosting.
• Testen Sie Ihre Änderungen lokal, bevor Sie sie in die Produktion übernehmen.
• 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, das Ausführungsverzeichnis 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, restart), die Ausführungsconsole zu konsultieren, die Node.js-Versionen zu verwalten, Domains zu konfigurieren und SSL-Zertifikate zu aktivieren:

1. Klicken Sie hier, um auf die Verwaltung Ihrer Website im Infomaniak-Manager zuzugreifen (Hilfe benötigt?).
2. Klicken Sie direkt auf den Namen der betreffenden Website.
3. Sie können die Konsole öffnen, das Projekt stoppen (es wird eine Wartungsseite angewendet) oder es neu starten.
4. 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 zur Hand, falls Probleme auftreten.

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, also 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 im dafür vorgesehenen Feld an. 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 lauschen, 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(`Application lancée sur le port ${port}`);
});

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

Node.js-Version

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