Zum Inhalt springen

Deployments ohne Ausfall für Node-Apps mit Docker Compose · Teil 10 von 11 der Serie

Teil 10: Die Datenbank ändern ohne Ausfall

Bei jedem Tausch teilen sich zwei Versionen der App eine Datenbank. Lerne die Regel, mit der beide weiterlaufen, und benenne eine Spalte in drei kleinen Deployments um statt in einem riskanten.

Quest-Ziele

  • Verstehen, warum die Datenbank der schwierige Teil eines Deployments ohne Lücke ist
  • Sichere Datenbankänderungen von unsicheren unterscheiden
  • Das Muster Erweitern, Umstellen, Aufräumen anwenden
  • Eine Spalte in drei Deployments umbenennen, während Besucher weiterschreiben
  • Wissen, welcher Schritt sich noch zurückrollen lässt, und vor dem letzten ein Backup machen

Die App wurde inzwischen viele Male ohne Lücke getauscht, und jedes Mal blieb die Datenbank, wie sie war. Früher oder später muss auch sie sich ändern: eine neue Spalte, ein anderer Name, eine Tabelle, die niemand mehr braucht. Das ist der schwierige Teil am Deployen ohne Ausfall, aus zwei Gründen, die du schon kennst.

  • Bei jedem Tausch laufen zwei Versionen gleichzeitig. Ein paar Sekunden lang laufen der alte und der neue Container nebeneinander, und beide sprechen mit der einen Datenbank. Eine zweite Kopie der Daten gibt es nicht.

  • Nach einem Rollback läuft alter Code auf einer neueren Datenbank. production zurückzusetzen, wie in Teil 9, bringt den alten Code zurück. Die alten Tabellen bringt es nicht zurück.

Beides führt zur selben Regel, und sie ist das Einzige, was du dir aus diesem Teil merken musst:

Jede Änderung an der Datenbank muss mit der Version der App funktionieren, die vor ihr lief.

Die Datenbank wird geändert, während sie benutzt wird: Erst kommt ein neuer Ring dazu, und der alte wird erst entfernt, wenn ihn niemand mehr braucht.
Die Datenbank wird geändert, während sie benutzt wird: Erst kommt ein neuer Ring dazu, und der alte wird erst entfernt, wenn ihn niemand mehr braucht.

Sichere und unsichere Änderungen

Erinnere dich an die Reihenfolge in deploy.sh: Erst laufen die Migrationen des neuen Images, und erst danach startet der neue Container. Für einen Moment läuft also die alte Version auf der neuen Datenbank. Ob das gut geht, hängt von der Änderung ab:

  • Sicher: eine neue Tabelle oder eine neue Spalte, die leer bleiben darf. Die alte Version weiß nichts davon, und es stört sie nicht.

  • In einem Schritt nicht sicher: eine Spalte umbenennen, eine Spalte entfernen oder eine Spalte zur Pflicht machen. Die alte Version fragt noch nach dem alten Namen oder schreibt noch Zeilen ohne den neuen Wert, und die Datenbank antwortet mit einem Fehler. Den sehen die Besucher, bis der Tausch vorbei ist. Und besteht die neue Version dann ihren Health Check nicht, bleibt die alte, kaputt.

Erweitern, umstellen, aufräumen

Der Ausweg: eine unsichere Änderung in sichere zerlegen, jede in einem eigenen Deployment. Auf Englisch heißt das Muster expand, switch, contract:

  1. Erweitern: Das Neue kommt neben das Alte. Die App schreibt beides.

  2. Umstellen: Die App liest und schreibt nur noch das Neue.

  3. Aufräumen: Das Alte, das niemand mehr benutzt, kommt weg.

Drei kleine Deployments statt eines riskanten. Das klingt nach mehr Arbeit, und ein bisschen mehr ist es auch. Aber jedes der drei ist langweilig, und langweilig ist genau, was du dir von einer Änderung an deinen Daten wünschst. Dank deiner Pipeline kostet ein Deployment einen git push, drei davon sind also billig.

Das Beispiel: Aus name wird author

In der Tabelle entries steht in der Spalte name, wer einen Eintrag geschrieben hat. Angenommen, sie soll author heißen. Umbenennen ist die klassische unsichere Änderung: In dem Moment, in dem die Spalte umbenannt ist, fragt die laufende Version nach einer Spalte, die es nicht mehr gibt. Das sind die beiden Funktionen in src/db.js, die sie heute benutzen:

