Облако и Docker

HQbird работает на облачном сервере так же, как на своём. Для Docker есть готовый образ на каждую линию Firebird. Бэкапы идут прямо в S3, без файла на диске сервера. Для связи с центром входящие порты не нужны.

  • 4 образа Firebird 5 · 4 · 3 · 2.5
  • 1 контейнер Firebird, агент и консоль
  • S3 бэкап без файла на диске
  • 0 входящих портов для связи с центром
  • 200–250 МБ памяти на экземпляр без нагрузки

Сервер · контейнер · хранилище

Три части облачной установки

HQbird можно поставить на облачный сервер обычным установщиком или запустить в контейнере Docker. В обоих случаях агент сам подключается к HQCenter, а бэкапы могут идти в хранилище S3.

Схема: приложения и браузер подключаются к контейнеру HQbird на хосте; агент сам подключается к HQCenter и отправляет бэкапы в S3 облачный сервер или хост Docker HQbird Firebird fbagent HQ Monitor тома: /db · /backup · /opt порты: 3050 · 23050 кластер: 7051 · 7443 · 7444 Приложения порт Firebird 3050 Браузер HQ Monitor 23050 HQCenter агент выходит сам S3 бэкапы, HTTPS
Кто к кому подключается. Приложения и браузер входят на порты Firebird и HQ Monitor. К HQCenter и к S3 агент подключается сам: входящих портов для этого нет.
Сервер

Обычный установщик

Один файл ставит Firebird, агента и консоль на облачный сервер. Сам установщик ничего не скачивает. Подходит, когда сервер целиком отдан базе.

Контейнер

Образ Docker

Один контейнер — один Firebird со всеми компонентами HQbird. Данные лежат на томах и остаются при замене контейнера или образа.

Хранилище

Бэкапы в S3

gbak и nbackup пишут в поток, поток идёт в бакет. Место под бэкап на диске сервера не нужно. Работает и на сервере, и в контейнере.

Подробнее на странице бэкапов →

Образы · первый запуск · compose

HQbird в Docker

Контейнер ставит HQbird тем же установщиком, что и сервер. Внутри работают Firebird, агент fbagent и HQ Monitor. Узел кластера агент ставит сам, когда экземпляр входит в кластер. RCM он ставит, только когда этот экземпляр назначен RCM кластера.

Образы лежат в GitHub Container Registry компании IBSurgeon. Они открытые: вход в реестр не нужен. Тег образа — это версия комплекта HQbird.

ОбразFirebirdПорт FirebirdHQ Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050

Первый запуск

  1. 1compose.yamlскопировать из комплекта в папку на хосте
  2. 2Пароль SYSDBAв файл секрета, доступный только вам
  3. 3Образ, имя, секретызадать image и hostname, убрать # у строк secrets:
  4. 4docker compose up -dконтейнер ставит HQbird
  5. 5✓ healthyFirebird и консоль отвечают
mkdir -p secrets
openssl rand -hex 12 > secrets/sysdba_password
chmod 600 secrets/sysdba_password
docker compose up -d
docker compose logs -f   # ход установки
docker compose ps        # ждём healthy

На сервере с 2 ядрами установка при первом запуске занимает около 20 секунд.

Что получилось

  • Firebird: <хост Docker>:3050.
  • HQ Monitor: http://<хост Docker>:23050/, логин admin.
  • Пароль консоли создаёт установщик. Он лежит в файле /opt/hqbird/conf/access.properties внутри контейнера.
  • Имя агента в HQCenter: имя хоста, дата установки и линия Firebird.

Ежедневная работа

ЗадачаКоманда
Состояние службdocker compose exec hqbird systemctl list-units --type=service
Перезапуск Firebirddocker compose exec hqbird systemctl restart firebird
Firebird 3.0: служба firebird-superserver
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Журнал за часdocker compose logs --since 1h
Остановкаdocker compose stop: Firebird закрывает базы

