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 (два droplet, образ
4.0 2027.2.33). 2026-11-17 остальное проверено на двух хостах Docker
с образом 5.0 2027.2.33: кластер, собранный вручную в контейнерах 2027.2.32
и перенесённый на новый образ (оба контейнера healthy через 35
секунд), HQBIRD_RCM_ALLOW, страницы Сервисы консоли RCM и
автоматическое переключение. Маршрутизаторы (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 |
мастер, обязателен: адрес или DNS-имя хоста Docker, как до него доходят реплика и ваш браузер. Список через запятую; первый попадает в RCM URL |
HQBIRD_CLUSTER_ID |
мастер: идентификатор кластера (по умолчанию: имя хоста) |
секрет rcm_password |
мастер: пароль логина RCM rcmadmin (по умолчанию: сгенерированный) |
HQBIRD_RCM_ALLOW |
реплика: только эти RCM могут пригласить контейнер (IP, CIDR, имя хоста; по умолчанию: любой). Укажите адрес хоста Docker мастера: реплика видит этот адрес. На одном хосте Docker реплика видит шлюз своей сети Docker |
HQBIRD_PAIRING_PORT, HQBIRD_NODE_PORT |
слот кластера: порт pairing 7450-7459 и порт узла = порт pairing - 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 |
программа запуска обновлений агента и trust |
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: два контейнера с ролью
Один контейнер — мастер: он запускает менеджер кластера (RCM) со своей
консолью. Другой — реплика. Роль задаётся при первом
запуске: HQBIRD_CLUSTER_ROLE. Без неё контейнер не запускает RCM, не
запускает узел кластера и не открывает порт pairing. Для роли нужен образ 2027.2.33 или
новее.
Два хоста Docker. Дайте двум контейнерам разные имена хостов
(HQBIRD_HOSTNAME в .env или hostname:): при одном и том же имени хоста
у двух агентов один идентификатор, и RCM отклоняет реплику
(duplicate). Скопируйте compose.master.yaml на хост мастера и
compose.replica.yaml на хост реплики, рядом с compose.yaml
(ops/docker/ выпуска).
-
На хосте мастера запишите в
.envадрес этого хоста Docker так, как до него доходят хост реплики и ваш браузер (неlocalhost, не адрес контейнера):echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env docker compose -f compose.yaml -f compose.master.yaml up -d -
На хосте реплики:
docker compose -f compose.yaml -f compose.replica.yaml up -d -
Прочитайте строки кластера каждого контейнера:
docker compose logs | grep -E 'cluster:|CA hash|Password'Мастер показывает адрес консоли и
CA hash:[hqbird-boot] cluster: role=master id=... console=https://203.0.113.10:7444 login=rcmadmin. Реплика показывает свой порт pairing и отпечаток:[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' -
В Настройки → Связать хосты впишите две строки: адрес, который вы задали в
HQBIRD_CLUSTER_ADDRESS(мастер), и адрес хоста Docker реплики. Порт писать не нужно: RCM читает порты pairing 7450-7459. Порт pairing отвечает примерно через 30 секунд после того, как контейнер становитсяhealthy. Окно «Инициализировать» предлагает папку/databases/replica/..., которая вне томов: измените её. Это окно высотой около 1000 px и не прокручивается: уменьшите масштаб страницы, если не видите его кнопок. Проверено в браузере 2026-11-16. Сверьте отпечаток реплики с отпечатком в её журнале. Оставьте RCM URL пустым. Затем продолжайте с шага 4 руководство по кластеру на Linux (папка базы, регистрация, инициализация реплики). Для папки базы реплики используйте папку на томеdb, например/db/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Контейнеры видят друг друга по имени в сети проекта, поэтому
порты кластера не публикуются. В Связать хосты напишите
hqbird-master и hqbird-replica. Firebird мастера — на порту
3050, реплики — на 3051; консоль — https://<docker host>:7444.
Правила:
- Роль и её настройки читаются только при первом запуске. Позже
другое значение
HQBIRD_CLUSTER_ROLEпишет предупреждение в журнал и ничего не меняет. Чтобы изменить кластер позже, используйте HQ Monitor (Кластеры) или командыfbagent --cluster-initиfbagent --cluster-pairingвнутри контейнера. - Неверная настройка (неизвестная роль, мастер без
HQBIRD_CLUSTER_ADDRESS, настройка другой роли) останавливает запуск до того, как что-либо будет установлено. Журнал сообщает, что нужно написать ([hqbird-boot] error: ...); Docker снова запускает контейнер, и строка в журнале повторяется, пока вы не исправите настройку. - Окно pairing реплики открыто 24 часа. Перезапуск
контейнера, который ещё не в кластере, открывает его снова. Чтобы закрыть
порт pairing для других сетей, используйте
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 узла равным опубликованному порту. Реплика ждёт, пока агент RCM выгрузит CA кластера.
Проверено 2026-11-16 без роли: агенты установили узлы и RCM,
и все члены снова были running после docker compose down и
up -d.
7.3. Переключение между двумя контейнерами
Сервис RCM переносит роль мастера базы с одного хоста на другой. Для сервиса каждому хосту нужны два узла: узел-мастер и узел-реплика. Связать хосты даёт каждому хосту один узел, поэтому вторые узлы вы добавляете сами. Проверено 2026-11-16 на паре из раздела 7.1: переключение заняло 25 секунд, прежний мастер стал репликой только для чтения, и строка, записанная на новом мастере, появилась на нём через 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). -
Добавьте вторые узлы в документ кластера: узел-мастер на хосте реплики и его узел-реплику на хосте мастера, оба с
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в каждом контейнере.Затем задайте обоим узлам-репликам папку базы на томе
db. Без неё обратное переключение или failover останавливается после точки невозврата, и сервис переходит в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— идентификатор агента хоста. Путь на втором хосте — путь файла реплики:<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. Приложения должны подключаться к
этому адресу. Для переключения нужна реплика в состоянии IN_SYNC: она становится такой после
первой записи на мастере (35 секунд на прогоне).
Маршрутизаторы и автоматическое переключение. Маршрутизатор (HAProxy) даёт приложениям один адрес, который следует за мастером. В образах до 2027.2.33 включительно маршрутизатор не запускается (раздел 9); в следующем образе это исправлено. Для автоматического переключения нужен маршрутизатор как свидетель. Проверено 2026-11-17 в лаборатории, на 2027.2.33 с обходным путём и на тестовом образе с исправлением:
-
Маршрутизатор — член кластера с ролью
router. Агент устанавливает пакетhaproxyиз репозитория Debian, в том числе в каждом новом контейнере: контейнеру нужен доступ к репозиторию. Опубликуйте порт маршрутизатора (3051 в примере). -
Когда маршрутизатор только на хосте RCM, RCM сам перенёс мастера через 84 секунды после остановки контейнера другого хоста; операция заняла 10 секунд. Когда этот хост вернулся,
rejoinснова сделал его репликой. -
Когда маршрутизатор есть на каждом хосте, автоматическое переключение не начинается: больше половины маршрутизаторов должны отчитаться, а один из двух — на потерянном хосте.
-
RCM работает в контейнере мастера. Когда этот хост потерян, теряется и RCM, и ничто само не переносит мастера.
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 (один на хост) |
| порт pairing (7450) | порт pairing агента | реплика с ролью, пока её не связали |
Агент сам подключается к 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 включительно: маршрутизатор (HAProxy) не запускается. Для
члена кластера с ролью
routerагент устанавливает пакетhaproxyи службу маршрутизатора, ноhaproxy.serviceне запускается. То, чем образ заменяет systemd, не подставляет значения$CONFIG,$PIDFILEи$EXTRAOPTSв командную строку и не читает файл drop-in, и ничто не создаёт папку/run/haproxy. В следующем образе это исправлено. До тех пор давайте приложениям адрес из.../services/<alias>/masterи не добавляйте членаrouter. - Образ 2027.2.33: новый контейнер не запускается после того, как был добавлен маршрутизатор. В журнале есть
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 задайте видимость public.
-ContextOnly только подготавливает папку сборки
(dist\hqbird2027-docker\fbNN-<version>) и печатает команду docker build,
которую нужно выполнить на хосте Docker под Linux.
Сборка останавливается, если папка или файл образа в /etc или /usr
доступны на запись всем учётным записям (папка сборки приходит из Windows, где
режимы теряются). Проверки скриптов контейнера, настроек кластера
и файлов compose: go test ./ops/docker/.