Ово упутство је за администратора који покреће HQbird 2027 у Docker-у. Један контејнер је једна Firebird инстанца са свим компонентама HQbird-а:

  • Firebird (HQbird склоп једне линије: 5.0, 4.0, 3.0 или 2.5);
  • HQbird агент (fbagent): резервне копије, надгледање, послови одржавања, ажурирања, веза са HQCenter-ом;
  • HQ Monitor: веб конзола инстанце;
  • чвор кластера (hqclusternode) и RCM (hqbirdrcm): агент их инсталира када HQCenter дода ову инстанцу у кластер, или када контејнеру дате улогу у кластеру (одељак 7). Без улоге и без HQCenter-а контејнер не покреће ниједну компоненту кластера.

Контејнер инсталира HQbird истим офлајн инсталером као сервер (упутство за инсталацију на Linux-у). Агент затим ажурира Firebird, HQ Monitor, компоненте кластера и себе из HQCenter-а, као на серверу. Ваши подаци, конфигурација, лиценца, сертификати HQCenter-а и ажурирани програми су на волуменима: остају када поново направите контејнер или промените слику.

Тренутно издање: 2027.2.33 (2026-11-16): Firebird 2.5.9, 3.0.15, 4.0.8 и 5.0.5, агент 3.4.0, HQ Monitor 1.57.0, RCM и чвор 2027.5.12.

Проверено 2026-11-16 на Ubuntu 22.04.5 (2 vCPU / 4 GB), Docker 29.10.0, Compose 5.7.1, слика hqbird2027-fb40:2027.2.33 (прва провера: 2026-11-11, слика 2027.2.27). Инсталација корак по корак за Ubuntu 22.04: hqbird2027-docker-install-fb40.ru.md (руски), hqbird2027-docker-install-fb40.pt.md (португалски).

Улога у кластеру (одељак 7.1) и пребацивање (одељак 7.3) проверени су 2026-11-16 на сликама 5.0, 4.0, 3.0 и 2.5, при чему су два „хоста“ била две адресе једне виртуелне машине, и на два одвојена Docker хоста (два droplet-а, слика 4.0, 2027.2.33). Дана 2026-11-17 остало је проверено на два Docker хоста са сликом 5.0, 2027.2.33: кластер направљен ручно у контејнерима 2027.2.32 и премештен на нову слику (оба контејнера healthy за 35 секунди), HQBIRD_RCM_ALLOW, странице Services RCM конзоле и аутоматско преузимање. Router-и (HAProxy) се не покрећу у сликама до 2027.2.33 (одељак 9); следећа слика има исправку.

1. Слике

Слика Firebird Подразумевани порт
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