Внутри контейнера команда systemctl управляет службами HQbird, но это не systemd. Она понимает те команды, которыми пользуются программы HQbird: start, stop, restart, status, list-units и другие.

Переменные · секреты · тома

Настройки и тома

Настройки читаются один раз, при первом запуске: это и есть установка. Данные, конфигурация, лицензия и обновлённые программы лежат на томах. Они остаются, когда вы создаёте контейнер заново или меняете образ.

НастройкаЧто делает
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Запрос пробной лицензии.
секрет sysdba_passwordПароль SYSDBA нового Firebird.
секрет licenseФайл лицензии.
секрет attachФайл attach.json из HQCenter: подключает агента к вашему центру.
ТомПутьЧто лежит
db/dbБазы данных. Кладите свои базы сюда.
backup/backupБэкапы.
opt/optFirebird, агент, HQ Monitor, узел кластера, RCM.
state/var/lib/hqbird-containerСлужбы, данные консоли, журналы агента, идентификатор машины.
trust/usr/libexec/hqbird-fbagentДоверенный запуск обновлений агента.
rootwork/var/lib/hqbird-fbagentРабочая папка обновлений.
  • Папки хоста — только для баз и бэкаповТома db и backup можно заменить папками хоста. Отдайте их пользователю с uid 84: это пользователь firebird в образе. Остальные четыре тома папками хоста не заменяйте.
  • Резервная копия томовСохраняйте все шесть томов вместе.
  • Не меняйте имя хостаЛицензия привязана к идентификатору машины на томе state и к имени агента. Новый том state — это новая установка.
  • Подключение к центру одним файломСекрет attach подключает агента к HQCenter при первом запуске. Входить в контейнер для этого не нужно.

Публикация портов · файрвол · второй экземпляр

Порты и несколько экземпляров

Публикуйте каждый порт с одним номером снаружи и внутри контейнера: 3051:3051, а не 3051:3050. Агент и кластер сообщают тот порт, который видят внутри контейнера.

ПортЧтоКогда нужен
HQBIRD_FB_PORT (3050)Firebirdвсегда
20000 + порт Firebird (23050)HQ Monitorвсегда
порт узла (7051)узел кластераэкземпляр входит в кластер
7443, 7444RCM и его веб-интерфейсэтот агент ведёт RCM; один на хост

Docker публикует порты в обход ufw. Проверено: при правиле ufw «только порт 22» порты Firebird и HQ Monitor были открыты из интернета. Используйте внешний файрвол, публикуйте порт на одном адресе хоста ("10.0.0.5:23050:23050") или добавьте правила в цепочку iptables DOCKER-USER.

Второй экземпляр на том же хосте

Каждому экземпляру нужны своя папка, своё имя проекта, своё имя хоста и свои порты. Имя проекта задаёт имена томов. С одинаковым именем второй запуск заберёт тома и контейнер первого.

  • Firebird: 3050 + N.
  • HQ Monitor: 20000 + порт Firebird.
  • Узел кластера: 7051 + N.
  • RCM может вести только один экземпляр хоста.

Другие линии Firebird на том же хосте живут по тем же правилам, со своим образом.

Экземпляр 1Экземпляр 2
Имя проекта и хостаhqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Порты3051, 23051, 70523052, 23052, 7053
  • ПамятьОдин экземпляр без нагрузки занимает около 200–250 МБ. Проверено: три экземпляра Firebird 4.0 на сервере с 2 ядрами и 4 ГБ памяти, один под нагрузкой.
  • Firebird вне Docker на том же хостеЕсли на хосте уже работает Firebird или HQbird без Docker, пропустите порты 3050, 23050 и 7051.

HQCenter · новый образ · кластер

Обновления и кластер

Обновить контейнер можно двумя способами. Оба сохраняют данные.

Из HQCenter

