Deze pagina is automatisch vertaald. Lees het Engelse origineel. English

Cloud en Docker

HQbird werkt op een cloudserver op dezelfde manier als op je eigen server. Voor Docker is er een kant-en-klare image voor elke Firebird-lijn. Back-ups gaan rechtstreeks naar S3, zonder bestand op de schijf van de server. De verbinding met het centrum heeft geen inkomende poorten nodig.

  • 4 images Firebird 5 · 4 · 3 · 2.5
  • 1 container Firebird, agent en console
  • S3 back-up zonder bestand op schijf
  • 0 inkomende poorten voor de verbinding met het centrum
  • 200–250 MB geheugen per inactieve instantie

Server · container · opslag

Drie onderdelen van een cloudinstallatie

Je kunt HQbird op een cloudserver installeren met de normale installer of het in een Docker-container draaien. In beide gevallen maakt de agent zelf verbinding met HQCenter, en back-ups kunnen naar S3-opslag gaan.

Diagram: applicaties en de browser maken verbinding met de HQbird-container op de host; de agent maakt zelf verbinding met HQCenter en stuurt back-ups naar S3 cloudserver of Docker-host HQbird Firebird fbagent HQ Monitor volumes: /db · /backup · /opt poorten: 3050 · 23050 cluster: 7051 · 7443 · 7444 Clients Firebird-poort 3050 Browser HQ Monitor 23050 HQCenter agent maakt uitgaand verbinding S3 back-ups, HTTPS
Wie verbindt met wie. Applicaties en de browser komen binnen via de poorten van Firebird en HQ Monitor. De agent maakt zelf verbinding met HQCenter en S3: hiervoor zijn geen inkomende poorten nodig.
Server

Normale installer

Eén bestand installeert Firebird, de agent en de console op een cloudserver. De installer zelf downloadt niets. Geschikt wanneer de hele server voor de database is.

Container

Docker-image

Eén container is één Firebird met alle HQbird-componenten. Gegevens staan op volumes en blijven behouden wanneer je de container of de image vervangt.

Opslag

Back-ups naar S3

gbak en nbackup schrijven naar een stream, en de stream gaat naar een bucket. De back-up heeft geen ruimte op de schijf van de server nodig. Het werkt zowel op een server als in een container.

Meer op de back-uppagina →

Images · eerste start · compose

HQbird in Docker

De container installeert HQbird met dezelfde installer als een server. Firebird, de fbagent-agent en HQ Monitor draaien erin. De agent installeert zelf het clusternode wanneer de instantie lid wordt van een cluster. RCM wordt alleen geïnstalleerd wanneer deze instantie is aangewezen als de cluster-RCM.

De images staan in de IBSurgeon GitHub Container Registry. Ze zijn openbaar: je hoeft niet in te loggen bij de registry. De image-tag is de versie van de HQbird-kit.

ImageFirebirdFirebird-poortHQ 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

Eerste start

  1. 1compose.yamlkopieer het uit de kit naar een map op de host
  2. 2SYSDBA-wachtwoordin een geheim bestand dat alleen jij kunt lezen
  3. 3Image, naam, secretsstel image en hostname in, verwijder de # uit de regels secrets:
  4. 4docker compose up -dde container installeert HQbird
  5. 5✓ healthyFirebird en de console reageren
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

Op een server met 2 cores duurt de installatie bij de eerste start ongeveer 20 seconden.

Wat je krijgt

  • Firebird: <Docker host>:3050.
  • HQ Monitor: http://<Docker host>:23050/, login admin.
  • De installer maakt het consolewachtwoord aan. Het staat in het bestand /opt/hqbird/conf/access.properties in de container.
  • De agentnaam in HQCenter: de hostnaam, de installatiedatum en de Firebird-lijn.

Dagelijks werk

TaakOpdracht
Servicestatusdocker compose exec hqbird systemctl list-units --type=service
Firebird herstartendocker compose exec hqbird systemctl restart firebird
Firebird 3.0: de service firebird-superserver
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Log van één uurdocker compose logs --since 1h
Stoppendocker compose stop: Firebird sluit de databases

In de container beheert de opdracht systemctl de HQbird-services, maar het is geen systemd. Het begrijpt de opdrachten die HQbird-programma's gebruiken: start, stop, restart, status, list-units en andere.

Variabelen · secrets · volumes

Instellingen en volumes