Слике су у GitHub Container Registry организације IBSurgeon (https://github.com/orgs/IBSurgeon/packages). Јавне су: пријава није потребна. <version> је верзија HQbird подешавања, на пример 2027.2.33. Ознака 2027.2 је најновија слика 2027.2.x.

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

Слике су потписане помоћу cosign. Јавни кључ hqbird-cosign.pub још није објављен (2026-11-16). Слике 2027.2.33 јесу потписане. Када имате кључ, проверите слику пре употребе:

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

2. Прво покретање

  1. Копирајте compose.yaml (из ops/docker/ издања) у фасциклу на Docker хосту.

  2. Ставите SYSDBA лозинку у датотеку коју можете да читате само ви:

    Command
    mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password
  3. У compose.yaml поставите image:, hostname: и уклоните # са редова secrets: које користите.

  4. Покрените контејнер:

    Command
    docker compose up -d
  5. Пратите инсталацију (неколико минута при првом покретању):

    Command
    docker compose logs -f

    На 2 vCPU инсталација траје око 20 секунди. Готова је када дневник покаже [hqbird-boot] ready: firebird.service=active ... и docker compose ps покаже healthy.

Затим:

  • Firebird: <docker host>:3050.
  • HQ Monitor: http://<docker host>:23050/, пријава admin. Инсталер прави лозинку; прочитајте је помоћу docker compose exec hqbird cat /opt/hqbird/conf/access.properties.
  • Идентификатор агента у HQCenter-у: име хоста + датум инсталације (YYMMDD) + -fbNN, на пример hqbird-fb40-3051261111-fb40.

Задржите име хоста. Идентитет лиценце инстанце је machine-id на волумену state и идентификатор агента. Нови волумен state је нова инсталација.

3. Подешавања

Подешавања се читају само при првом покретању (инсталација).

Подешавање Шта ради
HQBIRD_FB_PORT Firebird порт унутар контејнера (подразумевано 3050). HQ Monitor користи 20000 + овај порт
HQBIRD_HQM_PORT други порт за HQ Monitor
HQBIRD_AGENT_ID идентификатор агента (подразумевано: од имена хоста, датума и порта)
HQBIRD_HQM_LOGIN + секрет hqmonitor_password пријава за HQ Monitor
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE затражите пробну лиценцу (прихватате политику приватности)
HQBIRD_DEBUG=1 инсталирајте Firebird датотеке за отклањање грешака
секрет sysdba_password SYSDBA лозинка новог Firebird-а
секрет license датотека лиценце
секрет attach attach.json из HQCenter-а: повежите агент са вашим HQCenter-ом
HQBIRD_CLUSTER_ROLE master или replica: кластер без HQCenter-а (одељак 7). Празно: нема кластера
HQBIRD_CLUSTER_ADDRESS master, обавезно: адреса или DNS име Docker хоста, онако како га replica и ваш прегледач досежу. Списак са зарезима; прва иде у RCM URL
HQBIRD_CLUSTER_ID master: идентификатор кластера (подразумевано: име хоста)
секрет rcm_password master: лозинка RCM пријаве rcmadmin (подразумевано: генерисана)
HQBIRD_RCM_ALLOW replica: само ови RCM-ови смеју да позову контејнер (IP, CIDR, име хоста; подразумевано: било који). Упишите адресу Docker хоста master-а: replica види ту адресу. На једном Docker хосту replica види мрежни пролаз своје Docker мреже
HQBIRD_PAIRING_PORT, HQBIRD_NODE_PORT слот кластера: порт за упаривање 7450-7459 и порт чвора = порт за упаривање - 399 (подразумевано 7450 и 7051)

4. Волумени

Волумен Путања Садржај
opt /opt Firebird, агент, HQ Monitor, чвор кластера, RCM
state /var/lib/hqbird-container јединице, sudoers, подаци HQ Monitor-а, дневници агента, machine-id, стање подешавања, налози оперативног система направљени током рада (корисник сервиса RCM)
trust /usr/libexec/hqbird-fbagent покретач ажурирања агента и поверење
rootwork /var/lib/hqbird-fbagent радна фасцикла покретача ажурирања
db /db базе података (овде ставите своје базе)
backup /backup резервне копије

Не монтирајте фасцикле хоста на opt, state, trust и rootwork. За db и backup можете користити фасцикле хоста; дајте их uid-у 84 (корисник firebird слике):

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

Направите резервну копију свих шест волумена заједно.

5. Свакодневни рад

Задатак Команда
Стање сервиса docker compose exec hqbird systemctl list-units --type=service
Поново покрени 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
Дневници docker compose logs --since 1h
Заустављање (Firebird затвара базе података) docker compose stop

Унутар контејнера systemctl управља сервисима HQbird-а. То није systemd: подржава команде које програми HQbird-а користе (start, stop, restart, status, is-active, enable, disable, show, list-units, daemon-reload).

6. Ажурирања

Постоје два начина ажурирања. Оба чувају ваше податке.

  • Из HQCenter-а (као на серверу): HQCenter ажурира агент, HQ Monitor, Firebird, чвор кластера и RCM унутар контејнера.

  • Нова слика: промените image: на нову верзију, затим:

    Command
    docker compose pull && docker compose up -d

    При покретању контејнер покреће инсталер нове слике у режиму ажурирања. Ако је HQCenter већ ажурирао агент на новију верзију од оне коју слика има, инсталер се не покреће (нема враћања на старију верзију); дневник то каже.

Нови контејнер (нова слика, или docker compose down и up -d без -v) чува кластер: улога, идентификатор кластера, RCM, чворови и веза са другим хостом су на волуменима. Подешавања кластера у compose датотеци се не читају поново. Слике до 2027.2.32 имају два недостатка овде: видите одељак 9.

7. Кластер

Постоје два начина да се направи кластер. Не мешајте их у једном контејнеру.

7.1. Без HQCenter-а: два контејнера са улогом

Један контејнер је master и покреће менаџер кластера (RCM) са његовом конзолом. Други је replica. Улога је подешавање првог покретања: HQBIRD_CLUSTER_ROLE. Без њега контејнер не покреће RCM, не покреће чвор кластера и не отвара порт за упаривање. Улога захтева слику 2027.2.33 или новију.

Два Docker хоста. Дајте два контејнера различита имена хоста (HQBIRD_HOSTNAME у .env, или hostname:): са истим именом хоста два агента имају исти идентификатор, и RCM одбија replica (duplicate). Копирајте compose.master.yaml на master хост и compose.replica.yaml на replica хост, поред compose.yaml (ops/docker/ издања).

  1. На master хосту ставите адресу тог Docker хоста у .env, онако како је досежу replica хост и ваш прегледач (не localhost, не адреса контејнера):

    Command
    echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env
    docker compose -f compose.yaml -f compose.master.yaml up -d
  2. На replica хосту:

    Command
    docker compose -f compose.yaml -f compose.replica.yaml up -d
  3. Прочитајте редове кластера сваког контејнера:

    Command
    docker compose logs | grep -E 'cluster:|CA hash|Password'

    Master показује адресу конзоле и CA hash: [hqbird-boot] cluster: role=master id=... console=https://203.0.113.10:7444 login=rcmadmin. Replica показује свој порт за упаривање и отисак: [hqbird-boot] cluster: role=replica pairing port 7450: open until ..., fingerprint sha256:....

  4. Отворите конзолу https://<master host>:7444. Пријава је rcmadmin. Без секрета rcm_password лозинка је у датотеци; RCM тражи нову при првој пријави:

    Command
    docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password'
  5. У Settings → Link hosts упишите два реда: адресу коју сте дали у HQBIRD_CLUSTER_ADDRESS (master) и адресу Docker хоста replica-е. Порт не пишете: RCM чита портове за упаривање 7450-7459. Порт за упаривање одговара око 30 секунди након што је контејнер healthy. Прозор Initialize предлаже фасциклу /databases/replica/..., која је изван волумена: промените је. Тај прозор је висок око 1000 px и не скролује: умањите страницу ако не видите његова дугмад. Проверено у прегледачу 2026-11-16. Упоредите отисак replica-е са оним у њеном дневнику. Оставите RCM URL празним. Затим наставите кораком 4 из водича упутство за кластер на Linux-у (фасцикла базе података, упис, иницијализација replica-е). За фасциклу базе података replica-е користите фасциклу на волумену db, на пример /db/replica. Проверено: ред уписан на master-у био је на replica-и за 30 секунди.

Да бисте прескочили опције -f, ставите COMPOSE_FILE=compose.yaml:compose.master.yaml (или ...replica.yaml) у .env.

Један Docker хост. compose.cluster-one-host.yaml је потпуна датотека са оба контејнера:

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

Контејнери се међусобно досежу по имену на мрежи пројекта, па портови кластера нису објављени. У Link hosts упишите hqbird-master и hqbird-replica. Firebird master-а је на порту 3050, Firebird replica-е на 3051; конзола је https://<docker host>:7444.

Правила:

  • Улога и њена подешавања читају се само при првом покретању. Касније другачији HQBIRD_CLUSTER_ROLE даје упозорење у дневнику и не мења ништа. Да бисте касније променили кластер, користите HQ Monitor (Clusters) или команде fbagent --cluster-init и fbagent --cluster-pairing унутар контејнера.
  • Погрешно подешавање (непозната улога, master без HQBIRD_CLUSTER_ADDRESS, подешавање друге улоге) зауставља покретање пре него што се ишта инсталира. Дневник каже шта да упишете ([hqbird-boot] error: ...); Docker поново покреће контејнер и дневник понавља ред док не исправите подешавање.
  • Прозор упаривања replica-е отворен је 24 часа. Поновно покретање контејнера који још није у кластеру поново га отвара. Да бисте затворили порт за упаривање према другим мрежама, користите HQBIRD_RCM_ALLOW или свој фајервол; после повезивања можете уклонити порт из ports:.
  • За пребацивање (сервис RCM-а) сваком хосту треба други чвор и његов објављени порт: видите одељак 7.3.

7.2. Са HQCenter-ом

HQCenter додаје инстанцу у кластер као што додаје сервер. Не постављајте HQBIRD_CLUSTER_ROLE. У HQCenter-у наведите адресу Docker хоста као адресу члана. У compose.yaml објавите портове компоненти кластера:

Компонента Порт Када објавити
чвор кластера listen_port чвора (на пример 7051) инстанца је члан кластера
RCM 7443 HQCenter прави овог агента RCM-ом
конзола оператера RCM-а 7444 као горе; поставите operator_addr на 0.0.0.0:7444 у подешавањима RCM-а

Агент инсталира чвор (и RCM) неколико минута након што се кластер сачува. До тада порт чвора не одговара. У HQCenter-у поставите listen_port чвора на објављени порт. Replica чека док RCM агент не отпреми CA кластера.

Проверено 2026-11-16 без улоге: агенти су инсталирали чворове и RCM, и сви чланови су поново били running после docker compose down и up -d.

7.3. Пребацивање између два контејнера

Сервис RCM-а премешта улогу master базе података са једног хоста на други. За сервис сваком хосту требају два чвора: чвор master и чвор replica. Link hosts даје сваком хосту један чвор, па друге чворове додајете сами. Проверено 2026-11-16 на пару из одељка 7.1: пребацивање је трајало 25 секунди, стари master је постао replica само за читање, и ред уписан на новом master-у био је на њему 15 секунди касније.

Кораци користе оператерски API RCM-а на порту конзоле. curl тражи лозинку rcmadmin; -k прескаче проверу сопственог сертификата кластера:

Command
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }
  1. Објавите порт другог чвора на оба хоста: порт чвора + 10. У compose.master.yaml и compose.replica.yaml уклоните # са реда "7061:7061", затим покрените docker compose up -d са истим опцијама -f. Урадите ово пре првог покретања ако можете.

  2. Дајте сваком чвору адресу његовог Docker хоста. RCM даје ову адресу и Firebird порт апликацијама; без ње добијају адресу контејнера:

    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 показује идентификаторе чворова (<host name>-master, <host name>-replica).

  3. Додајте друге чворове у документ кластера: чвор master на replica хосту и његов чвор replica на master хосту, оба са listen_port 7061. Прочитајте документ, додајте два члана и једну везу, и пошаљите га назад са његовом ревизијом:

    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

    Агенти затим инсталирају два сервиса чвора (30 секунди у провери на два хоста; може трајати неколико минута). docker compose exec hqbird systemctl list-units --type=service затим показује два сервиса hqclusternode у сваком контејнеру.

    Затим дајте оба чвора replica фасциклу базе података на волумену db. Без ње, пребацивање назад или преузимање стаје после тачке без повратка, и сервис прелази у 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. Дефинишите сервис. host је идентификатор агента хоста. Путања на другом хосту је путања датотеке 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. Проверите, затим пребаците:

    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>

