HQbird 2027 v Dockeru: příručka správce
Tato příručka je pro správce, který provozuje HQbird 2027 v Dockeru. Jeden kontejner je jedna instance Firebird se všemi komponentami HQbird:
- Firebird (sestavení HQbird jedné řady: 5.0, 4.0, 3.0 nebo 2.5);
- agent HQbird (
fbagent): zálohy, monitoring, úlohy údržby, aktualizace, připojení k HQCenter; - HQ Monitor: webová konzole instance;
- uzel clusteru (
hqclusternode) a RCM (hqbirdrcm): agent je nainstaluje, když HQCenter přidá tuto instanci do clusteru, nebo když kontejneru dáte roli v clusteru (sekce 7). Bez role a bez HQCenter kontejner nespouští žádnou komponentu clusteru.
Kontejner instaluje HQbird stejným offline instalátorem jako server (průvodce instalací na Linuxu). Agent potom aktualizuje Firebird, HQ Monitor, komponenty clusteru a sebe z HQCenter, stejně jako na serveru. Vaše data, konfigurace, licence, certifikáty HQCenter a aktualizované programy jsou na svazcích: zůstanou, když kontejner vytvoříte znovu nebo změníte obraz.
Aktuální vydání: 2027.2.33 (2026-11-16): Firebird 2.5.9, 3.0.15, 4.0.8 a 5.0.5, agent 3.4.0, HQ Monitor 1.57.0, RCM a uzel 2027.5.12.
Ověřeno 2026-11-16 na Ubuntu 22.04.5 (2 vCPU / 4 GB), Docker 29.10.0,
Compose 5.7.1, obraz hqbird2027-fb40:2027.2.33 (první zkouška: 2026-11-11,
obraz 2027.2.27). Instalace krok za krokem
pro Ubuntu 22.04: hqbird2027-docker-install-fb40.ru.md
(ruština), hqbird2027-docker-install-fb40.pt.md
(portugalština).
Role v clusteru (sekce 7.1) a switchover (sekce 7.3) byly ověřeny
2026-11-16 na obrazech 5.0, 4.0, 3.0 a 2.5, přičemž dva “hosts” byly dvě
adresy jednoho VM, a na dvou samostatných hostitelích Docker (dva droplets,
obraz 4.0 2027.2.33). Dne 2026-11-17 byl zbytek ověřen na dvou hostitelích
Docker s obrazem 5.0 2027.2.33: cluster sestavený ručně v kontejnerech
2027.2.32 a přenesený na nový obraz (oba kontejnery healthy za 35
sekund), HQBIRD_RCM_ALLOW, stránky Services konzole RCM a
automatický failover. Routery (HAProxy) se v obrazech do verze 2027.2.33
včetně nespouštějí (sekce 9); další obraz má opravu.
1. Obrazy
| Obraz | Firebird | Výchozí port |
|---|---|---|
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 |
Obrazy jsou v GitHub Container Registry organizace IBSurgeon
(https://github.com/orgs/IBSurgeon/packages). Jsou veřejné: nemusíte se
přihlašovat. <version> je verze instalace HQbird, například
2027.2.33. Tag 2027.2 je nejnovější obraz 2027.2.x.
docker pull ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.33Obrazy jsou podepsané pomocí cosign. Veřejný klíč hqbird-cosign.pub
ještě není zveřejněn (2026-11-16). Obrazy 2027.2.33 jsou podepsané. Až
budete mít klíč, ověřte obraz, než ho použijete:
cosign verify --key hqbird-cosign.pub ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.332. První spuštění
-
Zkopírujte
compose.yaml(zops/docker/vydání) do složky na hostiteli Docker. -
Zapište heslo SYSDBA do souboru, který smíte číst jen vy:
mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password -
V
compose.yamlnastavteimage:,hostname:a odstraňte#z řádkůsecrets:, které používáte. -
Spusťte kontejner:
docker compose up -d -
Sledujte instalaci (při prvním spuštění několik minut):
docker compose logs -fNa 2 vCPU trvá instalace asi 20 sekund. Je hotová, když protokol ukáže
[hqbird-boot] ready: firebird.service=active ...adocker compose psukážehealthy.
Potom:
- Firebird:
<docker host>:3050. - HQ Monitor:
http://<docker host>:23050/, přihlášeníadmin. Instalátor heslo vytvoří; přečtěte je pomocídocker compose exec hqbird cat /opt/hqbird/conf/access.properties. - Id agenta v HQCenter: hostname + datum instalace (YYMMDD) +
-fbNN, napříkladhqbird-fb40-3051261111-fb40.
Ponechte hostname. Licenční identita instance je machine-id na svazku
state a id agenta. Nový svazek state je nová instalace.
3. Nastavení
Nastavení se čtou jen při prvním spuštění (při instalaci).
| Nastavení | Co dělá |
|---|---|
HQBIRD_FB_PORT |
Port Firebird uvnitř kontejneru (výchozí 3050). HQ Monitor používá 20000 + tento port |
HQBIRD_HQM_PORT |
jiný port HQ Monitor |
HQBIRD_AGENT_ID |
id agenta (výchozí: sestavené z jména hostitele, data a portu) |
HQBIRD_HQM_LOGIN + secret hqmonitor_password |
přihlašovací jméno HQ Monitor |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE |
požádat o zkušební licenci (přijímáte zásady ochrany osobních údajů) |
HQBIRD_DEBUG=1 |
nainstalovat ladicí soubory Firebird |
secret sysdba_password |
heslo SYSDBA nového Firebird |
secret license |
soubor licence |
secret attach |
attach.json z HQCenter: připojí agenta k vašemu HQCenter |
HQBIRD_CLUSTER_ROLE |
master nebo replica: cluster bez HQCenter (sekce 7). Prázdné: žádný cluster |
HQBIRD_CLUSTER_ADDRESS |
master, povinné: adresa nebo DNS jméno hostitele Docker, jak je dosáhne replica a váš prohlížeč. Seznam oddělený čárkami; první položka jde do URL RCM |
HQBIRD_CLUSTER_ID |
master: id clusteru (výchozí: jméno hostitele) |
secret rcm_password |
master: heslo přihlášení RCM rcmadmin (výchozí: vygenerované) |
HQBIRD_RCM_ALLOW |
replica: jen tyto RCM smějí kontejner pozvat (IP, CIDR, jméno hostitele; výchozí: libovolné). Napište adresu hostitele Docker master: replica tuto adresu vidí. Na jednom hostiteli Docker replica vidí bránu své sítě Docker |
HQBIRD_PAIRING_PORT, HQBIRD_NODE_PORT |
slot clusteru: párovací port 7450-7459 a port uzlu = párovací port - 399 (výchozí 7450 a 7051) |
4. Svazky
| Svazek | Cesta | Obsah |
|---|---|---|
opt |
/opt |
Firebird, agent, HQ Monitor, uzel clusteru, RCM |
state |
/var/lib/hqbird-container |
jednotky, sudoers, data HQ Monitor, protokoly agenta, machine-id, stav instalace, účty operačního systému vytvořené za běhu (služební uživatel RCM) |
trust |
/usr/libexec/hqbird-fbagent |
spouštěč aktualizací agenta a důvěra |
rootwork |
/var/lib/hqbird-fbagent |
pracovní složka spouštěče aktualizací |
db |
/db |
databáze (sem ukládejte své databáze) |
backup |
/backup |
zálohy |
Nepřipojujte složky hostitele na opt, state, trust a rootwork.
Pro db a backup můžete složky hostitele použít; dejte je uid 84
(uživatel firebird obrazu):
chown 84:84 /srv/hqbird/db /srv/hqbird/backupZálohujte všech šest svazků společně.
5. Každodenní práce
| Úkol | Příkaz |
|---|---|
| Stav služeb | docker compose exec hqbird systemctl list-units --type=service |
| Restart Firebird | 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 |
| Protokoly | docker compose logs --since 1h |
| Zastavení (Firebird zavře databáze) | docker compose stop |
Uvnitř kontejneru systemctl ovládá služby HQbird. Není to
systemd: podporuje příkazy, které programy HQbird používají (start, stop,
restart, status, is-active, enable, disable, show,
list-units, daemon-reload).
6. Aktualizace
Jsou dva způsoby aktualizace. Oba zachovají vaše data.
-
Z HQCenter (jako na serveru): HQCenter aktualizuje agenta, HQ Monitor, Firebird, uzel clusteru a RCM uvnitř kontejneru.
-
Nový obraz: změňte
image:na novou verzi a potom:docker compose pull && docker compose up -dPři spuštění kontejner spustí instalátor nového obrazu v režimu aktualizace. Pokud HQCenter už aktualizovalo agenta na novější verzi, než má obraz, instalátor se nespustí (ke snížení verze nedojde); protokol to uvede.
Nový kontejner (nový obraz, nebo docker compose down a up -d bez
-v) cluster zachová: role, id clusteru, RCM, uzly a propojení na druhého
hostitele jsou na svazcích. Nastavení clusteru v souboru compose se znovu
nečte. Obrazy do verze 2027.2.32 mají tady dvě závady: viz sekce 9.
7. Cluster
Cluster lze vytvořit dvěma způsoby. V jednom kontejneru je nemíchejte.
7.1. Bez HQCenter: dva kontejnery s rolí
Jeden kontejner je master a spouští správce clusteru (RCM) s jeho
konzolí. Druhý je replica. Role je nastavení prvního
spuštění: HQBIRD_CLUSTER_ROLE. Bez ní kontejner nespouští RCM, nespouští
uzel clusteru a neotevírá párovací port. Role vyžaduje obraz 2027.2.33 nebo
novější.
Dva hostitelé Docker. Dejte oběma kontejnerům různá jména hostitele
(HQBIRD_HOSTNAME v .env, nebo hostname:): se stejným jménem hostitele
mají oba agenti stejné id a RCM odmítne replica
(duplicate). Zkopírujte compose.master.yaml na hostitele master a
compose.replica.yaml na hostitele replica, vedle compose.yaml
(ops/docker/ vydání).
-
Na hostiteli master zapište do
.envadresu tohoto hostitele Docker, jak ji dosáhne hostitel replica a váš prohlížeč (nelocalhost, ne adresa kontejneru):echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env docker compose -f compose.yaml -f compose.master.yaml up -d -
Na hostiteli replica:
docker compose -f compose.yaml -f compose.replica.yaml up -d -
Přečtěte řádky clusteru každého kontejneru:
docker compose logs | grep -E 'cluster:|CA hash|Password'Master ukáže adresu konzole a
CA hash:[hqbird-boot] cluster: role=master id=... console=https://203.0.113.10:7444 login=rcmadmin. Replica ukáže svůj párovací port a otisk:[hqbird-boot] cluster: role=replica pairing port 7450: open until ..., fingerprint sha256:.... -
Otevřete konzoli
https://<master host>:7444. Přihlašovací jméno jercmadmin. Bez secreturcm_passwordje heslo v souboru; RCM si při prvním přihlášení vyžádá nové:docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password' -
V Settings → Link hosts napište dva řádky: adresu, kterou jste uvedli v
HQBIRD_CLUSTER_ADDRESS(master), a adresu hostitele Docker replica. Port nepíšete: RCM čte párovací porty 7450-7459. Párovací port odpovídá asi 30 sekund poté, co je kontejnerhealthy. Okno Initialize navrhuje složku/databases/replica/..., která je mimo svazky: změňte ji. To okno je vysoké asi 1000 px a nedá se v něm posouvat: oddalte stránku, pokud nevidíte jeho tlačítka. Ověřeno v prohlížeči 2026-11-16. Porovnejte otisk replica s otiskem v jeho protokolu. RCM URL nechte prázdné. Potom pokračujte krokem 4 průvodce clusterem na Linuxu (složka databáze, zápis, inicializace replica). Pro složku databáze replica použijte složku na svazkudb, například/db/replica. Ověřeno: řádek zapsaný na master byl na replica za 30 sekund.
Abyste se obešli bez voleb -f, dejte do
.env hodnotu COMPOSE_FILE=compose.yaml:compose.master.yaml (nebo
...replica.yaml).
Jeden hostitel Docker. compose.cluster-one-host.yaml je úplný soubor
s oběma kontejnery:
docker compose -f compose.cluster-one-host.yaml up -dKontejnery se navzájem dosáhnou jménem v síti projektu, takže
porty clusteru se nepublikují. Do Link hosts napište
hqbird-master a hqbird-replica. Firebird master je na portu
3050, Firebird replica na 3051; konzole je https://<docker host>:7444.
Pravidla:
- Role a její nastavení se čtou jen při prvním spuštění. Později jiné
HQBIRD_CLUSTER_ROLEzapíše do protokolu varování a nic nezmění. Cluster později změníte v HQ Monitor (Clusters) nebo příkazyfbagent --cluster-initafbagent --cluster-pairinguvnitř kontejneru. - Chybné nastavení (neznámá role, master bez
HQBIRD_CLUSTER_ADDRESS, nastavení druhé role) zastaví spuštění dříve, než se cokoli nainstaluje. Protokol řekne, co zapsat ([hqbird-boot] error: ...); Docker kontejner spustí znovu a protokol řádek opakuje, dokud nastavení neopravíte. - Párovací okno replica je otevřené 24 hodin. Restart kontejneru, který
ještě v žádném clusteru není, je otevře znovu. Párovací port vůči jiným
sítím zavřete pomocí
HQBIRD_RCM_ALLOWnebo svého firewallu; po propojení můžete port vyjmout zports:. - Pro switchover (službu RCM) potřebuje každý hostitel druhý uzel a jeho publikovaný port: viz sekce 7.3.
7.2. S HQCenter
HQCenter přidá instanci do clusteru stejně, jako přidá server. Nenastavujte
HQBIRD_CLUSTER_ROLE. V HQCenter uveďte adresu hostitele Docker
jako adresu člena. V compose.yaml publikujte porty komponent
clusteru:
| Komponenta | Port | Publikovat, když |
|---|---|---|
| uzel clusteru | listen_port uzlu (například 7051) |
instance je členem clusteru |
| RCM | 7443 | HQCenter udělá z tohoto agenta RCM |
| operátorská konzole RCM | 7444 | jako výše; v nastavení RCM nastavte operator_addr na 0.0.0.0:7444 |
Agent nainstaluje uzel (a RCM) několik minut po uložení clusteru.
Do té doby port uzlu neodpovídá.
V HQCenter nastavte listen_port uzlu na publikovaný port. Replica čeká, až agent RCM nahraje CA clusteru.
Ověřeno 2026-11-16 bez role: agenti nainstalovali uzly a RCM
a všichni členové byli znovu running po docker compose down a
up -d.
7.3. Switchover mezi dvěma kontejnery
Služba RCM přesune roli master databáze z jednoho hostitele na druhý. Pro službu potřebuje každý hostitel dva uzly: uzel master a uzel replica. Link hosts dá každému hostiteli jeden uzel, druhé uzly tedy přidáte sami. Ověřeno 2026-11-16 na dvojici ze sekce 7.1: switchover trval 25 sekund, starý master se stal replica jen pro čtení a řádek zapsaný na novém master byl na této replica o 15 sekund později.
Kroky používají operátorské API RCM na portu konzole. curl se ptá na
heslo rcmadmin; -k vynechá kontrolu vlastního certifikátu
clusteru:
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }-
Publikujte port druhého uzlu na obou hostitelích: port uzlu + 10. V
compose.master.yamlacompose.replica.yamlodstraňte#z řádku"7061:7061"a potom spusťtedocker compose up -dse stejnými volbami-f. Udělejte to před prvním spuštěním, když můžete. -
Dejte každému uzlu adresu jeho hostitele Docker. RCM tuto adresu a port Firebird předá aplikacím; bez ní dostanou adresu kontejneru:
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/nodesukáže id uzlů (<host name>-master,<host name>-replica). -
Přidejte druhé uzly do dokumentu clusteru: uzel master na hostiteli replica a jeho uzel replica na hostiteli master, oba s
listen_port7061. Přečtěte dokument, přidejte dva členy a jeden link a pošlete ho zpět s jeho revizí: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.jsonAgenti potom nainstalují dvě služby uzlů (30 sekund v testu na dvou hostitelích; může to trvat několik minut).
docker compose exec hqbird systemctl list-units --type=servicepotom ukáže v každém kontejneru dvě službyhqclusternode.Potom dejte oběma uzlům replica složku databáze na svazku
db. Bez ní se switchover zpět nebo failover zastaví za bodem, odkud není návratu, a služba přejde dofailed: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 -
Definujte službu.
hostje id agenta hostitele. Cesta na druhém hostiteli je cesta souboru replica:<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 -
Zkontrolujte a potom přepněte:
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>
Po switchoveru vrátí .../services/shop/master adresu
druhého hostitele Docker a jeho port Firebird. Aplikace se musí připojit
na tuto adresu. Switchover potřebuje replica, která je
IN_SYNC: je, po prvním zápisu na master (35 sekund v testu).
Routery a automatický failover. Router (HAProxy) dává aplikacím jednu adresu, která následuje master. V obrazech do verze 2027.2.33 včetně se router nespouští (sekce 9); další obraz má opravu. Automatický failover potřebuje router jako svědka. Ověřeno 2026-11-17 v laboratoři, na 2027.2.33 s náhradním postupem a na testovacím obrazu s opravou:
-
Router je člen clusteru s rolí
router. Agent nainstaluje balíčekhaproxyz repozitáře Debian, také v každém novém kontejneru: kontejner potřebuje přístup k repozitáři. Publikujte port pro router (3051 v příkladu). -
Když je router jen na hostiteli RCM, RCM samo přesunulo master 84 sekund poté, co se kontejner druhého hostitele zastavil; operace trvala 10 sekund. Když se tento hostitel vrátil,
rejoinz něj znovu udělal replica. -
Když je router na každém hostiteli, automatický failover nezačne: hlásit se musí víc než polovina router, a jeden ze dvou je na ztraceném hostiteli.
-
RCM běží v kontejneru master. Když se tento hostitel ztratí, ztratí se i RCM a nic master samo nepřesune.
8. Porty, firewall, druhá instance
Každý port publikujte se stejným číslem vně i uvnitř kontejneru
(3051:3051, ne 3051:3050). Agent a cluster hlásí port,
který vidí uvnitř kontejneru.
| Port | Co | Kdy je potřeba |
|---|---|---|
HQBIRD_FB_PORT (3050) |
Firebird | vždy |
| 20000 + port Firebird (23050) | HQ Monitor | vždy |
listen_port uzlu (7051) |
uzel clusteru | člen clusteru |
| port uzlu + 10 (7061) | druhý uzel hostitele | služba se switchoverem (sekce 7.3) |
| 7443, 7444 | RCM, operátorská konzole RCM | tento agent je RCM (jeden na hostitele) |
| párovací port (7450) | párovací port agenta | replica s rolí, dokud není propojena |
Agent se k HQCenter připojuje sám (odchozí spojení); příchozí port nepotřebuje.
Docker publikuje porty mimo ufw. Ověřeno: když ufw povolovalo jen port
22, porty Firebird a HQ Monitor byly otevřené z internetu. Použijte
externí firewall, publikujte na jedné adrese hostitele
("10.0.0.5:23050:23050"), nebo přidejte pravidla do řetězu iptables
DOCKER-USER.
Druhá instance na jednom hostiteli potřebuje vlastní složku, name:
projektu, hostname, HQBIRD_FB_PORT a porty. Jméno projektu tvoří jména
svazků (<name>_opt, …): se stejným jménem druhé spuštění převezme
svazky a kontejner prvního.
| Instance 1 | Instance 2 | |
|---|---|---|
name:, hostname: |
hqbird-fb40-3051 |
hqbird-fb40-3052 |
HQBIRD_FB_PORT |
3051 | 3052 |
ports: |
3051, 23051, 7052 | 3052, 23052, 7053 |
Pravidla pro N instancí na jedné vnější IP:
- Firebird
3050 + N, HQ Monitor20000 +port Firebird, uzel clusteru7051 + N(stejnýlisten_portnastavte v HQCenter). Vynechte 3050, 23050 a 7051, když hostitel už provozuje Firebird nebo HQbird mimo Docker. - RCM může být na jednom hostiteli jen jedna instance (7443, 7444).
- S rolí clusteru (sekce 7.1) potřebuje každá instance hostitele vlastní
slot:
HQBIRD_PAIRING_PORT=7451aHQBIRD_NODE_PORT=7052pro druhou,7452a7053pro třetí. - Jedna instance bez zátěže spotřebuje asi 200-250 MB paměti. Ověřeno: tři instance FB 4.0 na 2 vCPU / 4 GB, jedna se zátěží.
- Další řady Firebird na stejném hostiteli se řídí stejnými pravidly, se
svým obrazem (
hqbird2027-fb50, …) a jmény (hqbird-fb50-3054).
Instanci přidejte (zde třetí: 3053, 23053, 7054) z compose.yaml té
první. Nahrazení 3051 změní také name:, hostname:,
HQBIRD_FB_PORT a port 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. Známé problémy
- Až agenta ručně připojíte k HQCenter pomocí
fbagent --enroll, spusťte jako rootfbagent --refresh-apply-launcher, jinak samoaktualizace agenta selže s hlášením “no goafts CA is pinned”. - Ve skriptech spouštějte
docker compose execs-Ta</dev/null. Bez nich čte standardní vstup a sebere zbytek skriptu, který posíláte pomocíssh ... bash -s. - Než je agent připojen k HQCenter, jeho protokol ukazuje varování
goafts mTLS settings are incompleteabootstrap CA not found. To je normální. - Kontejner po každé instalaci předá
/opt/hqbirduživateli root (samoaktualizace agenta to potřebuje). Agent zapíše varování, že nemůže aktualizovat/opt/hqbird/version.json; můžete je ignorovat. - Obrazy do verze 2027.2.32: složky otevřené pro zápis. V těchto
obrazech mají
/etc,/usra/usr/librežim 0777 a některé soubory kontejneru může zapisovat každý účet. Libovolný účet v kontejneru může změnit to, co spouští root. Agent takovou složku také odmítne (root trust directory: /usr is writable by group or others): instalátor v režimu aktualizace potom v novém kontejneru selže a kontejner se spouští znovu a znovu. Použijte obraz 2027.2.33 nebo novější. Ve starším obrazu nedávejte přístup k shellu uživatelům, kterým nedůvěřujete. - Obrazy do verze 2027.2.32: ručně vytvořené RCM se v novém kontejneru
nespustí. Když RCM vytvoříte pomocí
fbagent --cluster-inituvnitř kontejneru, agent založí účet operačního systémuhqbirdrcm. Nový kontejner ho nemá (User=hqbirdrcm: invalid userid, kontejner jeunhealthy). Novější obrazy účty uchovávají na svazkustate. Cluster vytvořený pomocí HQCenter tím není dotčen. - Obrazy do verze 2027.2.33: router (HAProxy) se nespustí. Pro člena
clusteru s rolí
routeragent nainstaluje balíčekhaproxya službu pro router, alehaproxy.serviceselže. Náhrada za systemd v obrazu nevloží hodnoty$CONFIG,$PIDFILEa$EXTRAOPTSdo příkazového řádku, nečte soubor drop-in a nic nevytvoří složku/run/haproxy. Další obraz má opravu. Do té doby dávejte aplikacím adresu z.../services/<alias>/mastera nepřidávejte členarouter. - Obraz 2027.2.33: nový kontejner se nespustí, když byl přidán router.
Protokol obsahuje
chown: invalid user: 'haproxy'a Docker spouští kontejner znovu a znovu. Aby se spustil, odstraňte na svazkustatesouborusr/lib/tmpfiles.d/haproxy.conf. Další obraz má opravu.
10. Sestavení obrazů
Pro tým vydání. Na hostiteli Windows se soubory vydání v
dist\releases se přihlaste ke GHCR tokenem, který má write:packages,
a potom sestavte, odešlete a podepište:
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.keyNový balíček (první push řady) je soukromý. V nastavení balíčku organizace IBSurgeon nastavte jeho viditelnost na veřejnou.
-ContextOnly připraví jen složku sestavení
(dist\hqbird2027-docker\fbNN-<version>) a vypíše příkaz docker build,
který se spustí na hostiteli Docker s Linuxem.
Sestavení se zastaví, když je složka nebo soubor obrazu pod /etc nebo
/usr zapisovatelný všemi účty (složka sestavení pochází z Windows, kde se
režimy ztratí). Testy skriptů kontejneru, nastavení clusteru a souborů
compose: go test ./ops/docker/.