Cloud en Docker
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.
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.
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.
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.
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.
| Image | Firebird | Firebird-poort | 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 |
Eerste start
- 1compose.yamlkopieer het uit de kit naar een map op de host
- 2SYSDBA-wachtwoordin een geheim bestand dat alleen jij kunt lezen
- 3Image, naam, secretsstel
imageenhostnamein, verwijder de#uit de regelssecrets: - 4docker compose up -dde container installeert HQbird
- 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/, loginadmin. - De installer maakt het consolewachtwoord aan. Het staat in het bestand
/opt/hqbird/conf/access.propertiesin de container. - De agentnaam in HQCenter: de hostnaam, de installatiedatum en de Firebird-lijn.
Dagelijks werk
| Taak | Opdracht |
|---|---|
| Servicestatus | docker compose exec hqbird systemctl list-units --type=service |
| Firebird herstarten | docker compose exec hqbird systemctl restart firebirdFirebird 3.0: de service firebird-superserver |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb |
| Log van één uur | docker compose logs --since 1h |
| Stoppen | docker 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.
| Instelling | Wat het doet |
|---|---|
HQBIRD_FB_PORT | Firebird-poort in de container, standaard 3050. HQ Monitor luistert op 20000 + deze poort. |
HQBIRD_HQM_PORT | Een andere HQ Monitor-poort. |
HQBIRD_AGENT_ID | Agentnaam. Standaard wordt deze samengesteld uit de hostnaam, de datum en de poort. |
HQBIRD_HQM_LOGIN, secret hqmonitor_password | HQ Monitor-login en -wachtwoord. |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE | Aanvraag voor een proeflicentie. |
secret sysdba_password | SYSDBA-wachtwoord van de nieuwe Firebird. |
secret license | Licentiebestand. |
secret attach | Het bestand attach.json uit HQCenter: het verbindt de agent met jouw centrum. |
| Volume | Pad | Inhoud |
|---|---|---|
db | /db | Databases. Plaats hier je databases. |
backup | /backup | Back-ups. |
opt | /opt | Firebird, de agent, HQ Monitor, clusternode, RCM. |
state | /var/lib/hqbird-container | Services, consolgegevens, agentlogboeken, machine-ID. |
trust | /usr/libexec/hqbird-fbagent | Vertrouwde start van agentupdates. |
rootwork | /var/lib/hqbird-fbagent | Werkmap voor updates. |
- Alleen hostmappen voor databases en back-upsJe kunt de volumes
dbenbackupvervangen door hostmappen. Geef ze aan de gebruiker met uid 84: dit is de gebruikerfirebirdin 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
stateen aan de agentnaam. Een nieuw volumestateis een nieuwe installatie. - Verbind met het centrum met één bestandHet geheim
attachverbindt 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.
| Poort | Wat | Wanneer nodig |
|---|---|---|
HQBIRD_FB_PORT (3050) | Firebird | altijd |
| 20000 + Firebird-poort (23050) | HQ Monitor | altijd |
| nodepoort (7051) | clusternode | de instantie sluit zich aan bij een cluster |
| 7443, 7444 | RCM en zijn webinterface | deze 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 1 | Instantie 2 | |
|---|---|---|
| Project- en hostnaam | hqbird-fb40-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| Poorten | 3051, 23051, 7052 | 3052, 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:7444in 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.
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.
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
-Ten</dev/nulltoe. 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 verifyis 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.