HQbird 2027 in Docker: beheerdershandleiding
Deze handleiding is voor de beheerder die HQbird 2027 in Docker draait. Eén container is één Firebird-instantie met alle HQbird-componenten:
- Firebird (de HQbird-uitvoering van één lijn: 5.0, 4.0, 3.0 of 2.5);
- HQbird-agent (
fbagent): back-ups, monitoring, onderhoudstaken, bijwerken, de verbinding met HQCenter; - HQ Monitor: de webconsole van de instantie;
- clusternode (
hqclusternode) en RCM (hqbirdrcm): geïnstalleerd door de agent wanneer HQCenter deze instantie aan een cluster toevoegt, of wanneer u de container een clusterrol geeft (sectie 7). Zonder rol en zonder HQCenter draait de container geen clustercomponent.
De container installeert HQbird met dezelfde offline-installer als een server (Linux-installatiehandleiding). De agent werkt daarna Firebird, HQ Monitor, de clustercomponenten en zichzelf bij vanuit HQCenter, zoals op een server. Uw gegevens, configuratie, licentie, HQCenter-certificaten en de bijgewerkte programma’s staan op volumes: ze blijven wanneer u de container opnieuw maakt of de Docker-image wijzigt.
Huidige uitgave: 2027.2.33 (2026-11-16): Firebird 2.5.9, 3.0.15, 4.0.8 en 5.0.5, agent 3.4.0, HQ Monitor 1.57.0, RCM en knooppunt 2027.5.12.
Getest op 2026-11-16 op Ubuntu 22.04.5 (2 vCPU / 4 GB), Docker 29.10.0,
Compose 5.7.1, Docker-image hqbird2027-fb40:2027.2.33 (eerste test: 2026-11-11,
Docker-image 2027.2.27). Een stapsgewijze installatie
voor Ubuntu 22.04: hqbird2027-docker-install-fb40.ru.md
(Russisch), hqbird2027-docker-install-fb40.pt.md
(Portugees).
De clusterrol (sectie 7.1) en de omschakeling (sectie 7.3) zijn getest
op 2026-11-16 op de Docker-images 5.0, 4.0, 3.0 en 2.5, waarbij de twee „hosts” twee
adressen van één VM waren, en op twee aparte Docker-hosts (twee droplets, de
Docker-image 4.0 2027.2.33). Op 2026-11-17 is de rest getest op twee Docker-hosts
met de Docker-image 5.0 2027.2.33: een cluster dat met de hand is gemaakt in containers
2027.2.32 en verplaatst naar de nieuwe Docker-image (beide containers healthy in 35
seconden), HQBIRD_RCM_ALLOW, de pagina’s Services van de RCM-console en
de automatische overname. Routers (HAProxy) starten niet in de Docker-images tot en met
2027.2.33 (sectie 9); de volgende Docker-image heeft de correctie.
1. Docker-images
| Docker-image | Firebird | Standaardpoort |
|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50:<version> |
5.0 | 3050 |
ghcr.io/ibsurgeon/hqbird2027-fb40:<version> |
4.0 | 3050 |
ghcr.io/ibsurgeon/hqbird2027-fb30:<version> |
3.0 | 3050 |
ghcr.io/ibsurgeon/hqbird2027-fb25:<version> |
2.5 | 3050 |
De Docker-images staan in de GitHub Container Registry van IBSurgeon
(https://github.com/orgs/IBSurgeon/packages). Ze zijn openbaar: u hoeft
niet aan te melden. <version> is de versie van de HQbird-installatie, bijvoorbeeld
2027.2.33. De tag 2027.2 is de nieuwste Docker-image 2027.2.x.
docker pull ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.33De Docker-images zijn ondertekend met cosign. De openbare sleutel hqbird-cosign.pub is
nog niet gepubliceerd (2026-11-16). De Docker-images 2027.2.33 zijn ondertekend. Hebt u de sleutel, controleer dan een Docker-image
voordat u hem gebruikt:
cosign verify --key hqbird-cosign.pub ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.332. Eerste start
-
Kopieer
compose.yaml(uitops/docker/van de uitgave) naar een map op de Docker-host. -
Zet het SYSDBA-wachtwoord in een bestand dat alleen u kunt lezen:
mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password -
Zet in
compose.yamlimage:,hostname:en haal de#weg bij de regelssecrets:die u gebruikt. -
Start de container:
docker compose up -d -
Volg de installatie (enkele minuten bij de eerste start):
docker compose logs -fOp 2 vCPU duurt de installatie ongeveer 20 seconden. Hij is klaar wanneer het logboek
[hqbird-boot] ready: firebird.service=active ...toont endocker compose pshealthytoont.
Daarna:
- Firebird:
<docker host>:3050. - HQ Monitor:
http://<docker host>:23050/, aanmeldingadmin. De installer maakt het wachtwoord; lees het metdocker compose exec hqbird cat /opt/hqbird/conf/access.properties. - De agent-id in HQCenter: de hostnaam + de installatiedatum (YYMMDD) +
-fbNN, bijvoorbeeldhqbird-fb40-3051261111-fb40.
Behoud de hostnaam. De licentie-identiteit van de instantie is de
machine-id op het volume state en de agent-id. Een nieuw volume state is
een nieuwe installatie.
3. Instellingen
De instellingen worden alleen bij de eerste start gelezen (de installatie).
| Instelling | Wat die doet |
|---|---|
HQBIRD_FB_PORT |
Firebird-poort in de container (standaard 3050). HQ Monitor gebruikt 20000 + deze poort |
HQBIRD_HQM_PORT |
een andere poort voor HQ Monitor |
HQBIRD_AGENT_ID |
de agent-id (standaard: gemaakt uit de hostnaam, de datum en de poort) |
HQBIRD_HQM_LOGIN + geheim hqmonitor_password |
de aanmelding van HQ Monitor |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE |
vraag een proeflicentie aan (u aanvaardt het privacybeleid) |
HQBIRD_DEBUG=1 |
installeer de foutopsporingsbestanden van Firebird |
geheim sysdba_password |
het SYSDBA-wachtwoord van een nieuwe Firebird |
geheim license |
een licentiebestand |
geheim attach |
attach.json uit HQCenter: verbind de agent met uw HQCenter |
HQBIRD_CLUSTER_ROLE |
master of replica: een cluster zonder HQCenter (sectie 7). Leeg: geen cluster |
HQBIRD_CLUSTER_ADDRESS |
master, verplicht: het adres of de DNS-naam van de Docker-host, zoals de replica en uw browser die bereiken. Een lijst met komma’s; de eerste komt in de RCM URL |
HQBIRD_CLUSTER_ID |
master: de cluster-id (standaard: de hostnaam) |
geheim rcm_password |
master: het wachtwoord van de RCM-aanmelding rcmadmin (standaard: een gegenereerd wachtwoord) |
HQBIRD_RCM_ALLOW |
replica: alleen deze RCM’s mogen de container uitnodigen (IP, CIDR, hostnaam; standaard: elke). Schrijf het adres van de Docker-host van de master: de replica ziet dat adres. Op één Docker-host ziet de replica de netwerkgateway van zijn Docker-netwerk |
HQBIRD_PAIRING_PORT, HQBIRD_NODE_PORT |
het clusterslot: koppelpoort 7450-7459 en knooppuntpoort = koppelpoort - 399 (standaard 7450 en 7051) |
4. Volumes
| Volume | Pad | Inhoud |
|---|---|---|
opt |
/opt |
Firebird, de agent, HQ Monitor, clusternode, RCM |
state |
/var/lib/hqbird-container |
units, sudoers, gegevens van HQ Monitor, logboeken van de agent, machine-id, installatiestatus, de OS-accounts die tijdens het draaien worden gemaakt (de gebruiker van de RCM-dienst) |
trust |
/usr/libexec/hqbird-fbagent |
het startprogramma voor bijwerken van de agent en het vertrouwensanker |
rootwork |
/var/lib/hqbird-fbagent |
de werkmap van het startprogramma voor bijwerken |
db |
/db |
databases (zet uw databases hier) |
backup |
/backup |
back-ups |
Koppel geen hostmappen aan opt, state, trust en rootwork. U kunt
hostmappen gebruiken voor db en backup; geef ze aan uid 84 (de gebruiker firebird
van de Docker-image):
chown 84:84 /srv/hqbird/db /srv/hqbird/backupMaak een back-up van alle zes volumes samen.
5. Dagelijks werk
| Taak | Opdracht |
|---|---|
| Status van de diensten | docker compose exec hqbird systemctl list-units --type=service |
| Firebird herstarten | docker compose exec hqbird systemctl restart firebird (Firebird 3.0: firebird-superserver) |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/<port>:/db/my.fdb |
| Logboeken | docker compose logs --since 1h |
| Stoppen (Firebird sluit de databases) | docker compose stop |
In de container bestuurt systemctl de HQbird-diensten. Het is geen
systemd: het ondersteunt de opdrachten die de HQbird-programma’s gebruiken (start, stop,
restart, status, is-active, enable, disable, show,
list-units, daemon-reload).
6. Bijwerken
Er zijn twee manieren om bij te werken. Beide behouden uw gegevens.
-
Vanuit HQCenter (zoals op een server): HQCenter werkt de agent, HQ Monitor, Firebird, de clusternode en RCM in de container bij.
-
Nieuwe Docker-image: wijzig
image:naar de nieuwe versie en daarna:docker compose pull && docker compose up -dBij de start draait de container de installer van de nieuwe Docker-image in bijwerkmodus. Als HQCenter de agent al heeft bijgewerkt naar een nieuwere versie dan de Docker-image heeft, wordt de installer niet uitgevoerd (geen terugval naar een oudere versie); het logboek zegt dat.
Een nieuwe container (een nieuwe Docker-image, of docker compose down en up -d zonder
-v) behoudt het cluster: de rol, de cluster-id, RCM, de knooppunten en de
koppeling met de andere host staan op de volumes. De clusterinstellingen in het
Compose-bestand worden niet opnieuw gelezen. Docker-images tot en met 2027.2.32 hebben hier twee defecten:
zie sectie 9.
7. Cluster
Er zijn twee manieren om een cluster te maken. Meng ze niet in één container.
7.1. Zonder HQCenter: twee containers met een rol
Eén container is de master en draait de clustermanager (RCM) met zijn
console. De andere is een replica. De rol is een instelling van de eerste
start: HQBIRD_CLUSTER_ROLE. Zonder die rol draait de container geen RCM, geen
clusternode en opent hij geen koppelpoort. De rol heeft Docker-image 2027.2.33 of
nieuwer nodig.
Twee Docker-hosts. Geef de twee containers verschillende hostnamen
(HQBIRD_HOSTNAME in .env, of hostname:): bij dezelfde hostnaam
hebben de twee agents dezelfde id, en RCM weigert de replica
(duplicate). Kopieer compose.master.yaml naar de host van de master en
compose.replica.yaml naar de host van de replica, naast compose.yaml
(ops/docker/ van de uitgave).
-
Zet op de host van de master het adres van die Docker-host in
.env, zoals de host van de replica en uw browser het bereiken (nietlocalhost, niet het adres van de container):echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env docker compose -f compose.yaml -f compose.master.yaml up -d -
Op de host van de replica:
docker compose -f compose.yaml -f compose.replica.yaml up -d -
Lees de clusterregels van elke container:
docker compose logs | grep -E 'cluster:|CA hash|Password'De master toont het consoleadres en de
CA hash:[hqbird-boot] cluster: role=master id=... console=https://203.0.113.10:7444 login=rcmadmin. De replica toont zijn koppelpoort en vingerafdruk:[hqbird-boot] cluster: role=replica pairing port 7450: open until ..., fingerprint sha256:.... -
Open de console
https://<master host>:7444. De aanmelding isrcmadmin. Zonder het geheimrcm_passwordstaat het wachtwoord in een bestand; RCM vraagt bij de eerste aanmelding om een nieuw wachtwoord:docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password' -
Schrijf in Settings → Link hosts twee regels: het adres dat u in
HQBIRD_CLUSTER_ADDRESShebt gezet (de master) en het adres van de Docker-host van de replica. U schrijft geen poort: RCM leest de koppelpoorten 7450-7459. De koppelpoort antwoordt ongeveer 30 seconden nadat de containerhealthyis. Het venster Initialize stelt de map/databases/replica/...voor, die buiten de volumes ligt: wijzig die. Dat venster is ongeveer 1000 px hoog en scrolt niet: zoom de pagina uit als u de knoppen niet ziet. Getest in de browser op 2026-11-16. Vergelijk de vingerafdruk van de replica met die in zijn logboek. Laat RCM URL leeg. Ga daarna verder met stap 4 van Linux-clusterhandleiding (databasemap, inschrijven, de replica initialiseren). Gebruik voor de database- map van de replica een map op het volumedb, bijvoorbeeld/db/replica. Getest: een rij die op de master werd geschreven, stond binnen 30 seconden op de replica.
Om de opties -f over te slaan, zet
COMPOSE_FILE=compose.yaml:compose.master.yaml (of ...replica.yaml) in
.env.
Eén Docker-host. compose.cluster-one-host.yaml is een volledig bestand
met beide containers:
docker compose -f compose.cluster-one-host.yaml up -dDe containers bereiken elkaar op naam op het netwerk van het project, dus
de clusterpoorten worden niet gepubliceerd. Schrijf in Link hosts
hqbird-master en hqbird-replica. Firebird van de master staat op poort
3050, die van de replica op 3051; de console is https://<docker host>:7444.
Regels:
- De rol en zijn instellingen worden alleen bij de eerste start gelezen. Later geeft
een andere
HQBIRD_CLUSTER_ROLEeen waarschuwing in het logboek en verandert niets. Om het cluster later te wijzigen, gebruikt u HQ Monitor (Clusters) of de opdrachtenfbagent --cluster-initenfbagent --cluster-pairingin de container. - Een verkeerde instelling (een onbekende rol, een master zonder
HQBIRD_CLUSTER_ADDRESS, een instelling van de andere rol) stopt de start voordat er iets is geïnstalleerd. Het logboek zegt wat u moet schrijven ([hqbird-boot] error: ...); Docker start de container opnieuw en het logboek herhaalt de regel tot u de instelling corrigeert. - Het koppelvenster van een replica staat 24 uur open. Een herstart van een
container die nog in geen cluster zit, opent het opnieuw. Om de
koppelpoort naar andere netwerken te sluiten, gebruikt u
HQBIRD_RCM_ALLOWof uw firewall; na de koppeling kunt u de poort uitports:halen. - Voor een omschakeling (een RCM-dienst) heeft elke host een tweede knooppunt en zijn gepubliceerde poort nodig: zie sectie 7.3.
7.2. Met HQCenter
HQCenter voegt de instantie aan een cluster toe zoals het een server toevoegt. Stel
HQBIRD_CLUSTER_ROLE niet in. Geef in HQCenter het adres van de Docker-host
als het adres van het lid. Publiceer in compose.yaml de poorten van de clustercomponenten:
| Component | Poort | Publiceren wanneer |
|---|---|---|
| clusternode | de listen_port van het knooppunt (bijvoorbeeld 7051) |
de instantie is een clusterlid |
| RCM | 7443 | HQCenter maakt deze agent de RCM |
| operatorconsole van RCM | 7444 | zoals hierboven; zet operator_addr op 0.0.0.0:7444 in de instellingen van RCM |
De agent installeert het knooppunt (en RCM) enkele minuten nadat het cluster is
opgeslagen. Tot dan antwoordt de knooppuntpoort niet.
Zet in HQCenter de listen_port van het knooppunt op de gepubliceerde poort. Een replica wacht tot de RCM-agent de cluster-CA uploadt.
Getest op 2026-11-16 zonder rol: de agents installeerden de knooppunten en RCM,
en alle leden waren weer running na docker compose down en
up -d.
7.3. Omschakeling tussen de twee containers
Een RCM-dienst verplaatst de rol master van een database van de ene host naar de andere. Voor een dienst heeft elke host twee knooppunten nodig: een knooppunt master en een knooppunt replica. Link hosts geeft elke host één knooppunt, dus u voegt de tweede knooppunten zelf toe. Getest op 2026-11-16 op het paar van sectie 7.1: de omschakeling duurde 25 seconden, de oude master werd een alleen-lezen replica, en een rij die op de nieuwe master werd geschreven, stond 15 seconden later op die replica.
De stappen gebruiken de operator-API van RCM op de consolepoort. curl vraagt om
het wachtwoord van rcmadmin; -k slaat de controle van het eigen certificaat
van het cluster over:
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }-
Publiceer de poort van het tweede knooppunt op beide hosts: knooppuntpoort + 10. Haal in
compose.master.yamlencompose.replica.yamlde#weg bij de regel"7061:7061", en voer daarnadocker compose up -duit met dezelfde opties-f. Doe dit vóór de eerste start wanneer dat kan. -
Geef elk knooppunt het adres van zijn Docker-host. RCM geeft dit adres en de Firebird-poort aan de toepassingen; zonder dat adres krijgen ze het adres van de container:
api -X PUT $RCM/v1/nodes/<master node id>/config -d '{"advertise_addr":"203.0.113.10"}' api -X PUT $RCM/v1/nodes/<replica node id>/config -d '{"advertise_addr":"203.0.113.20"}'api $RCM/v1/nodestoont de id’s van de knooppunten (<host name>-master,<host name>-replica). -
Voeg extra knooppunten toe aan het clusterdocument: een knooppunt master op de host van de replica en zijn knooppunt replica op de host van de master, beide met
listen_port7061. Lees het document, voeg twee leden en één koppeling toe, en stuur het terug met zijn revisie:api $RCM/v1/admin/clusters/<cluster id> > cluster.json # note "revision" # add to "members": # {"member_id":"<host B>-master","agent_id":"<agent id of host B>","role":"master","addresses":["203.0.113.20"],"listen_port":7061} # {"member_id":"<host A>-replica","agent_id":"<agent id of host A>","role":"replica","addresses":["203.0.113.10"],"listen_port":7061} # add to "links": {"from":"<host B>-master","to":"<host A>-replica"} api -X POST $RCM/v1/admin/clusters/<cluster id>/validate --data-binary @cluster.json api -X PUT -H 'If-Match: <revision>' $RCM/v1/admin/clusters/<cluster id> --data-binary @cluster.jsonDe agents installeren daarna de twee knooppuntdiensten (30 seconden in de test op twee hosts; het kan enkele minuten duren).
docker compose exec hqbird systemctl list-units --type=servicetoont daarna twee dienstenhqclusternodein elke container.Geef daarna beide knooppunten replica een databasemap op het volume
db. Zonder die map stopt een omschakeling terug of een overname bij uitval na het punt van geen terugkeer, en de dienst gaat naarfailed:for n in <host A>-replica <host B>-replica; do api -X POST $RCM/v1/nodes/$n/databases/root/prepare -d '{"root":"/db/replica"}' api -X PUT $RCM/v1/nodes/$n/config -d '{"databases":{"root":"/db/replica"}}' done -
Definieer de dienst.
hostis de agent-id van de host. Het pad op de tweede host is het pad van het replicabestand:<database folder of the replica>/<master member id>/<file>:cat > service.json <<'J' {"alias":"shop","router_port":3051,"members":[ {"host":"<agent id of host A>","master_node":"<host A>-master","replica_node":"<host A>-replica","path":"/db/shop.fdb","priority":100}, {"host":"<agent id of host B>","master_node":"<host B>-master","replica_node":"<host B>-replica","path":"/db/replica/<host A>-master/shop.fdb","priority":50}]} J api -X PUT "$RCM/v1/services/shop?check=1" --data-binary @service.json # a check, nothing is stored api -X PUT $RCM/v1/services/shop --data-binary @service.json -
Controleer, en schakel daarna om:
api $RCM/v1/services/shop/master # the master now, the replicas, problems api -X POST $RCM/v1/services/shop/switchover/check -d '{}' api -X POST $RCM/v1/services/shop/switchover -d '{}' # gives "operation_id" api $RCM/v1/operations/<operation id>
Na de omschakeling geeft .../services/shop/master het adres van de
andere Docker-host en zijn Firebird-poort. De toepassingen moeten verbinding maken met
dat adres. Een omschakeling heeft een replica nodig die IN_SYNC is: dat is zo na
de eerste schrijfactie op de master (35 seconden in de test).
Routers en automatische overname. Een router (HAProxy) geeft de toepassingen één adres dat de master volgt. In de Docker-images tot en met 2027.2.33 start de router niet (sectie 9); de volgende Docker-image heeft de correctie. De automatische overname heeft een router als getuige nodig. Getest op 2026-11-17 in het lab, op 2027.2.33 met een tijdelijke oplossing en op een test-Docker-image met de correctie:
-
Een router is een clusterlid met de rol
router. De agent installeert het pakkethaproxyuit de Debian-repository, ook in elke nieuwe container: de container heeft toegang tot de repository nodig. Publiceer de poort van de router (3051 in het voorbeeld). -
Met een router alleen op de RCM-host verplaatste RCM de master vanzelf 84 seconden nadat de container van de andere host stopte; de bewerking duurde 10 seconden. Toen die host terugkwam, maakte
rejoinhem weer de replica. -
Met een router op elke host start de automatische overname niet: meer dan de helft moet rapporteren, en een van de twee staat op de verloren host.
-
RCM draait in de container van de master. Wanneer die host verloren gaat, gaat RCM ook verloren, en niets verplaatst de master vanzelf.
8. Poorten, firewall, tweede instantie
Publiceer elke poort met hetzelfde nummer buiten en binnen de container
(3051:3051, niet 3051:3050). De agent en het cluster melden de poort
die ze in de container zien.
| Poort | Wat | Nodig |
|---|---|---|
HQBIRD_FB_PORT (3050) |
Firebird | altijd |
| 20000 + Firebird-poort (23050) | HQ Monitor | altijd |
listen_port van het knooppunt (7051) |
clusternode | clusterlid |
| knooppuntpoort + 10 (7061) | het tweede knooppunt van de host | een dienst met een omschakeling (sectie 7.3) |
| 7443, 7444 | RCM, operatorconsole van RCM | deze agent is de RCM (één per host) |
| koppelpoort (7450) | de koppelpoort van de agent | een replica met een rol, tot hij gekoppeld is |
De agent maakt zelf verbinding met HQCenter (uitgaand); hij heeft geen inkomende poort nodig.
Docker publiceert poorten voorbij ufw. Getest: met ufw die alleen poort 22 toestaat,
waren de poorten van Firebird en HQ Monitor open vanaf het internet. Gebruik een
externe firewall, publiceer op één hostadres ("10.0.0.5:23050:23050"),
of voeg regels toe aan de iptables-keten DOCKER-USER.
Een tweede instantie op één host heeft een eigen map, project-name:,
hostname, HQBIRD_FB_PORT en poorten nodig. De projectnaam maakt de volumenamen
(<name>_opt, …): bij dezelfde naam pakt de tweede start de
volumes en de container van de eerste.
| Instantie 1 | Instantie 2 | |
|---|---|---|
name:, hostname: |
hqbird-fb40-3051 |
hqbird-fb40-3052 |
HQBIRD_FB_PORT |
3051 | 3052 |
ports: |
3051, 23051, 7052 | 3052, 23052, 7053 |
Regels voor N instanties op één extern IP-adres:
- Firebird
3050 + N, HQ Monitor20000 +de Firebird-poort, clusterknooppunt7051 + N(zet dezelfdelisten_portin HQCenter). Sla 3050, 23050 en 7051 over wanneer de host al een Firebird of HQbird buiten Docker draait. - Slechts één instantie per host kan de RCM zijn (7443, 7444).
- Met een clusterrol (sectie 7.1) heeft elke instantie van een host zijn eigen
slot:
HQBIRD_PAIRING_PORT=7451enHQBIRD_NODE_PORT=7052voor de tweede,7452en7053voor de derde. - Eén instantie gebruikt ongeveer 200-250 MB geheugen zonder belasting. Getest: drie instanties FB 4.0 op 2 vCPU / 4 GB, één met belasting.
- Andere Firebird-lijnen op dezelfde host volgen dezelfde regels met hun
eigen Docker-image (
hqbird2027-fb50, …) en namen (hqbird-fb50-3054).
Voeg een instantie toe (hier de derde: 3053, 23053, 7054) vanuit de compose.yaml
van de eerste. Vervangen van 3051 wijzigt ook name:, hostname:,
HQBIRD_FB_PORT en de poort van HQ Monitor:
sudo ss -ltnp | grep -E ':(3053|23053|7054)\b' # must print nothing
sudo mkdir -p /srv/hqbird-fb40-3053/secrets
cd /srv/hqbird-fb40-3053
sudo sh -c 'openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password'
sudo sed -e 's/3051/3053/g' -e 's/7052/7054/g' /srv/hqbird-fb40-3051/compose.yaml | sudo tee compose.yaml >/dev/null
sudo docker compose config | grep -E '^name:|hostname:|HQBIRD_FB_PORT|published:'
sudo docker compose up -d
sudo docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'9. Bekende problemen
- Nadat u de agent met de hand met
fbagent --enrollaan HQCenter koppelt, voert ufbagent --refresh-apply-launcheruit als root, anders mislukt de zelfupdate van de agent met “no goafts CA is pinned”. - Voer in scripts
docker compose execuit met-Ten</dev/null. Zonder die leest het de standaardinvoer en neemt het de rest van een script dat u stuurt metssh ... bash -s. - Voordat de agent met HQCenter is verbonden, toont zijn logboek de waarschuwingen
goafts mTLS settings are incompleteenbootstrap CA not found. Dat is normaal. - De container geeft
/opt/hqbirdna elke installatie aan root (de zelfupdate van de agent heeft dat nodig). De agent schrijft een waarschuwing dat hij/opt/hqbird/version.jsonniet kan bijwerken; u kunt die negeren. - Docker-images tot en met 2027.2.32: mappen open voor schrijven. In deze Docker-images
hebben
/etc,/usren/usr/libde modus 0777, en sommige bestanden van de container zijn schrijfbaar voor alle accounts. Elk account in de container kan wijzigen wat root start. De agent weigert ook zo’n map (root trust directory: /usr is writable by group or others): de installer in bijwerkmodus mislukt dan in een nieuwe container, en de container start steeds opnieuw. Gebruik Docker-image 2027.2.33 of nieuwer. Geef geen opdrachtregeltoegang in de container van een oudere Docker-image aan gebruikers die u niet vertrouwt. - Docker-images tot en met 2027.2.32: RCM die met de hand is gemaakt, start niet in een nieuwe
container. Wanneer u RCM maakt met
fbagent --cluster-initin de container, maakt de agent het OS-accounthqbirdrcm. Een nieuwe container heeft dat account niet (User=hqbirdrcm: invalid userid, de container isunhealthy). Nieuwere Docker-images bewaren de accounts op het volumestate. Een cluster dat door HQCenter is gemaakt, heeft hier geen last van. - Docker-images tot en met 2027.2.33: een router (HAProxy) start niet. Voor een
clusterlid met de rol
routerinstalleert de agent het pakkethaproxyen de dienst van de router, maarhaproxy.servicemislukt. De vervanger van systemd in de Docker-image zet de waarden van$CONFIG,$PIDFILEen$EXTRAOPTSniet op de opdrachtregel en leest geen aanvullend unitbestand, en niets maakt de map/run/haproxyaan. De volgende Docker-image heeft de correctie. Geef tot die tijd de toepassingen het adres uit.../services/<alias>/masteren voeg geen lidroutertoe. - Docker-image 2027.2.33: een nieuwe container start niet nadat een router is
toegevoegd. Het logboek bevat
chown: invalid user: 'haproxy', en Docker start de container steeds opnieuw. Om hem te starten, verwijdert u het bestandusr/lib/tmpfiles.d/haproxy.confop het volumestate. De volgende Docker-image heeft de correctie.
10. De Docker-images bouwen
Voor het team van de uitgave. Op een Windows-host met de bestanden van de uitgave in
dist\releases meldt u zich aan bij GHCR met een token dat write:packages heeft,
en daarna bouwt u, stuurt u naar het register en ondertekent u:
Get-Content token.txt | docker login ghcr.io -u <GitHub user> --password-stdin
.\ops\docker\Build-HqbirdImage.ps1 -Line 50 -SetupVersion 2027.2.33 -Registry ghcr.io/ibsurgeon -Tag 2027.2 -Push -CosignKey cosign.keyEen nieuw pakket (de eerste keer dat een lijn wordt verstuurd) is privé. Zet in de pakketinstellingen van de organisatie IBSurgeon de zichtbaarheid op openbaar.
-ContextOnly zet alleen de bouwmap klaar
(dist\hqbird2027-docker\fbNN-<version>) en toont de opdracht docker build
die u op een Docker-host met Linux uitvoert.
De bouw stopt wanneer een map of een bestand van de Docker-image onder /etc of /usr
schrijfbaar is voor alle accounts (de bouwmap komt van Windows, waar de
modi verloren gaan). De tests van de containerscripts, de clusterinstellingen
en de Compose-bestanden: go test ./ops/docker/.