После пребацивања, .../services/shop/master даје адресу другог Docker хоста и његов Firebird порт. Апликације морају да се повежу на ту адресу. Пребацивање тражи replica-у која је IN_SYNC: јесте, после првог уписа на master-у (35 секунди у провери).

Router-и и аутоматско преузимање. Router (HAProxy) даје апликацијама једну адресу која прати master. У сликама до 2027.2.33 router се не покреће (одељак 9); следећа слика има исправку. Аутоматско преузимање тражи router као сведока. Проверено 2026-11-17 у лабораторији, на 2027.2.33 са заобилазним решењем и на пробној слици са исправком:

  • Router је члан кластера са улогом router. Агент инсталира пакет haproxy из Debian репозиторијума, и у сваком новом контејнеру: контејнеру је потребан приступ репозиторијуму. Објавите порт router-а (3051 у примеру).

  • Са router-ом само на хосту RCM-а, RCM је сам преместио master 84 секунди након што се контејнер другог хоста зауставио; операција је трајала 10 секунди. Када се тај хост вратио, rejoin га је поново учинио replica-ом.

  • Са router-ом на сваком хосту аутоматско преузимање се не покреће: више од половине router-а мора да јави стање, а један од два је на изгубљеном хосту.

  • RCM ради у контејнеру master-а. Када се тај хост изгуби, губи се и RCM, и ништа само не премешта master.