De container leest de instellingen slechts één keer, bij de eerste start: dat is de installatie. Gegevens, configuratie, de licentie en bijgewerkte programma's staan op volumes. Ze blijven behouden wanneer je de container opnieuw aanmaakt of de image wijzigt.

InstellingWat het doet
HQBIRD_FB_PORTFirebird-poort in de container, standaard 3050. HQ Monitor luistert op 20000 + deze poort.
HQBIRD_HQM_PORTEen andere HQ Monitor-poort.
HQBIRD_AGENT_IDAgentnaam. Standaard wordt deze samengesteld uit de hostnaam, de datum en de poort.
HQBIRD_HQM_LOGIN, secret hqmonitor_passwordHQ Monitor-login en -wachtwoord.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONEAanvraag voor een proeflicentie.
secret sysdba_passwordSYSDBA-wachtwoord van de nieuwe Firebird.
secret licenseLicentiebestand.
secret attachHet bestand attach.json uit HQCenter: het verbindt de agent met jouw centrum.
VolumePadInhoud
db/dbDatabases. Plaats hier je databases.
backup/backupBack-ups.
opt/optFirebird, de agent, HQ Monitor, clusternode, RCM.
state/var/lib/hqbird-containerServices, consolgegevens, agentlogboeken, machine-ID.
trust/usr/libexec/hqbird-fbagentVertrouwde start van agentupdates.
rootwork/var/lib/hqbird-fbagentWerkmap voor updates.
  • Alleen hostmappen voor databases en back-upsJe kunt de volumes db en backup vervangen door hostmappen. Geef ze aan de gebruiker met uid 84: dit is de gebruiker firebird in de image. Vervang de andere vier volumes niet door hostmappen.
  • Back-up van de volumesSla alle zes volumes samen op.
  • Wijzig de hostnaam nietDe licentie is gebonden aan de machine-ID op het volume state en aan de agentnaam. Een nieuw volume state is een nieuwe installatie.
  • Verbind met het centrum met één bestandHet geheim attach verbindt de agent bij de eerste start met HQCenter. Je hoeft hiervoor niet in de container in te loggen.

Poorten publiceren · firewall · tweede instantie

Poorten en meerdere instanties

Publiceer elke poort met hetzelfde nummer buiten en binnen de container: 3051:3051, niet 3051:3050. De agent en het cluster rapporteren de poort die ze binnen de container zien.

PoortWatWanneer nodig
HQBIRD_FB_PORT (3050)Firebirdaltijd
20000 + Firebird-poort (23050)HQ Monitoraltijd
nodepoort (7051)clusternodede instantie sluit zich aan bij een cluster
7443, 7444RCM en zijn webinterfacedeze agent draait RCM; één per host

Docker publiceert poorten buiten ufw om. We hebben het gecontroleerd: met de ufw-regel "alleen poort 22" waren de Firebird- en HQ Monitor-poorten open vanaf het internet. Gebruik een externe firewall, publiceer de poort op één hostadres ("10.0.0.5:23050:23050") of voeg regels toe aan de iptables-keten DOCKER-USER.

Tweede instantie op dezelfde host

Elke instantie heeft zijn eigen map, projectnaam, hostnaam en poorten nodig. De projectnaam bepaalt de volumenamen. Met dezelfde naam neemt de tweede start de volumes en de container van de eerste over.

  • Firebird: 3050 + N.
  • HQ Monitor: 20000 + Firebird-poort.
  • Clusternode: 7051 + N.
  • Slechts één instantie op de host kan RCM draaien.

Andere Firebird-versies op dezelfde host volgen dezelfde regels, elk met hun eigen image.

Instantie 1Instantie 2
Project- en hostnaamhqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Poorten3051, 23051, 70523052, 23052, 7053
  • GeheugenEén inactieve instantie gebruikt ongeveer 200–250 MB. We hebben het gecontroleerd: drie Firebird 4.0-instanties op een server met 2 cores en 4 GB geheugen, waarvan één onder belasting.
  • Firebird buiten Docker op dezelfde hostAls Firebird of HQbird al op de host draait zonder Docker, sla dan poorten 3050, 23050 en 7051 over.

HQCenter · nieuwe image · cluster

Updates en cluster

Je kunt een container op twee manieren bijwerken. Beide behouden de gegevens.

Vanuit HQCenter

Zoals op een normale server: het centrum werkt de agent, HQ Monitor, Firebird, de clusternode en RCM in de container bij. De bijgewerkte programma's staan op een volume, dus ze blijven na een herstart behouden.

Met een nieuwe image