src/db.js
export async function listEntries() {
  const { rows } = await pool.query(
    'select name, message, created_at from entries order by created_at desc limit 50',
  );
  return rows;
}

export async function addEntry({ name, message }) {
  await pool.query('insert into entries (name, message) values ($1, $2)', [name, message]);
}

Du änderst diese beiden Funktionen und sonst nichts. Der Rest der App nennt den Wert weiter name: Das Formularfeld, die Prüfung in entries.js und die Seite bleiben, wie sie sind. Nur die Spalte in der Datenbank bekommt ihren neuen Namen.

Deployment 1: erweitern

Die erste Migration legt die neue Spalte neben die alte und kopiert, was schon da ist. Lege migrations/002-add-author.sql an:

migrations/002-add-author.sql
alter table entries add column author text;
update entries set author = name;

Die neue Spalte darf leer sein, also ist das eine sichere Änderung: Die Version, die gerade läuft, erwähnt author nirgends und funktioniert wie zuvor. Ersetze in src/db.js die beiden Funktionen:

src/db.js
export async function listEntries() {
  const { rows } = await pool.query(
    'select coalesce(author, name) as name, message, created_at from entries order by created_at desc limit 50',
  );
  return rows;
}

export async function addEntry({ name, message }) {
  await pool.query('insert into entries (name, author, message) values ($1, $1, $2)', [
    name,
    message,
  ]);
}

Zwei Dinge haben sich geändert:

  • Schreiben: Ein neuer Eintrag legt den Namen in beide Spalten. $1 steht zweimal da, derselbe Wert geht also nach name und nach author.

  • Lesen: coalesce(author, name) heißt: Nimm author, und wenn das leer ist, nimm name. as name reicht das Ergebnis unter dem Namen an die App weiter, den sie schon benutzt.

Wozu das coalesce, wenn die Migration doch gerade jede Zeile gefüllt hat? Wegen des Tauschs. Während der neue Container startet, antwortet der alte noch den Besuchern, und was er in diesen Sekunden schreibt, hat einen name und keinen author. Auch diese Zeilen muss die neue Version anzeigen können.

Committe und pushe, auf deinem Computer:

~/projects/guestbook
$ git add .$ git commit --message "Add the author column beside name"$ git push

Den Rest erledigen die Pipeline und der Server. Im Journal auf dem Server (der journalctl-Befehl aus Teil 8) siehst du, wie die Migration läuft, bevor der neue Container startet:

deploy@guestbook: ~
Nov 17 11:40:01 guestbook deploy.sh[7933]: 11:40:01 New image found, updating the databaseNov 17 11:40:02 guestbook deploy.sh[7933]: Applied 002-add-author.sqlNov 17 11:40:02 guestbook deploy.sh[7933]: Database is up to dateNov 17 11:40:02 guestbook deploy.sh[7933]: 11:40:02 Starting the new containerNov 17 11:40:05 guestbook deploy.sh[7933]: 11:40:05 Visitors now reach guestbook-web-6Nov 17 11:40:05 guestbook deploy.sh[7933]: 11:40:05 Version 51c7e2a is live

Würde sich diese Version als schlecht herausstellen, könntest du ohne Bedenken auf die davor zurückrollen: Der alte Code findet seine Spalte name genau so vor, wie er sie verlassen hat.

Deployment 2: umstellen

Jetzt kann die App die alte Spalte loslassen. Lege migrations/003-author-takes-over.sql an:

migrations/003-author-takes-over.sql
update entries set author = name where author is null;
alter table entries alter column author set not null;
alter table entries alter column name drop not null;

Zeile für Zeile:

  • Die erste Zeile füllt die Lücken: die wenigen Zeilen, die die älteste Version während des letzten Tauschs geschrieben hat, mit name und ohne author.

  • Die zweite macht author zur Pflicht. Das ist jetzt sicher, denn die Version, die in diesem Moment läuft, die aus Deployment 1, schreibt die Spalte bei jedem Eintrag.

  • Die dritte macht name freiwillig, denn der neue Code hört gleich auf, die Spalte zu schreiben.

Und die beiden Funktionen in src/db.js, die jetzt nur noch author kennen:

src/db.js
export async function listEntries() {
  const { rows } = await pool.query(
    'select author as name, message, created_at from entries order by created_at desc limit 50',
  );
  return rows;
}

export async function addEntry({ name, message }) {
  await pool.query('insert into entries (author, message) values ($1, $2)', [name, message]);
}

