Цей посібник для адміністратора, який запускає 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 ГБ), 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 (два droplets, образ 4.0 2027.2.33). 2026-11-17 решту перевірено на двох хостах Docker з образом 5.0 2027.2.33: кластер, зібраний вручну в контейнерах 2027.2.32 і перенесений на новий образ (обидва контейнери healthy за 35 секунд), HQBIRD_RCM_ALLOW, сторінки Services консолі RCM і автоматичне перемикання при відмові. Routers (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 запишіть у .env адресу цього хоста Docker, як до неї доходять хост 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, з’явився на цій replica за 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 секунд у тесті).

Routers і автоматичне перемикання при відмові. 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 МБ пам’яті без навантаження. Перевірено: три екземпляри FB 4.0 на 2 vCPU / 4 ГБ, один із навантаженням.
  • Інші лінії 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 у командний рядок і не читає додатковий файл юніта, і ніщо не створює теку /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, яку треба виконати на хості Docker з Linux.

Збірка зупиняється, коли тека або файл образу під /etc чи /usr доступні для запису будь-якому обліковому запису (тека збірки походить із Windows, де режими втрачаються). Тести скриптів контейнера, параметрів кластера і файлів Compose: go test ./ops/docker/.