HQbird 2027 у Docker: посібник адміністратора
Цей посібник для адміністратора, який запускає 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.
docker pull ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.33Образи підписані за допомогою cosign. Відкритий ключ hqbird-cosign.pub
ще не опубліковано (2026-11-16). Образи 2027.2.33 підписані. Коли ключ у вас є, перевірте образ,
перш ніж його використовувати:
cosign verify --key hqbird-cosign.pub ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.332. Перший запуск
-
Скопіюйте
compose.yaml(зops/docker/випуску) до теки на хості Docker. -
Запишіть пароль SYSDBA у файл, який можете читати лише ви:
mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password -
У
compose.yamlзадайтеimage:,hostname:і приберіть#з рядківsecrets:, які ви використовуєте. -
Запустіть контейнер:
docker compose up -d -
Стежте за встановленням (кілька хвилин під час першого запуску):
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
образу):
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:на нову версію, а потім: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/ випуску).
-
На хості master запишіть у
.envадресу цього хоста Docker, як до неї доходять хост replica і ваш браузер (неlocalhost, не адреса контейнера):echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env docker compose -f compose.yaml -f compose.master.yaml up -d -
На хості replica:
docker compose -f compose.yaml -f compose.replica.yaml up -d -
Прочитайте рядки кластера кожного контейнера:
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:.... -
Відкрийте консоль
https://<master host>:7444. Вхід —rcmadmin. Без секретуrcm_passwordпароль лежить у файлі; RCM просить новий під час першого входу:docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password' -
У 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 — це повний файл
з обома контейнерами:
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 пропускає перевірку власного сертифіката
кластера:
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }-
Опублікуйте порт другого вузла на обох хостах: порт вузла + 10. У
compose.master.yamlіcompose.replica.yamlприберіть#з рядка"7061:7061", а потім виконайтеdocker compose up -dз тими самими параметрами-f. Зробіть це до першого запуску, якщо можете. -
Дайте кожному вузлу адресу його хоста Docker. RCM дає цю адресу і порт Firebird застосункам; без неї вони отримують адресу контейнера:
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). -
Додайте другі вузли до документа кластера: вузол master на хості replica і його вузол replica на хості master, обидва з
listen_port7061. Прочитайте документ, додайте двох учасників і один зв’язок і надішліть його назад із його ревізією: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: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 -
Визначте сервіс.
host— це ідентифікатор агента хоста. Шлях на другому хості — це шлях файла 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 -
Перевірте, а потім перемкніть:
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 Monitor20000 +порт 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:
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,
а потім зберіть, надішліть до реєстру і підпишіть:
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/.