8. Портови, фајервол, друга инстанца

Објавите сваки порт са истим бројем споља и унутар контејнера (3051:3051, не 3051:3050). Агент и кластер пријављују порт који виде унутар контејнера.

Порт Шта Потребно
HQBIRD_FB_PORT (3050) Firebird увек
20000 + Firebird порт (23050) HQ Monitor увек
listen_port чвора (7051) чвор кластера члан кластера
порт чвора + 10 (7061) други чвор хоста сервис са пребацивањем (одељак 7.3)
7443, 7444 RCM, конзола оператера RCM-а овај агент је RCM (један по хосту)
порт за упаривање (7450) порт за упаривање агента replica са улогом, док се не повеже

Агент се сам повезује са HQCenter-ом (одлазно); не треба му долазни порт.

Docker објављује портове мимо ufw. Проверено: када ufw дозвољава само порт 22, портови Firebird-а и HQ Monitor-а били су отворени са интернета. Користите спољни фајервол, објавите на једној адреси хоста ("10.0.0.5:23050:23050"), или додајте правила у iptables ланац DOCKER-USER.

Друга инстанца на једном хосту треба сопствену фасциклу, name: пројекта, hostname, HQBIRD_FB_PORT и портове. Име пројекта прави имена волумена (<name>_opt, …): са истим именом, друго покретање узима волумене и контејнер првог.

