mitmario.dev

Vom Rechner ins Netz

Node.js Sandbox 3 Min Lesezeit 2 BeispieleLektion 4 von 7

„Läuft bei mir“ ist eine präzise Aussage. Das Programm läuft in einer Umgebung, die über Monate gewachsen ist, mit einem freien Port 3000, einer Datenbankdatei neben dem Code und einem Secret, nach dem nie jemand gefragt hat. Auf einem Server ist davon nichts selbstverständlich.

Welcher Anbieter der richtige ist, steht hier mit Absicht nicht. Das ändert sich alle paar Jahre, die Liste weiter unten nicht.

Was auf deinem Rechner alles gesetzt ist

Läuft bei mir
import { createServer } from "node:http";
import { createHmac } from "node:crypto";
import { DatabaseSync } from "node:sqlite";

// Drei Annahmen, die nur auf deinem Rechner stimmen.
const PORT = 3000;
const SECRET = "bitte-aendern";
const db = new DatabaseSync("./bibliothek.db");

db.exec("CREATE TABLE IF NOT EXISTS buecher (id INTEGER PRIMARY KEY)");

const server = createServer((req, res) => {
  console.log(`${req.method} ${req.url}`);
  const kennung = createHmac("sha256", SECRET).update("nutzer=7").digest("hex").slice(0, 16);

  res.setHeader("Set-Cookie", `sid=${kennung}; Path=/`);
  res.setHeader("Content-Type", "text/html; charset=utf-8");
  res.end([
    "<!doctype html>",
    '<meta charset="utf-8">',
    "<title>Läuft</title>",
    "<h1>Läuft</h1>",
    `<p>Deine Sitzungskennung für diese Anfrage: <code>${kennung}</code></p>`,
    "<p>Sie ist bei jedem Aufruf dieselbe, und das Secret dazu steht im Quelltext.</p>",
  ].join("\n"));
});

server.listen(PORT, () => console.log(`läuft auf http://localhost:${PORT}`));

Jede der drei Zeilen setzt etwas voraus. Der Port ist fest, das Secret steht im Code, und die Datenbankdatei liegt neben dem Programm. Auf dem eigenen Rechner ist jede davon richtig, im Betrieb jede falsch, und zwar jede aus einem anderen Grund. Das console.log darf bleiben, es schreibt schon nach stdout. Im Betrieb ist nur eine Zeile JSON besser als freier Text, weil die Umgebung sie durchsuchen kann.

Das Beispiel läuft, und im Reiter Browser steht die Seite dazu. Nach jedem Klick auf Seite neu laden steht dieselbe Sitzungskennung da. Ausrechnen kann sie jeder, der den Quelltext hat, denn das Secret steht darin. Damit lässt sich jede Kennung ausstellen, und das ist der zweite Punkt der Liste.

Dieselbe Datei, betriebsfähig

Und läuft auch woanders
import { createServer } from "node:http";
import { DatabaseSync } from "node:sqlite";

// Der Port kommt von aussen. Wer ihn festverdrahtet, laesst den
// Anbieter ins Leere greifen.
const PORT = Number(process.env.PORT ?? 3000);

// Die Datenbankdatei liegt nicht im Anwendungsverzeichnis, sondern
// dort, wo die Umgebung sie hinlegt.
const DB_PFAD = process.env.DB_PFAD ?? "./bibliothek.db";

// Kein Standardwert fuer ein Secret. Fehlt es, startet nichts.
if (!process.env.SITZUNGS_SECRET) {
  throw new Error("Start abgebrochen: SITZUNGS_SECRET fehlt.");
}

const db = new DatabaseSync(DB_PFAD);
db.exec("CREATE TABLE IF NOT EXISTS buecher (id INTEGER PRIMARY KEY)");

const server = createServer((req, res) => {
  // Protokoll nach stdout, eine Zeile JSON. Wer es in eine Datei
  // schreibt, sucht sie spaeter in einem Container, den es nicht mehr gibt.
  process.stdout.write(JSON.stringify({ stufe: "info", methode: req.method, pfad: req.url }) + "\n");
  res.end("ok");
});

server.listen(PORT, () => {
  process.stdout.write(JSON.stringify({ stufe: "info", ereignis: "start", port: PORT }) + "\n");
});

