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.

Command
docker pull ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.33

De 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:

Command
cosign verify --key hqbird-cosign.pub ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.33

2. Eerste start

  1. Kopieer compose.yaml (uit ops/docker/ van de uitgave) naar een map op de Docker-host.

  2. Zet het SYSDBA-wachtwoord in een bestand dat alleen u kunt lezen:

    Command
    mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password
  3. Zet in compose.yaml image:, hostname: en haal de # weg bij de regels secrets: die u gebruikt.

  4. Start de container:

    Command
    docker compose up -d
  5. Volg de installatie (enkele minuten bij de eerste start):

    Command
    docker compose logs -f

    Op 2 vCPU duurt de installatie ongeveer 20 seconden. Hij is klaar wanneer het logboek [hqbird-boot] ready: firebird.service=active ... toont en docker compose ps healthy toont.

Daarna:

  • Firebird: <docker host>:3050.
  • HQ Monitor: http://<docker host>:23050/, aanmelding admin. De installer maakt het wachtwoord; lees het met docker compose exec hqbird cat /opt/hqbird/conf/access.properties.
  • De agent-id in HQCenter: de hostnaam + de installatiedatum (YYMMDD) + -fbNN, bijvoorbeeld hqbird-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):

Command
chown 84:84 /srv/hqbird/db /srv/hqbird/backup

Maak 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:

    Command
    docker compose pull && docker compose up -d

    Bij 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).

  1. 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 (niet localhost, niet het adres van de container):

    Command
    echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env
    docker compose -f compose.yaml -f compose.master.yaml up -d
  2. Op de host van de replica:

    Command
    docker compose -f compose.yaml -f compose.replica.yaml up -d
  3. Lees de clusterregels van elke container:

    Command
    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:....

  4. Open de console https://<master host>:7444. De aanmelding is rcmadmin. Zonder het geheim rcm_password staat het wachtwoord in een bestand; RCM vraagt bij de eerste aanmelding om een nieuw wachtwoord:

    Command
    docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password'
  5. Schrijf in Settings → Link hosts twee regels: het adres dat u in HQBIRD_CLUSTER_ADDRESS hebt 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 container healthy is. 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 volume db, 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:

Command
docker compose -f compose.cluster-one-host.yaml up -d

De 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_ROLE een waarschuwing in het logboek en verandert niets. Om het cluster later te wijzigen, gebruikt u HQ Monitor (Clusters) of de opdrachten fbagent --cluster-init en fbagent --cluster-pairing in 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_ALLOW of uw firewall; na de koppeling kunt u de poort uit ports: 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:

Command
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }
  1. Publiceer de poort van het tweede knooppunt op beide hosts: knooppuntpoort + 10. Haal in compose.master.yaml en compose.replica.yaml de # weg bij de regel "7061:7061", en voer daarna docker compose up -d uit met dezelfde opties -f. Doe dit vóór de eerste start wanneer dat kan.

  2. 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:

    Command
    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/nodes toont de id’s van de knooppunten (<host name>-master, <host name>-replica).

  3. 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_port 7061. Lees het document, voeg twee leden en één koppeling toe, en stuur het terug met zijn revisie:

    Command
    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.json

    De 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=service toont daarna twee diensten hqclusternode in 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 naar failed:

    Command
    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
  4. Definieer de dienst. host is 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>:

    Command
    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
  5. Controleer, en schakel daarna om:

    Command
    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 pakket haproxy uit 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 rejoin hem 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 Monitor 20000 + de Firebird-poort, clusterknooppunt 7051 + N (zet dezelfde listen_port in 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=7451 en HQBIRD_NODE_PORT=7052 voor de tweede, 7452 en 7053 voor 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:

Command
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 --enroll aan HQCenter koppelt, voert u fbagent --refresh-apply-launcher uit als root, anders mislukt de zelfupdate van de agent met “no goafts CA is pinned”.
  • Voer in scripts docker compose exec uit met -T en </dev/null. Zonder die leest het de standaardinvoer en neemt het de rest van een script dat u stuurt met ssh ... bash -s.
  • Voordat de agent met HQCenter is verbonden, toont zijn logboek de waarschuwingen goafts mTLS settings are incomplete en bootstrap CA not found. Dat is normaal.
  • De container geeft /opt/hqbird na elke installatie aan root (de zelfupdate van de agent heeft dat nodig). De agent schrijft een waarschuwing dat hij /opt/hqbird/version.json niet kan bijwerken; u kunt die negeren.
  • Docker-images tot en met 2027.2.32: mappen open voor schrijven. In deze Docker-images hebben /etc, /usr en /usr/lib de 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-init in de container, maakt de agent het OS-account hqbirdrcm. Een nieuwe container heeft dat account niet (User=hqbirdrcm: invalid userid, de container is unhealthy). Nieuwere Docker-images bewaren de accounts op het volume state. 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 router installeert de agent het pakket haproxy en de dienst van de router, maar haproxy.service mislukt. De vervanger van systemd in de Docker-image zet de waarden van $CONFIG, $PIDFILE en $EXTRAOPTS niet op de opdrachtregel en leest geen aanvullend unitbestand, en niets maakt de map /run/haproxy aan. De volgende Docker-image heeft de correctie. Geef tot die tijd de toepassingen het adres uit .../services/<alias>/master en voeg geen lid router toe.
  • 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 bestand usr/lib/tmpfiles.d/haproxy.conf op het volume state. 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:

Command
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.key

Een 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/.