Diese Seite wurde maschinell übersetzt. Lesen Sie das englische Original. English

Cloud und Docker

HQbird funktioniert auf einem Cloud-Server genauso wie auf Ihrem eigenen Server. Für Docker gibt es ein fertiges Image für jede Firebird-Linie. Backups gehen direkt nach S3, ohne Datei auf der Serverfestplatte. Die Verbindung zum Center benötigt keine eingehenden Ports.

  • 4 Images Firebird 5 · 4 · 3 · 2.5
  • 1 Container Firebird, Agent und Konsole
  • S3 Backup ohne Datei auf der Festplatte
  • 0 eingehende Ports für die Verbindung zum Center
  • 200–250 MB Arbeitsspeicher pro inaktiver Instanz

Server · Container · Speicher

Drei Teile einer Cloud-Installation

Sie können HQbird mit dem normalen Installer auf einem Cloud-Server installieren oder in einem Docker-Container ausführen. In beiden Fällen verbindet sich der Agent selbstständig mit HQCenter, und Backups können in den S3-Speicher gehen.

Diagramm: Anwendungen und der Browser verbinden sich mit dem HQbird-Container auf dem Host; der Agent verbindet sich selbstständig mit HQCenter und sendet Backups an S3 cloud server or Docker host HQbird Firebird fbagent HQ Monitor volumes: /db · /backup · /opt ports: 3050 · 23050 cluster: 7051 · 7443 · 7444 Clients Firebird port 3050 Browser HQ Monitor 23050 HQCenter agent connects out S3 backups, HTTPS
Wer sich mit wem verbindet. Anwendungen und der Browser kommen über die Ports von Firebird und HQ Monitor herein. Der Agent verbindet sich selbstständig mit HQCenter und S3: dafür sind keine eingehenden Ports erforderlich.
Server

Normaler Installer

Eine Datei installiert Firebird, den Agent und die Konsole auf einem Cloud-Server. Der Installer selbst lädt nichts herunter. Gut geeignet, wenn der ganze Server für die Datenbank bestimmt ist.

Container

Docker-Image

Ein Container ist ein Firebird mit allen HQbird-Komponenten. Die Daten liegen auf Volumes und bleiben erhalten, wenn Sie den Container oder das Image ersetzen.

Speicher

Backups nach S3

gbak und nbackup schreiben in einen Stream, und der Stream geht in einen Bucket. Das Backup benötigt keinen Platz auf der Serverfestplatte. Es funktioniert sowohl auf einem Server als auch in einem Container.

Mehr auf der Backup-Seite →

Images · erster Start · compose

HQbird in Docker

Der Container installiert HQbird mit demselben Installer wie ein Server. Firebird, der Agent fbagent und HQ Monitor laufen darin. Der Agent installiert den Cluster-Knoten selbst, wenn die Instanz einem Cluster beitritt. RCM installiert er nur, wenn diese Instanz als Cluster-RCM zugewiesen ist.

Die Images liegen in der IBSurgeon GitHub Container Registry. Sie sind öffentlich: Sie müssen sich nicht bei der Registry anmelden. Das Image-Tag ist die Version des HQbird-Kits.

ImageFirebirdFirebird-PortHQ Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050

Erster Start

  1. 1compose.yamlaus dem Kit in einen Ordner auf dem Host kopieren
  2. 2SYSDBA-Passwortin eine geheime Datei, die nur Sie lesen können
  3. 3Image, Name, Secretsimage und hostname setzen, das # aus den secrets:-Zeilen entfernen
  4. 4docker compose up -dder Container installiert HQbird
  5. 5✓ healthyFirebird und die Konsole antworten
mkdir -p secrets
openssl rand -hex 12 > secrets/sysdba_password
chmod 600 secrets/sysdba_password
docker compose up -d
docker compose logs -f   # installation progress
docker compose ps        # wait for healthy

Auf einem Server mit 2 Kernen dauert die Installation beim ersten Start etwa 20 Sekunden.

Was Sie erhalten

  • Firebird: <Docker host>:3050.
  • HQ Monitor: http://<Docker host>:23050/, Login admin.
  • Der Installer erstellt das Konsolen-Passwort. Es steht in der Datei /opt/hqbird/conf/access.properties im Container.
  • Der Agent-Name in HQCenter: der Hostname, das Installationsdatum und die Firebird-Linie.

Tägliche Arbeit

AufgabeBefehl
Dienststatusdocker compose exec hqbird systemctl list-units --type=service
Firebird neu startendocker compose exec hqbird systemctl restart firebird
Firebird 3.0: der Dienst firebird-superserver
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Log für eine Stundedocker compose logs --since 1h
Stoppendocker compose stop: Firebird schließt die Datenbanken

Im Container steuert der Befehl systemctl die HQbird-Dienste, ist aber kein systemd. Er versteht die Befehle, die HQbird-Programme verwenden: start, stop, restart, status, list-units und andere.

Variablen · Secrets · Volumes

Einstellungen und Volumes