Prüfe die Regel noch einmal. Während dieses Tauschs läuft die Version aus Deployment 1 noch ein paar Sekunden auf der geänderten Datenbank. Sie schreibt beide Spalten und liest zuerst author, funktioniert also weiter. (Willst du den geänderten Code auf deinem eigenen Computer ausprobieren, führ dort zuerst npm run migrate aus: Auch deine lokale Datenbank braucht die neue Spalte.) Committe und pushe:

~/projects/guestbook
$ git add .$ git commit --message "Read and write author only"$ git push

Von hier an reicht ein Rollback einen Schritt zurück: Die Version aus Deployment 1 funktioniert mit dieser Datenbank, die Versionen davor nicht mehr, weil sie Einträge ohne author schreiben. Das ist der Preis des Weitergehens und der Grund, jedem Schritt etwas Zeit zu lassen, bevor der nächste kommt.

Deployment 3: aufräumen

Die Spalte name ist noch da, und keine laufende Version fasst sie an. Sie zu entfernen ist der eine der drei Schritte, der Daten wegwirft, also mach vorher ein Backup. Auf dem Server, in ~/guestbook:

deploy@guestbook: ~/guestbook
$ docker compose exec -T db pg_dump --username guestbook guestbook > backup-$(date +%F).sql

pg_dump schreibt die ganze Datenbank in eine Datei, mit dem heutigen Datum im Namen. Dann die letzte Migration, migrations/004-drop-name.sql:

migrations/004-drop-name.sql
alter table entries drop column name;

Der Code ändert sich diesmal nicht. Das neue Image unterscheidet sich vom alten nur durch diese Datei, und das genügt dem Server, um es zu deployen:

~/projects/guestbook
$ git add .$ git commit --message "Drop the name column"$ git push

Nach diesem Deployment kann die Version aus Deployment 1 nicht mehr laufen: Sie fragt noch nach name. Deshalb kommt dieser Schritt zuletzt, und er kann warten. Nichts geht kaputt, wenn die alte Spalte noch ein paar Tage bleibt, bis du sicher bist, dass du nicht zurückwillst.

Die Tabelle danach

Frag auf dem Server die Datenbank, wie die Tabelle jetzt aussieht und welche Migrationen sie sich gemerkt hat:

deploy@guestbook: ~/guestbook
$ docker compose exec db psql --username guestbook --command '\d entries'                                       Table "public.entries"   Column   |           Type           | Collation | Nullable |               Default------------+--------------------------+-----------+----------+------------------------------------- id         | integer                  |           | not null | nextval('entries_id_seq'::regclass) message    | text                     |           | not null | created_at | timestamp with time zone |           | not null | now() author     | text                     |           | not null |Indexes:    "entries_pkey" PRIMARY KEY, btree (id)$ docker compose exec db psql --username guestbook --command 'select name, applied_at from migrations'           name            |          applied_at---------------------------+------------------------------- 001-create-entries.sql    | 2026-11-17 09:58:50.517409+00 002-add-author.sql        | 2026-11-17 11:40:02.723909+00 003-author-takes-over.sql | 2026-11-17 11:52:02.190963+00 004-drop-name.sql         | 2026-11-17 12:03:02.324678+00(4 rows)

Die Spalte heißt author, sie ist Pflicht, und name ist weg. Die Tabelle migrations ist die Liste, die migrate.js führt, und deshalb lief jede Datei genau einmal.

Hat es jemand bemerkt?

Für diese Serie liefen die drei Deployments direkt nacheinander, während ein Lasttest das Gästebuch ununterbrochen las und unterschrieb, verbunden so, wie Browser es tun. Von etwa 34.000 Anfragen, abgeschickte Formulare eingeschlossen, schlug keine einzige fehl. Die Spalte hat ihren Namen unter den Händen der Besucher gewechselt.

Was du jetzt hast

Einen Weg, die Datenbank zu ändern, bei dem nie eine laufende Version ohne die Spalten dasteht, die sie erwartet: erst hinzufügen, dann umstellen, zuletzt entfernen. Damit ist das Letzte verschwunden, was eine Lücke erzwingen könnte.

Eines fehlt noch. Der Server deployt von selbst, und niemand schaut zu, wenn er es tut. In Teil 11 sagt er dir, wie jedes Deployment gelaufen ist.

Kommentare

Die Kommentare sind GitHub Discussions: Zum Schreiben mit GitHub anmelden.

Die Kommentare kommen über giscus von GitHub. Beim Laden gehen deine IP-Adresse an giscus.app und GitHub.