So installierst du das Sails.js MVC Framework mit Nginx auf Debian 11

Sails.js ist ein Full-Stack-Node.js-Framework, das auf Express socket.io aufbaut. Es ist ein leistungsstarkes MVC-Framework, das von Ruby on Rails inspiriert ist, aber datengesteuerte APIs und eine skalierbare, serviceorientierte Architektur unterstützt. Sails.js ist ein geeignetes Framework für die Entwicklung moderner und unternehmenstauglicher Anwendungen, insbesondere datengesteuerter Anwendungen.

Sails.js bietet automatisch generierte REST-APIs und ein leistungsstarkes ORM namens Waterline, mit dem Entwickler beliebige Datenbanken wie MySQL, PostgreSQL, MongoDB, Redis usw. verwenden können.

Voraussetzungen

In diesem Artikel erfährst du, wie du das Sails.js Framework auf Debian 11 Bullseye installierst. Außerdem erfährst du, wie du ein neues Projekt mit Sails.js erstellst und Nginx als Reverse Proxy für die Sails.js-Anwendung einrichtest.

Um loszulegen, solltest du die folgenden Voraussetzungen erfüllen.

• Betriebssystem: Debian 11 Bullseye
• Root-Rechte

Jetzt geht’s an die Installation.

Installation der Entwicklungswerkzeuge

Zuerst installierst du einige Entwicklungswerkzeuge wie Build-Essentials und GCC auf deinem Debian-System.

1. Melde dich auf deinem Server an und führe den Befehl apt aus, um die Repositories zu aktualisieren.

sudo apt update

2. Als Nächstes führst du den folgenden Befehl aus, um die Entwicklungswerkzeuge zu installieren.

sudo apt install curl build-essential gcc g++ make

Gib„y“ ein, um die Installation zu bestätigen und drücke„Enter„, um fortzufahren.

Node.js LTS und Yarn Package Manager installieren

Bevor du Sails.js installierst, musst du Node.js auf deinem Debian-System installieren.

In diesem Schritt installierst du Node.js über das Repository nodesource.com. Und du wirst die neueste LTS-Version Node.js 16.x installieren.

1. Führe den folgenden Befehl aus, um das Node.js-Repository hinzuzufügen.

curl -fsSL https://deb.nodesource.com/setup_16.x | bash -

Der Befehl fügt automatisch das Node.js-Repository hinzu und aktualisiert die Repositories auf deinem System.

Am Ende siehst du die Ausgabemeldungen, die dir vorschlagen, den Yarn-Paketmanager zu installieren.

2. Füge den Yarn GPG-Schlüssel und das Repository mit dem folgenden Befehl hinzu.

curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/yarnkey.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/yarnkey.gpg] https://dl.yarnpkg.com/debian stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

3. Aktualisiere als Nächstes deine Debian-Repositories und installiere dann den Node.js- und Yarn-Paketmanager mit dem folgenden Befehl.

sudo apt update && sudo apt install nodejs yarn

Gib„y“ ein, um die Installation zu bestätigen und drücke„Enter„, um fortzufahren.

4. Wenn die Installation von Node.js und Yarn abgeschlossen ist, überprüfe die Node.js-Version und die Yarn-Version mit dem folgenden Befehl.

node --version
yarn --version

Du wirst eine ähnliche Ausgabe wie unten sehen.

# nodejs version
v16.13.1

# yarn version
1.22.15

Sails.js mit dem Yarn Package Manager installieren

In diesem Schritt installierst du die neueste Version von Sails.js mit dem Yarn-Paketmanager.

1. Führe den folgenden Befehl aus, um Sails.js global oder systemweit zu installieren.

sudo yarn global add sails

Dieser Befehl fügt die Binärdatei„sails“ zu deinem„$PATH“-Verzeichnis hinzu.

2. Führe den unten stehenden Befehl „sails“ aus, um die Version zu überprüfen.

sails --version

In diesem Beispiel haben wir die Version 1.5 von Sails.js installiert.