Der Container liest die Einstellungen nur einmal, beim ersten Start: das ist die Installation. Daten, Konfiguration, die Lizenz und aktualisierte Programme liegen auf Volumes. Sie bleiben erhalten, wenn Sie den Container neu erstellen oder das Image ändern.

EinstellungWas sie bewirkt
HQBIRD_FB_PORTFirebird-Port im Container, standardmäßig 3050. HQ Monitor lauscht auf 20000 + diesem Port.
HQBIRD_HQM_PORTEin anderer HQ Monitor-Port.
HQBIRD_AGENT_IDAgent-Name. Standardmäßig wird er aus dem Hostnamen, dem Datum und dem Port gebildet.
HQBIRD_HQM_LOGIN, Secret hqmonitor_passwordHQ Monitor Login und Passwort.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONEAnfrage für eine Testlizenz.
Secret sysdba_passwordSYSDBA-Passwort des neuen Firebird.
Secret licenseLizenzdatei.
Secret attachDie Datei attach.json aus HQCenter: sie verbindet den Agent mit Ihrem Center.
VolumePfadInhalt
db/dbDatenbanken. Legen Sie Ihre Datenbanken hier ab.
backup/backupSicherungen.
opt/optFirebird, der Agent, HQ Monitor, Cluster-Knoten, RCM.
state/var/lib/hqbird-containerDienste, Konsolendaten, Agent-Protokolle, Maschinen-ID.
trust/usr/libexec/hqbird-fbagentVertrauenswürdiger Start von Agent-Updates.
rootwork/var/lib/hqbird-fbagentArbeitsordner für Updates.
  • Host-Ordner nur für Datenbanken und SicherungenSie können die Volumes db und backup durch Host-Ordner ersetzen. Geben Sie sie dem Benutzer mit der uid 84: das ist der Benutzer firebird im Image. Ersetzen Sie die anderen vier Volumes nicht durch Host-Ordner.
  • Sicherung der VolumesSichern Sie alle sechs Volumes zusammen.
  • Ändern Sie den Hostnamen nichtDie Lizenz ist an die Maschinen-ID auf dem Volume state und an den Agent-Namen gebunden. Ein neues Volume state ist eine neue Installation.
  • Verbinden Sie sich mit einer Datei mit dem CenterDas Secret attach verbindet den Agent beim ersten Start mit HQCenter. Dafür müssen Sie nicht in den Container gehen.

Port-Veröffentlichung · Firewall · zweite Instanz

Ports und mehrere Instanzen

Veröffentlichen Sie jeden Port mit derselben Nummer außerhalb und innerhalb des Containers: 3051:3051, nicht 3051:3050. Der Agent und der Cluster melden den Port, den sie innerhalb des Containers sehen.

PortWasWann benötigt
HQBIRD_FB_PORT (3050)Firebirdimmer
20000 + Firebird-Port (23050)HQ Monitorimmer
Knoten-Port (7051)Cluster-Knotendie Instanz tritt einem Cluster bei
7443, 7444RCM und seine Weboberflächedieser Agent betreibt RCM; einer pro Host

Docker veröffentlicht Ports an ufw vorbei. Wir haben es geprüft: Mit der ufw-Regel „nur Port 22“ waren die Ports von Firebird und HQ Monitor aus dem Internet offen. Verwenden Sie eine externe Firewall, veröffentlichen Sie den Port auf einer Host-Adresse ("10.0.0.5:23050:23050") oder fügen Sie Regeln zur iptables-Kette DOCKER-USER hinzu.

Zweite Instanz auf demselben Host

Jede Instanz benötigt ihren eigenen Ordner, Projektnamen, Hostnamen und eigene Ports. Der Projektname legt die Volume-Namen fest. Bei gleichem Namen übernimmt der zweite Start die Volumes und den Container des ersten.

  • Firebird: 3050 + N.
  • HQ Monitor: 20000 + Firebird-Port.
  • Cluster-Knoten: 7051 + N.
  • Nur eine Instanz auf dem Host kann RCM betreiben.

Andere Firebird-Versionen auf demselben Host folgen denselben Regeln, jede mit ihrem eigenen Image.

Instanz 1Instanz 2
Projekt- und Hostnamehqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Ports3051, 23051, 70523052, 23052, 7053
  • SpeicherEine im Leerlauf befindliche Instanz belegt etwa 200–250 MB. Wir haben es geprüft: drei Firebird 4.0-Instanzen auf einem Server mit 2 Kernen und 4 GB Speicher, eine davon unter Last.
  • Firebird außerhalb von Docker auf demselben HostWenn Firebird oder HQbird bereits ohne Docker auf dem Host läuft, überspringen Sie die Ports 3050, 23050 und 7051.

HQCenter · neues Image · Cluster

Updates und Cluster

Sie können einen Container auf zwei Arten aktualisieren. Beide behalten die Daten.

Von HQCenter aus

Wie auf einem normalen Server: Das Center aktualisiert den Agent, HQ Monitor, Firebird, den Cluster-Knoten und RCM im Container. Die aktualisierten Programme liegen auf einem Volume und bleiben daher nach einem Neustart erhalten.

Mit einem neuen Image

