Dieser Leitfaden erklärt, wie Sie die Konfiguration einer Node.js-Website anpassen können, die auf der Infomaniak-Infrastruktur gehostet wird, um das Verhalten Ihrer Anwendung an deren Entwicklung, Abhängigkeiten oder technische Präferenzen anzupassen.

Voraussetzungen

• Node.js-Website installieren auf Ihrer Hosting-Umgebung.
• Testen Sie Ihre Änderungen lokal, bevor Sie sie in die Produktion übernehmen.
• Stellen Sie sicher, dass Ihre Skripte (start, build) in Ihrer package.json -Datei korrekt 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 dem im Anwendungscode verwendeten entsprechen.

Zur Konfiguration zugreifen

Jede Website verfügt über ein eigenes Dashboard zur Steuerung der Anwendung (starten, stoppen, neustarten), die Ausführungsconsole anzeigen, die Node.js-Versionen verwalten, die Domains konfigurieren und die SSL-Zertifikate aktivieren:

1. Klicken Sie hier, um auf die Verwaltung Ihres Produkts im Infomaniak Manager zuzugreifen (Hilfe benötigen?).
2. Klicken Sie direkt auf den Name 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

Dafür:

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

Nehmen Sie sich diese andere Anleitung zur Kenntnis, 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 verweisen, d.h. dort, wo sich Ihre Datei package.json befindet.

Zum Beispiel können Sie für das Projektverzeichnis angeben:

./

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

./app

oder wenn sie sich in einem Ordner backend befindet:

./backend

Build Command (optional)

Falls Ihre Node.js-Anwendung einen Kompilierungsschritt vor der Ausführung benötigt, geben Sie einen Build-Befehl im dafür vorgesehenen 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

Falls Ihr Projekt keine Kompilierung erfordert, kann dieses Feld leer gelassen werden.

Startbefehl

Der Startbefehl entspricht dem Befehl, der verwendet wird, um Ihre Anwendung zu starten. 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.

Hörport

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 Node.js-Version 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.