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.

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

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

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

2. První spuštění

  1. Zkopírujte compose.yaml (z ops/docker/ vydání) do složky na hostiteli Docker.

  2. Zapište heslo SYSDBA do souboru, který smíte číst jen vy:

    Command
    mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password
  3. V compose.yaml nastavte image:, hostname: a odstraňte # z řádků secrets:, které používáte.

  4. Spusťte kontejner:

    Command
    docker compose up -d
  5. Sledujte instalaci (při prvním spuštění několik minut):

    Command
    docker compose logs -f

    Na 2 vCPU trvá instalace asi 20 sekund. Je hotová, když protokol ukáže [hqbird-boot] ready: firebird.service=active ... a docker compose ps ukáže healthy.

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říklad hqbird-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):

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

Zá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:

    Command
    docker compose pull && docker compose up -d

    Př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í).

  1. Na hostiteli master zapište do .env adresu tohoto hostitele Docker, jak ji dosáhne hostitel replica a váš prohlížeč (ne localhost, ne adresa kontejneru):

    Command
    echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env
    docker compose -f compose.yaml -f compose.master.yaml up -d
  2. Na hostiteli replica:

    Command
    docker compose -f compose.yaml -f compose.replica.yaml up -d
  3. Přečtěte řádky clusteru každého kontejneru:

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

  4. Otevřete konzoli https://<master host>:7444. Přihlašovací jméno je rcmadmin. Bez secretu rcm_password je heslo v souboru; RCM si při prvním přihlášení vyžádá nové:

    Command
    docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password'
  5. 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 kontejner healthy. 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 svazku db, 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:

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

Kontejnery 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_ROLE zapíše do protokolu varování a nic nezmění. Cluster později změníte v HQ Monitor (Clusters) nebo příkazy fbagent --cluster-init a fbagent --cluster-pairing uvnitř 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_ALLOW nebo svého firewallu; po propojení můžete port vyjmout z ports:.
  • 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:

Command
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }
  1. Publikujte port druhého uzlu na obou hostitelích: port uzlu + 10. V compose.master.yaml a compose.replica.yaml odstraňte # z řádku "7061:7061" a potom spusťte docker compose up -d se stejnými volbami -f. Udělejte to před prvním spuštěním, když můžete.

  2. Dejte každému uzlu adresu jeho hostitele Docker. RCM tuto adresu a port Firebird předá aplikacím; bez ní dostanou adresu kontejneru:

    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 ukáže id uzlů (<host name>-master, <host name>-replica).

  3. Přidejte druhé uzly do dokumentu clusteru: uzel master na hostiteli replica a jeho uzel replica na hostiteli master, oba s listen_port 7061. Přečtěte dokument, přidejte dva členy a jeden link a pošlete ho zpět s jeho revizí:

    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

    Agenti 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=service potom ukáže v každém kontejneru dvě služby hqclusternode.

    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 do 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. Definujte službu. host je id agenta hostitele. Cesta na druhém hostiteli je cesta souboru replica: <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. Zkontrolujte a potom přepněte:

    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>

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íček haproxy z 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, rejoin z 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 Monitor 20000 + port Firebird, uzel clusteru 7051 + N (stejný listen_port nastavte 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=7451 a HQBIRD_NODE_PORT=7052 pro druhou, 7452 a 7053 pro 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:

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. Známé problémy

  • Až agenta ručně připojíte k HQCenter pomocí fbagent --enroll, spusťte jako root fbagent --refresh-apply-launcher, jinak samoaktualizace agenta selže s hlášením “no goafts CA is pinned”.
  • Ve skriptech spouštějte docker compose exec s -T a </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 incomplete a bootstrap CA not found. To je normální.
  • Kontejner po každé instalaci předá /opt/hqbird už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, /usr a /usr/lib rež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-init uvnitř kontejneru, agent založí účet operačního systému hqbirdrcm. Nový kontejner ho nemá (User=hqbirdrcm: invalid userid, kontejner je unhealthy). Novější obrazy účty uchovávají na svazku state. 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í router agent nainstaluje balíček haproxy a službu pro router, ale haproxy.service selže. Náhrada za systemd v obrazu nevloží hodnoty $CONFIG, $PIDFILE a $EXTRAOPTS do 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>/master a nepřidávejte člena router.
  • 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 svazku state soubor usr/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:

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

Nový 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/.