Wijzig de versie in de regel image en voer uit:

docker compose pull
docker compose up -d

Bij de start voert de container het installatieprogramma van de nieuwe image uit in updatemodus. Als het centrum de agent al heeft bijgewerkt naar een versie nieuwer dan die in de image, wordt het installatieprogramma niet uitgevoerd: de versie gaat niet omlaag.

Container in een cluster

Een instantie in een container sluit zich op dezelfde manier aan bij een cluster als een server. Het lidadres is het adres van de Docker-host. Publiceer de clusterpoorten in compose.yaml.

  • De nodepoort, bijvoorbeeld 7051: wanneer de instantie een clusterlid is.
  • Poorten 7443 en 7444: wanneer deze agent RCM draait. Stel voor de webinterface op 7444 operator_addr = 0.0.0.0:7444 in bij de RCM-instellingen.
  • De nodepoort in de clusterbeschrijving moet overeenkomen met de gepubliceerde poort.

De agent installeert de node een paar minuten nadat je het cluster hebt opgeslagen. Tot dan reageert de nodepoort niet.

Meer over het cluster en replicatie →

Cloudserver · NAT · firewall

HQbird op een cloudserver

Op een cloudserver installeer je HQbird met het normale installatieprogramma: één bestand, één opdracht. Firebird, de agent en de console zitten in het bestand: het installatieprogramma downloadt niets. Op Linux haalt het een paar OS-bibliotheken (libtommath, ICU) uit de distributierepository. Als er geen repository is, drukt het de exacte opdrachten af en wijzigt het niets.

  • Geen inkomende poorten voor het centrumDe agent maakt zelf verbinding met HQCenter. Een server achter NAT of in een privé-cloudnetwerk ziet er in het centrum hetzelfde uit als een server in je rack.
  • OS-firewallHet installatieprogramma opent de poort van de nieuwe Firebird en de HQ Monitor-poort in firewalld of ufw. De firewallregels van de cloud zelf stel je in.
  • ServervereistenMinimaal 2 GB geheugen, 2 cores en 5 GB schijf. Linux x86-64 of Windows.
  • Linux-distributiesUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS en andere met apt, dnf, yum of zypper.
  • Honderd servers via een scriptElke installatiestap is beschikbaar als schakelaar. Je kunt eerst het installatieplan bekijken: de opdracht wijzigt niets.
  • Geheimen zijn beschermdEen geheim dat je in de console invoert, gaat versleuteld naar de agent. Geheimen worden verborgen in rapporten en in configuratiekopieën. In het configuratiebestand van de agent is de S3-sleutel niet versleuteld: beperk de toegang tot dit bestand. Op een Amazon EC2-server kun je zonder sleutel werken: de agent gebruikt de IAM-rol van de server.
  • Metrieken in je GrafanaDe agent exporteert Firebird- en servermetrieken in Prometheus-formaat.
  • Cloudschijf onder controleDe agent meet lees- en schrijflatentie en voorspelt wanneer de schijf vol raakt. Een trage of bijna volle cloudschijf is zichtbaar in het gezondheidsrapport.

Meer over installatie en updates →

Beperkingen · tips

Goed om te weten

  • Docker en ufwEen gepubliceerde containerpoort is open buiten ufw om. Sluit deze met een externe firewall of publiceer hem op één adres.
  • Instellingen alleen bij de eerste startVariabelen en geheimen worden één keer gelezen. Je kunt de Firebird-poort, de hostnaam en de geheimen later niet wijzigen: je hebt een nieuwe installatie nodig. Taken en andere agentinstellingen wijzig je in HQ Monitor of vanuit het centrum.
  • Scripts met docker compose execVoeg in scripts de schakelaar -T en </dev/null toe. Zonder deze leest de opdracht standaardinvoer en neemt de rest van het script over.
  • Waarschuwingen vóór de verbinding met het centrumTotdat de agent verbinding maakt met HQCenter, staat in het logboek dat de verbindingsinstellingen onvolledig zijn. Dit is normaal.
  • ImagesignatuurDe images zijn ondertekend met het hulpprogramma cosign. De publieke sleutel om ze te controleren met de opdracht cosign verify is nog niet gepubliceerd.
  • Waar het is getestUbuntu 22.04, Docker met Compose, een server met 2 cores en 4 GB geheugen. Een stapsgewijze installatiehandleiding voor Ubuntu is beschikbaar in het Russisch en Portugees.

← Terug naar het HQbird 2027-overzicht