1.5.0

3. Sieh dir jetzt die Hilfeseite für den Befehl „sails“ an (siehe unten).

sails --help

Unten findest du alle verfügbaren Optionen für den Befehl „sails“.

  Usage: sails [command]

Options:

-v, –version  output the version number
-h, –help     output usage information

Commands:

version
lift|l [options]
new [options] [path_to_new_app]
generate
upgrade
migrate
console|c [options]
www
debug                            (for Node v5 and below)
inspect                          (for Node v6 and above)
run
test
lint
deploy
debug-console|dc
help [command]

Gehe nun zum nächsten Schritt über, um ein neues Sails.js-Projekt zu erstellen.

Erstes Projekt mit Sails.js erstellen

In diesem Schritt lernst du, wie du ein neues Projekt mit Sails.js erstellst. Aus Sicherheitsgründen empfiehlt es sich, ein neues Sails.js-Projekt mit einem Nicht-Root-Benutzer zu starten.

1. Melde dich mit folgendem Befehl bei deinem Benutzer an.

su - username

2. Führe den unten stehenden„sails„-Befehl aus, um eine neue Anwendung zu erstellen. In diesem Beispiel werden wir eine Anwendung„testapp“ erstellen.

sails new testapp

Wähle die Vorlage für deine Anwendung.

Gib die Nummer „1“ ein, um eine vollständige Webanwendungsvorlage auszuwählen, die einige wichtige Funktionen wie Authentifizierung, Anmeldeseite usw. enthält.

Gib die Nummer„2“ ein, um eine leere und klassische Sails.js-Anwendung auszuwählen.

Wenn deine Anwendung erstellt ist, siehst du eine Meldung wie‚Created a new Sails app `testapp`!‚. Und du bekommst ein neues Verzeichnis„testapp“ in deinem Home-Verzeichnis.

3. Wechsle dein Arbeitsverzeichnis zu„testapp“ und führe die Sails.js-Anwendung mit dem unten stehenden Befehl aus.

cd testapp/
sails lift

Jetzt siehst du eine ähnliche Ausgabe wie unten.

Deine Sails.js-Anwendung läuft auf dem„development„-Verzeichnis mit dem Standard-Port„1337„.

4. Öffne deinen Webbrowser und gib deine IP-Adresse mit Port„1337“ in die Adresszeile ein.

http://192.168.1.50:1337/

Du wirst die Standard-Indexseite der Sails.js-Webanwendung sehen.

Gehe nun zurück zu deinem Terminal und drücke„Strg+C„, um die Sails.js-Anwendung zu beenden.

Gehe zum nächsten Schritt über, um deine Sails.js-Anwendung als systemd-Dienst einzurichten.

Sails.app-Anwendung als Systemd-Dienst einrichten

In diesem Schritt erstellst du eine neue systemd-Dienstdatei für die Sails.js-Anwendung.

1. Erstelle mit dem nano-Editor eine neue Servicedatei „testapp.service“.

sudo nano /etc/systemd/system/testapp.service

Kopiere die folgende Konfiguration und füge sie ein. Achte darauf, dass du„User=johndoe“ mit deinem Benutzer und„WorkingDirectory=/home/johndoe/testapp“ mit deinem Projektverzeichnis änderst.

[Unit]
After=network.target

[Service]
Type=simple
User=johndoe
WorkingDirectory=/home/johndoe/testapp
ExecStart=/usr/local/bin/sails lift
Restart=on-failure

[Install]
WantedBy=multi-user.target

Speichere die Konfiguration und beende sie.

2. Als Nächstes lädst du den systemd manager mit dem folgenden Befehl neu, um die neue Konfiguration anzuwenden.

sudo systemctl daemon-reload

3. Starte deine Sails.js-Anwendung mit dem folgenden Befehl.

sudo systemctl start testapp

Überprüfe deinen Sails.js-Anwendungsdienst mit dem folgenden Befehl.

sudo systemctl status testapp

