Это руководство для администратора, который запускает 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.

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 мастер, обязателен: адрес или 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 образа):

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: два контейнера с ролью

Один контейнер — мастер: он запускает менеджер кластера (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/ выпуска).

  1. На хосте мастера запишите в .env адрес этого хоста Docker так, как до него доходят хост реплики и ваш браузер (не localhost, не адрес контейнера):

    Command
    echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env
    docker compose -f compose.yaml -f compose.master.yaml up -d
  2. На хосте реплики:

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

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

  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. В Настройки → Связать хосты впишите две строки: адрес, который вы задали в 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 — полный файл с обоими контейнерами:

Command
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 пропускает проверку собственного сертификата кластера:

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. Добавьте вторые узлы в документ кластера: узел-мастер на хосте реплики и его узел-реплику на хосте мастера, оба с 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 в каждом контейнере.

    Затем задайте обоим узлам-репликам папку базы на томе db. Без неё обратное переключение или failover останавливается после точки невозврата, и сервис переходит в 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 — идентификатор агента хоста. Путь на втором хосте — путь файла реплики: <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. Приложения должны подключаться к этому адресу. Для переключения нужна реплика в состоянии 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 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 включительно: маршрутизатор (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, затем соберите, отправьте и подпишите:

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 задайте видимость public.

-ContextOnly только подготавливает папку сборки (dist\hqbird2027-docker\fbNN-<version>) и печатает команду docker build, которую нужно выполнить на хосте Docker под Linux.

Сборка останавливается, если папка или файл образа в /etc или /usr доступны на запись всем учётным записям (папка сборки приходит из Windows, где режимы теряются). Проверки скриптов контейнера, настроек кластера и файлов compose: go test ./ops/docker/.