Цю сторінку перекладено машинним перекладом. Читайте англійський оригінал. English

Хмара та 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 cloud server or Docker host HQbird Firebird fbagent HQ Monitor volumes: /db · /backup · /opt ports: 3050 · 23050 cluster: 7051 · 7443 · 7444 Clients Firebird port 3050 Browser HQ Monitor 23050 HQCenter agent connects out S3 backups, HTTPS
Хто до кого підключається. Застосунки та браузер підключаються через порти Firebird і HQ Monitor. Агент самостійно підключається до HQCenter і до S3: для цього вхідні порти не потрібні.
Сервер

Звичайний інсталятор

Один файл встановлює Firebird, агент і консоль на хмарному сервері. Сам інсталятор нічого не завантажує. Добре підходить, коли весь сервер призначений для бази даних.

Контейнер

Образ Docker

Один контейнер — це один Firebird з усіма компонентами HQbird. Дані зберігаються на томах і залишаються при заміні контейнера або образу.

Сховище

Резервні копії до S3

gbak і nbackup записують у потік, а потік надсилається до бакета. Резервній копії не потрібне місце на диску сервера. Це працює як на сервері, так і в контейнері.

Докладніше на сторінці резервних копій →

Образи · перший запуск · compose

HQbird у Docker

Контейнер встановлює HQbird за допомогою того самого інсталятора, що й сервер. Усередині працюють Firebird, агент fbagent і HQ Monitor. Агент сам встановлює вузол кластера, коли екземпляр приєднується до кластера. Він встановлює RCM лише тоді, коли цей екземпляр призначено як RCM кластера.

Образи розміщені в IBSurgeon GitHub Container Registry. Вони публічні: входити до реєстру не потрібно. Тег образу — це версія комплекту 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 host>:3050.
  • HQ Monitor: http://<Docker host>: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 встановіть operator_addr = 0.0.0.0:7444 у налаштуваннях RCM.
  • Порт вузла в описі кластера має збігатися з опублікованим портом.

Агент встановлює вузол через кілька хвилин після збереження кластера. До того часу порт вузла не відповідає.

Докладніше про кластер і реплікацію →

Хмарний сервер · 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, RED OS та інші з apt, dnf, yum або zypper.
  • Сто серверів за допомогою скриптаКожен крок встановлення доступний як перемикач. Спочатку можна переглянути план встановлення: команда нічого не змінює.
  • Секрети захищеніСекрет, який ви вводите в консолі, передається агенту в зашифрованому вигляді. Секрети приховані у звітах і в копіях конфігурації. У файлі конфігурації агента ключ S3 не зашифрований: обмежте доступ до цього файлу. На сервері Amazon EC2 можна працювати без ключа: агент використовує IAM-роль сервера.
  • Метрики у вашій 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