// Der Anbieter schickt SIGTERM und wartet ein paar Sekunden.
process.on("SIGTERM", () => {
  process.stdout.write(JSON.stringify({ stufe: "info", ereignis: "fahre herunter" }) + "\n");
  server.close(() => process.exit(0));
});

Startest du dieses Beispiel, kommt es nur bis Zeile 14. Dort bricht es mit Error: Start abgebrochen: SITZUNGS_SECRET fehlt. ab, bevor ein Port aufgeht. In der Sandbox steht nämlich kein SITZUNGS_SECRET in der Umgebung. Im Betrieb setzt der Anbieter es, und ohne Secret soll hier nichts laufen.

Die Liste zum Abhaken, in der Reihenfolge, in der sie einem sonst um die Ohren fliegt:

PunktWarum
Port aus der UmgebungDer Anbieter sagt, auf welchem Port der Prozess hören soll. Ein fester Port heißt, dass nie jemand ankommt.
Secrets aus der UmgebungUnd ohne Standardwert, sonst läuft der Betrieb mit einem Schlüssel, den jeder kennt (vorige Lektion).
npm ci --omit=devNimmt das Lockfile wörtlich und lässt die Entwicklungspakete weg. Was in der falschen Liste steht, fehlt dann, und das ist der Sinn (5.2).
Ein ProzessmanagerStirbt der Prozess, muss ihn jemand neu starten. Abstürzen ist richtig, liegen bleiben nicht (16.4).
HTTPS macht jemand davorEin Reverse Proxy, also ein Server, der die verschlüsselten Anfragen annimmt und unverschlüsselt an den Node-Prozess weiterreicht, oder der Anbieter selbst. Der Node-Prozess spricht weiter HTTP, so teilt man das üblicherweise auf.
Protokoll nach stdoutWer in eine Datei schreibt, sucht sie später in einem Container, den es nicht mehr gibt. Das Einsammeln ist Aufgabe der Umgebung (Abschnitt 16, „Protokollieren“).
Sauber herunterfahrenSIGTERM kommt bei jedem Deployment. Wer ihn ignoriert, bricht laufende Anfragen ab (Abschnitt 16).

Wo die Daten liegen, ist die erste Frage

In der Tabelle fehlt noch die Datenbankdatei. Sie gehört nicht ins Anwendungsverzeichnis. Bei einem Anbieter, der aus dem Repository baut, entsteht dieses Verzeichnis bei jedem Deployment neu, und was hineingeschrieben wurde, ist danach weg.

Vor der Frage nach dem Anbieter stehen bei einem Deployment deshalb drei andere:

  1. Wo liegen die Daten, und überleben sie ein Deployment?
  2. Wer sichert sie, wie oft, und ist eine Sicherung schon einmal zurückgespielt worden?
  3. Was passiert, wenn der Anbieter gewechselt werden soll?

Was ein Container löst

Ein Container packt das Programm samt Node-Version, Systembibliotheken und Startbefehl in ein Abbild, das überall gleich läuft. Damit ist ein Problem gelöst.

Nicht gelöst ist alles andere. Der Container hat immer noch keine Daten, keine Secrets, kein HTTPS und keinen, der ihn neu startet. Und der Code ist derselbe geblieben.

Ein kleines Projekt ist oft bei einem Anbieter gut aufgehoben, der aus dem Repository baut, Umgebungsvariablen und einen verwalteten Speicher gibt und den Neustart übernimmt. So ein Anbieter nimmt dir drei Punkte ganz ab, den Neustart, HTTPS und npm ci. Für drei weitere liefert er, was der Code braucht. Das saubere Herunterfahren bleibt Sache des eigenen Codes, und der Handler dafür steht seit Abschnitt 16 schon da.

Zum Mitnehmen

Port und Secrets kommen aus der Umgebung, das Protokoll geht nach stdout, und die Datenbank liegt dort, wo ein Deployment sie nicht löscht. Ein Container macht die Umgebung gleich, betriebsfähig wird die Anwendung dadurch noch nicht.

Jetzt du

Basis Konto, kostenlos

Im Editor änderst du die Beispiele dieser Lektion und lässt sie gleich laufen. So merkst du am schnellsten, ob es sitzt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.

Was in dieser Lektion steckt

  • Artikel mit 2 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.