Инстанца 1 Инстанца 2
name:, hostname: hqbird-fb40-3051 hqbird-fb40-3052
HQBIRD_FB_PORT 3051 3052
ports: 3051, 23051, 7052 3052, 23052, 7053

Правила за N инстанци на једној спољној IP адреси:

  • Firebird 3050 + N, HQ Monitor 20000 + Firebird порт, чвор кластера 7051 + N (поставите исти listen_port у HQCenter-у). Прескочите 3050, 23050 и 7051 када хост већ покреће Firebird или HQbird ван Docker-а.
  • Само једна инстанца по хосту може бити RCM (7443, 7444).
  • Са улогом у кластеру (одељак 7.1), свака инстанца хоста треба сопствени слот: HQBIRD_PAIRING_PORT=7451 и HQBIRD_NODE_PORT=7052 за другу, 7452 и 7053 за трећу.
  • Једна инстанца користи око 200-250 MB меморије без оптерећења. Проверено: три инстанце FB 4.0 на 2 vCPU / 4 GB, једна под оптерећењем.
  • Друге линије Firebird-а на истом хосту следе иста правила са својом сликом (hqbird2027-fb50, …) и именима (hqbird-fb50-3054).

Додајте инстанцу (овде трећу: 3053, 23053, 7054) из compose.yaml прве. Замена 3051 мења и name:, hostname:, HQBIRD_FB_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. Познати проблеми

  • Након што ручно повежете агент са HQCenter-ом помоћу fbagent --enroll, покрените fbagent --refresh-apply-launcher као root, иначе самоажурирање агента не успева са “no goafts CA is pinned”.
  • У скриптама покрећите docker compose exec са -T и </dev/null. Без њих чита стандардни улаз и узима остатак скрипте коју шаљете са ssh ... bash -s.
  • Пре него што се агент повеже са HQCenter-ом, његов дневник показује упозорења goafts mTLS settings are incomplete и bootstrap CA not found. То је нормално.
  • Контејнер даје /opt/hqbird кориснику root после сваке инсталације (самоажурирање агента то захтева). Агент пише упозорење да не може да ажурира /opt/hqbird/version.json; можете га занемарити.
  • Слике до 2027.2.32: фасцикле отворене за писање. У овим сликама /etc, /usr и /usr/lib имају режим 0777, и неке датотеке контејнера може да пише сваки налог. Било који налог у контејнеру може да промени оно што root покреће. Агент такође одбија такву фасциклу (root trust directory: /usr is writable by group or others): инсталер у режиму ажурирања тада не успева у новом контејнеру, и контејнер се покреће изнова и изнова. Користите слику 2027.2.33 или новију. Не дајте приступ љусци у контејнеру старије слике корисницима којима не верујете.
  • Слике до 2027.2.32: RCM направљен ручно не покреће се у новом контејнеру. Када направите RCM помоћу fbagent --cluster-init унутар контејнера, агент прави налог оперативног система hqbirdrcm. Нови контејнер га нема (User=hqbirdrcm: invalid userid, контејнер је unhealthy). Новије слике чувају налоге на волумену state. Кластер који направи HQCenter није погођен.
  • Слике до 2027.2.33: router (HAProxy) се не покреће. За члана кластера са улогом router агент инсталира пакет haproxy и сервис router-а, али haproxy.service не успева. Замена за systemd у слици не ставља вредности $CONFIG, $PIDFILE и $EXTRAOPTS у командну линију и не чита drop-in датотеку, и ништа не прави фасциклу /run/haproxy. Следећа слика има исправку. До тада дајте апликацијама адресу из .../services/<alias>/master и не додајте члана router.
  • Слика 2027.2.33: нови контејнер се не покреће након што је router додат. Дневник има chown: invalid user: 'haproxy', и Docker покреће контејнер изнова и изнова. Да бисте га покренули, уклоните датотеку usr/lib/tmpfiles.d/haproxy.conf на волумену state. Следећа слика има исправку.

10. Изградња слика

За тим издања. На Windows хосту са датотекама издања у dist\releases, пријавите се на GHCR токеном који има write:packages, затим изградите, пошаљите и потпишите:

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

Нови пакет (прво слање једне линије) је приватан. У подешавањима пакета организације IBSurgeon поставите његову видљивост на јавно.

-ContextOnly припрема само фасциклу изградње (dist\hqbird2027-docker\fbNN-<version>) и исписује команду docker build коју треба покренути на Linux Docker хосту.

Изградња стаје када је фасцикла или датотека слике под /etc или /usr отворена за писање свим налозима (фасцикла изградње долази са Windows-а, где се режими губе). Провере скрипти контејнера, подешавања кластера и compose датотека: go test ./ops/docker/.