Ändern Sie die Version in der Zeile image und führen Sie aus:

docker compose pull
docker compose up -d

Beim Start führt der Container den Installer des neuen Images im Update-Modus aus. Wenn das Center den Agent bereits auf eine neuere Version als die im Image aktualisiert hat, wird der Installer nicht ausgeführt: Die Version wird nicht herabgesetzt.

Container in einem Cluster

Eine Instanz in einem Container tritt einem Cluster auf dieselbe Weise bei wie ein Server. Die Mitgliedsadresse ist die Adresse des Docker-Hosts. Veröffentlichen Sie die Cluster-Ports in compose.yaml.

  • Der Knoten-Port, zum Beispiel 7051: wenn die Instanz ein Cluster-Mitglied ist.
  • Ports 7443 und 7444: wenn dieser Agent RCM betreibt. Für die Weboberfläche auf 7444 setzen Sie operator_addr = 0.0.0.0:7444 in den RCM-Einstellungen.
  • Der Knoten-Port in der Cluster-Beschreibung muss mit dem veröffentlichten Port übereinstimmen.

Der Agent installiert den Knoten einige Minuten nach dem Speichern des Clusters. Bis dahin antwortet der Knoten-Port nicht.

Mehr über Cluster und Replikation →

Cloud-Server · NAT · Firewall

HQbird auf einem Cloud-Server

Auf einem Cloud-Server installieren Sie HQbird mit dem normalen Installer: eine Datei, ein Befehl. Firebird, der Agent und die Konsole sind in der Datei enthalten: Der Installer lädt nichts herunter. Unter Linux bezieht er einige OS-Bibliotheken (libtommath, ICU) aus dem Repository der Distribution. Wenn kein Repository vorhanden ist, gibt er die genauen Befehle aus und ändert nichts.

  • Keine eingehenden Ports für das CenterDer Agent verbindet sich selbstständig mit HQCenter. Ein Server hinter NAT oder in einem privaten Cloud-Netzwerk sieht im Center genauso aus wie ein Server in Ihrem Rack.
  • OS-FirewallDer Installer öffnet den Port des neuen Firebird und den HQ Monitor-Port in firewalld oder ufw. Die Firewall-Regeln der Cloud selbst richten Sie ein.
  • Server-AnforderungenMindestens 2 GB Speicher, 2 Kerne und 5 GB Festplatte. Linux x86-64 oder Windows.
  • Linux-DistributionenUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS und andere mit apt, dnf, yum oder zypper.
  • Hundert Server per SkriptJeder Installationsschritt ist als Schalter verfügbar. Sie können zuerst den Installationsplan anzeigen: Der Befehl ändert nichts.
  • Secrets sind geschütztEin Secret, das Sie in der Konsole eingeben, wird verschlüsselt an den Agent übergeben. Secrets werden in Berichten und in Konfigurationskopien ausgeblendet. In der Konfigurationsdatei des Agent ist der S3-Schlüssel nicht verschlüsselt: Beschränken Sie den Zugriff auf diese Datei. Auf einem Amazon EC2-Server können Sie ohne Schlüssel arbeiten: Der Agent verwendet die IAM-Rolle des Servers.
  • Metriken in Ihrem GrafanaDer Agent exportiert Firebird- und Server-Metriken im Prometheus-Format.
  • Cloud-Festplatte unter KontrolleDer Agent misst die Lese- und Schreiblatenz und prognostiziert, wann die Festplatte voll wird. Eine langsame oder fast volle Cloud-Festplatte ist im Health-Bericht sichtbar.

Mehr über Installation und Updates →

Grenzen · Tipps

Gut zu wissen

  • Docker und ufwEin veröffentlichter Container-Port ist an ufw vorbei offen. Schließen Sie ihn mit einer externen Firewall oder veröffentlichen Sie ihn auf einer Adresse.
  • Einstellungen nur beim ersten StartVariablen und Secrets werden einmal gelesen. Sie können den Firebird-Port, den Hostnamen und die Secrets später nicht ändern: Sie benötigen eine neue Installation. Jobs und andere Agent-Einstellungen ändern Sie in HQ Monitor oder vom Center aus.
  • Skripte mit docker compose execFügen Sie in Skripten den Schalter -T und </dev/null hinzu. Ohne diese liest der Befehl die Standardeingabe und nimmt den Rest des Skripts.
  • Warnungen vor der Verbindung mit dem CenterBis der Agent sich mit HQCenter verbindet, meldet sein Protokoll, dass die Verbindungseinstellungen unvollständig sind. Das ist normal.
  • Image-SignaturDie Images sind mit dem Tool cosign signiert. Der öffentliche Schlüssel zur Prüfung mit dem Befehl cosign verify ist noch nicht veröffentlicht.
  • Wo es getestet wurdeUbuntu 22.04, Docker mit Compose, ein Server mit 2 Kernen und 4 GB Speicher. Eine Schritt-für-Schritt-Installationsanleitung für Ubuntu ist auf Russisch und Portugiesisch verfügbar.

← Zurück zur HQbird 2027-Übersicht