Du wirst eine ähnliche Ausgabe wie unten sehen.

Der Sails.js-Anwendungsdienst ist aktiv und läuft. Er läuft in der Standard-Entwicklungsumgebung mit dem Standard-Port „1337“.

Gehe zum nächsten Schritt über, um Nginx als Reverse Proxy für deine Sails.js-Anwendung einzurichten.

Nginx als Reverse Proxy für Sails.js einrichten

In diesem Schritt installierst und konfigurierst du den Webserver Nginx als Reverse Proxy für die Sails.js-Anwendung.

1. Installiere zunächst die Nginx-Pakete mit dem unten stehenden apt-Befehl.

sudo apt install nginx -y

2. Nachdem die Nginx-Installation abgeschlossen ist, erstelle mit dem nano-Editor eine neue Serverblock-Konfiguration „/etc/nginx/sites-available/testapp“.

sudo nano /etc/nginx/sites-available/testapp

Ersetze die Domain„dev.example.io“ durch deine IP-Adresse oder lokale Domain.

server {
 listen       80;
 server_name  dev.example.io;
   location / {
     proxy_pass        http://localhost:1337/;
     proxy_set_header  Host $host;
     proxy_buffering   off;
   }
 }

Speichere die Konfiguration und beende sie.

3. Aktiviere als nächstes die „testapp“-Serverblöcke und überprüfe die Nginx-Konfiguration mit dem folgenden Befehl.

sudo ln -s /etc/nginx/sites-available/testapp /etc/nginx/sites-enabled/
sudo nginx -t

Wenn deine Nginx-Konfiguration fehlerfrei ist, wird die Meldung „syntax is ok“ angezeigt.

4. Starte nun den Nginx-Dienst neu, um eine neue Serverblock-Konfiguration anzuwenden.

sudo systemctl restart nginx

5. Zum Schluss musst du dem Benutzer„www-data“ den Zugriff auf deine Sails.js-Anwendung erlauben.

Ändere dein Arbeitsverzeichnis mit folgendem Befehl in „/home/johndoe“. In diesem Beispiel verwenden wir den Benutzer„johndoe„.

cd /home/johndoe/

Ändere die Eigentümerschaft und die Rechte für das Sails.js-Anwendungsverzeichnis mit dem folgenden Befehl.

sudo chown -R johndoe:www-data testapp
sudo chmod -R g+rw testapp

Damit hast du die Konfiguration von Nginx als Reverse Proxy für die Sails.js-Anwendung abgeschlossen.

Überprüfe deine Sails.js-Anwendung

1. Bearbeite auf deinem Rechner die „hosts“-Konfiguration mit dem folgenden Befehl.

sudo nano /etc/hosts

Kopiere die folgende Konfiguration und füge sie ein. Achte darauf, dass du die IP-Adresse und den Domänennamen durch deinen eigenen ersetzt.

192.168.1.50  dev.example.io

Speichere die Konfiguration und beende sie.

2. Öffne als Nächstes deinen Webbrowser und gib den lokalen Domainnamen deiner Sails.js-Anwendung wie folgt ein.

http://dev.example.io/

Du wirst den Standardindex der Sails.js-Webanwendung sehen.

3. Klicke auf die Schaltfläche„Anmelden„, um die Seite zum Erstellen eines Kontos aufzurufen.

Gib neue Benutzerdaten und ein Passwort ein und klicke dann auf die Schaltfläche„Konto erstellen„.

4. Nachdem du dich angemeldet hast, siehst du die Willkommensnachricht der Sails.js-Anwendung (siehe unten).

Fazit

Herzlichen Glückwunsch! Du hast erfolgreich gelernt, wie du das Sails.js-Framework auf Debian 11 Bullseye installieren kannst. Außerdem hast du gelernt, wie du die Sails.js-Anwendung erstellst und die Sails.js-Anwendung als systemd-Dienst einrichtest.

Und schließlich hast du gelernt, wie du Nginx als Reverse Proxy für deine Sails.js-Anwendung einrichtest.