Cloud und Docker
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.
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.
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.
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.
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.
| Image | Firebird | Firebird-Port | HQ Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
Erster Start
- 1compose.yamlaus dem Kit in einen Ordner auf dem Host kopieren
- 2SYSDBA-Passwortin eine geheime Datei, die nur Sie lesen können
- 3Image, Name, Secrets
imageundhostnamesetzen, das#aus densecrets:-Zeilen entfernen - 4docker compose up -dder Container installiert HQbird
- 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/, Loginadmin. - Der Installer erstellt das Konsolen-Passwort. Es steht in der Datei
/opt/hqbird/conf/access.propertiesim Container. - Der Agent-Name in HQCenter: der Hostname, das Installationsdatum und die Firebird-Linie.
Tägliche Arbeit
| Aufgabe | Befehl |
|---|---|
| Dienststatus | docker compose exec hqbird systemctl list-units --type=service |
| Firebird neu starten | docker compose exec hqbird systemctl restart firebirdFirebird 3.0: der Dienst firebird-superserver |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb |
| Log für eine Stunde | docker compose logs --since 1h |
| Stoppen | docker 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.
| Einstellung | Was sie bewirkt |
|---|---|
HQBIRD_FB_PORT | Firebird-Port im Container, standardmäßig 3050. HQ Monitor lauscht auf 20000 + diesem Port. |
HQBIRD_HQM_PORT | Ein anderer HQ Monitor-Port. |
HQBIRD_AGENT_ID | Agent-Name. Standardmäßig wird er aus dem Hostnamen, dem Datum und dem Port gebildet. |
HQBIRD_HQM_LOGIN, Secret hqmonitor_password | HQ Monitor Login und Passwort. |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE | Anfrage für eine Testlizenz. |
Secret sysdba_password | SYSDBA-Passwort des neuen Firebird. |
Secret license | Lizenzdatei. |
Secret attach | Die Datei attach.json aus HQCenter: sie verbindet den Agent mit Ihrem Center. |
| Volume | Pfad | Inhalt |
|---|---|---|
db | /db | Datenbanken. Legen Sie Ihre Datenbanken hier ab. |
backup | /backup | Sicherungen. |
opt | /opt | Firebird, der Agent, HQ Monitor, Cluster-Knoten, RCM. |
state | /var/lib/hqbird-container | Dienste, Konsolendaten, Agent-Protokolle, Maschinen-ID. |
trust | /usr/libexec/hqbird-fbagent | Vertrauenswürdiger Start von Agent-Updates. |
rootwork | /var/lib/hqbird-fbagent | Arbeitsordner für Updates. |
- Host-Ordner nur für Datenbanken und SicherungenSie können die Volumes
dbundbackupdurch Host-Ordner ersetzen. Geben Sie sie dem Benutzer mit der uid 84: das ist der Benutzerfirebirdim 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
stateund an den Agent-Namen gebunden. Ein neues Volumestateist eine neue Installation. - Verbinden Sie sich mit einer Datei mit dem CenterDas Secret
attachverbindet 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.
| Port | Was | Wann benötigt |
|---|---|---|
HQBIRD_FB_PORT (3050) | Firebird | immer |
| 20000 + Firebird-Port (23050) | HQ Monitor | immer |
| Knoten-Port (7051) | Cluster-Knoten | die Instanz tritt einem Cluster bei |
| 7443, 7444 | RCM und seine Weboberfläche | dieser 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 1 | Instanz 2 | |
|---|---|---|
| Projekt- und Hostname | hqbird-fb40-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| Ports | 3051, 23051, 7052 | 3052, 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:7444in 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.
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.
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
-Tund</dev/nullhinzu. 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 verifyist 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.