Облако и Docker
Облако и Docker
HQbird работает на облачном сервере так же, как на своём. Для Docker есть готовый образ на каждую линию Firebird. Бэкапы идут прямо в S3, без файла на диске сервера. Для связи с центром входящие порты не нужны.
- 4 образа Firebird 5 · 4 · 3 · 2.5
- 1 контейнер Firebird, агент и консоль
- S3 бэкап без файла на диске
- 0 входящих портов для связи с центром
- 200–250 МБ памяти на экземпляр без нагрузки
Сервер · контейнер · хранилище
Три части облачной установки
HQbird можно поставить на облачный сервер обычным установщиком или запустить в контейнере Docker. В обоих случаях агент сам подключается к 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 | Порт Firebird | HQ Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
Первый запуск
- 1compose.yamlскопировать из комплекта в папку на хосте
- 2Пароль SYSDBAв файл секрета, доступный только вам
- 3Образ, имя, секретызадать
imageиhostname, убрать#у строкsecrets: - 4docker compose up -dконтейнер ставит HQbird
- 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 |
| Перезапуск Firebird | docker compose exec hqbird systemctl restart firebirdFirebird 3.0: служба firebird-superserver |
| isql | docker 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 | /opt | Firebird, агент, 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, 7444 | RCM и его веб-интерфейс | этот агент ведёт 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-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| Порты | 3051, 23051, 7052 | 3052, 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 есть на русском и португальском.