Хмара та 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 кластера.
Образи розміщені в IBSurgeon GitHub Container Registry. Вони публічні: входити до реєстру не потрібно. Тег образу — це версія комплекту 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 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 |
| Перезапустити 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 встановіть
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 доступне російською та португальською мовами.