Как на обычном сервере: центр обновляет агента, HQ Monitor, Firebird, узел кластера и RCM внутри контейнера. Обновлённые программы лежат на томе, поэтому остаются после перезапуска.

Новым образом

Замените версию в строке image и выполните:

docker compose pull
docker compose up -d

При старте контейнер запускает установщик нового образа в режиме обновления. Если центр уже обновил агента до версии новее, чем в образе, установщик не запускается: версия не понижается.

Контейнер в кластере

Экземпляр в контейнере входит в кластер так же, как сервер. Адрес участника — это адрес хоста Docker. В compose.yaml опубликуйте порты кластера.

  • Порт узла, например 7051: когда экземпляр — участник кластера.
  • Порты 7443 и 7444: когда этот агент ведёт RCM. Для веб-интерфейса на 7444 задайте в настройках RCM operator_addr = 0.0.0.0:7444.
  • Порт узла в описании кластера должен совпадать с опубликованным портом.

Агент ставит узел через несколько минут после сохранения кластера. До этого порт узла не отвечает.

Подробнее о кластере и репликации →

Облачный сервер · NAT · файрвол

HQbird на облачном сервере

На облачный сервер HQbird ставится обычным установщиком: один файл, одна команда. Firebird, агент и консоль лежат внутри файла: установщик ничего не скачивает. На Linux пару библиотек ОС (libtommath, ICU) он берёт из репозитория дистрибутива. Если репозитория нет, он печатает точные команды и ничего не меняет.

  • Входящие порты для центра не нужныАгент сам подключается к HQCenter. Сервер за NAT или в закрытой сети облака виден в центре так же, как сервер в вашей стойке.
  • Файрвол ОСУстановщик открывает порт нового Firebird и порт HQ Monitor в firewalld или ufw. Правила файрвола самого облака настраиваете вы.
  • Требования к серверуОт 2 ГБ памяти, от 2 ядер, от 5 ГБ диска. Linux x86-64 или Windows.
  • Дистрибутивы LinuxUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, РЕД ОС и другие с apt, dnf, yum или zypper.
  • Сотня серверов скриптомВсе шаги установки есть в виде ключей. План установки можно посмотреть заранее: команда ничего не меняет.
  • Секреты под защитойСекрет, введённый в консоли, идёт к агенту зашифрованным. В отчётах и копиях конфигурации секреты скрыты. В файле конфигурации агента ключ S3 не зашифрован: ограничьте доступ к этому файлу. На сервере Amazon EC2 можно работать без ключа, по роли сервера.
  • Метрики в вашей GrafanaАгент отдаёт метрики Firebird и сервера в формате Prometheus.
  • Диск облака под контролемАгент меряет задержки чтения и записи и прогноз заполнения диска. Медленный или тесный облачный диск виден в отчёте о здоровье.

Подробнее об установке и обновлениях →

Ограничения · советы

Что важно знать

  • Docker и ufwОпубликованный порт контейнера открыт в обход ufw. Закрывайте его внешним файрволом или публикуйте на одном адресе.
  • Настройки — только при первом запускеПеременные и секреты читаются один раз. Порт Firebird, имя хоста и секреты потом изменить нельзя: нужна новая установка. Задания и другие настройки агента меняют в HQ Monitor или из центра.
  • Скрипты с docker compose execВ скриптах добавляйте ключ -T и </dev/null. Без них команда читает стандартный ввод и забирает остаток скрипта.
  • Предупреждения до подключения к центруПока агент не подключён к HQCenter, его журнал пишет, что настройки связи неполные. Это нормально.
  • Подпись образовОбразы подписаны инструментом cosign. Открытый ключ для проверки командой cosign verify пока не опубликован.
  • Где провереноUbuntu 22.04, Docker с Compose, сервер с 2 ядрами и 4 ГБ памяти. Пошаговая установка для Ubuntu есть на русском и португальском.

← Вернуться к обзору HQbird 2027