Ова страница је машински преведена. Прочитајте енглески оригинал. English

Cloud и Docker

HQbird ради на cloud серверу исто као и на вашем сопственом серверу. За Docker постоји готова слика за сваку Firebird линију. Резервне копије иду директно на S3, без датотеке на диску сервера. Веза са центром не захтева долазне портове.

  • 4 слике Firebird 5 · 4 · 3 · 2.5
  • 1 контејнер Firebird, агент и конзола
  • S3 резервна копија без датотеке на диску
  • 0 долазних портова за везу са центром
  • 200–250 MB меморије по неактивној инстанци

Сервер · контејнер · складиште

Три дела cloud инсталације

HQbird можете инсталирати на cloud серверу помоћу уобичајеног инсталера или га покренути у 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 Клијенти Firebird port 3050 Прегледач HQ Monitor 23050 HQCenter agent connects out S3 backups, HTTPS
Ко се са ким повезује. Апликације и прегледач долазе преко Firebird и HQ Monitor портова. Агент се сам повезује са HQCenter и са S3: за то нису потребни долазни портови.
Сервер

Уобичајени инсталер

Једна датотека инсталира Firebird, агент и конзолу на cloud серверу. Сам инсталер ништа не преузима. Добро решење када је цео сервер намењен бази података.

Контејнер

Docker слика

Један контејнер је један Firebird са свим HQbird компонентама. Подаци су на волуменима и остају када замените контејнер или слику.

Складиште

Резервне копије на S3

gbak и nbackup пишу у ток, а ток иде у bucket. Резервној копији није потребан простор на диску сервера. Ради и на серверу и у контејнеру.

Више о резервним копијама →

Слике · прво покретање · compose

HQbird у Docker-у

Контејнер инсталира HQbird помоћу истог инсталера као и сервер. Унутра раде Firebird, агент fbagent и HQ Monitor. Агент сам инсталира чвор кластера када се инстанца придружи кластеру. RCM инсталира само када је ова инстанца одређена као RCM кластера.

Слике се налазе у IBSurgeon GitHub Container Registry. Јавне су: није потребно да се пријављујете на registry. Ознака слике је верзија HQbird комплета.

СликаFirebirdFirebird портHQ 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. 2SYSDBA лозинкау тајну датотеку коју само ви можете да читате
  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_passwordSYSDBA лозинка новог Firebird-а.
тајна licenseДатотека лиценце.
тајна attachДатотека attach.json из HQCenter: повезује агента са вашим центром.
ВолуменПутањаСадржај
db/dbБазе података. Овде стављајте своје базе података.
backup/backupРезервне копије.
opt/optFirebird, агент, HQ Monitor, чвор кластера, RCM.
state/var/lib/hqbird-containerСервиси, подаци конзоле, дневници агента, ID машине.
trust/usr/libexec/hqbird-fbagentПоуздано покретање ажурирања агента.
rootwork/var/lib/hqbird-fbagentРадна фасцикла за ажурирања.
  • Фасцикле хоста само за базе података и резервне копијеМожете заменити волумене db и backup фасциклама хоста. Доделите их кориснику са uid 84: то је корисник firebird у слици. Не замењујте остала четири волумена фасциклама хоста.
  • Резервна копија волуменаСачувајте свих шест волумена заједно.
  • Не мењајте назив хостаЛиценца је везана за ID машине на волумену 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 MB. Проверили смо: три Firebird 4.0 инстанце на серверу са 2 језгра и 4 GB меморије, једна од њих под оптерећењем.
  • 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 подешавањима.
  • Порт чвора у опису кластера мора да одговара објављеном порту.

Агент инсталира чвор неколико минута након што сачувате кластер. До тада, порт чвора не одговара.

Више о кластеру и репликацији →

Cloud сервер · NAT · firewall

HQbird на cloud серверу

На cloud серверу, HQbird инсталирате нормалним инсталером: један фајл, једна команда. Firebird, агент и конзола су унутар фајла: инсталер ништа не преузима. На Linux-у, преузима неколико OS библиотека (libtommath, ICU) из репозиторијума дистрибуције. Ако нема репозиторијума, исписује тачне команде и ништа не мења.

  • Нема долазних портова за центарАгент се сам повезује са HQCenter-ом. Сервер иза NAT-а или у приватној cloud мрежи изгледа исто у центру као сервер у вашем раку.
  • OS firewallИнсталер отвара порт новог Firebird-а и порт HQ Monitor-а у firewalld или ufw. Правила firewall-а самог cloud-а подешавате ви.
  • Захтеви сервераНајмање 2 GB меморије, 2 језгра и 5 GB диска. Linux x86-64 или Windows.
  • Linux дистрибуцијеUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS и друге са apt, dnf, yum или zypper.
  • Стотину сервера скриптомСваки корак инсталације је доступан као прекидач. Прво можете погледати план инсталације: команда ништа не мења.
  • Тајне су заштићенеТајна коју унесете у конзолу иде до агента шифрована. Тајне су скривене у извештајима и у копијама конфигурације. У конфигурационом фајлу агента, S3 кључ није шифрован: ограничите приступ овом фајлу. На Amazon EC2 серверу, можете радити без кључа: агент користи IAM улогу сервера.
  • Метрике у вашој GrafanaАгент извози Firebird и серверске метрике у Prometheus формату.
  • Cloud диск под контроломАгент мери латенцију читања и писања и предвиђа када ће диск бити пун. Спор или скоро пун cloud диск је видљив у извештају о здрављу.

Више о инсталацији и ажурирањима →

Ограничења · савети

Добро је знати

  • Docker и ufwОбјављени порт контејнера је отворен мимо ufw. Затворите га спољним firewall-ом или га објавите на једној адреси.
  • Подешавања само при првом покретањуПроменљиве и тајне се читају једном. Не можете касније променити Firebird порт, назив хоста и тајне: потребна је нова инсталација. Послове и друга подешавања агента мењате у HQ Monitor-у или из центра.
  • Скрипте са docker compose execУ скриптама, додајте прекидач -T и </dev/null. Без њих, команда чита стандардни улаз и узима остатак скрипте.
  • Упозорења пре везе са центромДок се агент не повеже са HQCenter-ом, његов лог каже да су подешавања везе непотпуна. То је нормално.
  • Потпис сликеСлике су потписане алатом cosign. Јавни кључ за њихову проверу командом cosign verify још није објављен.
  • Где је тестираноUbuntu 22.04, Docker са Compose-ом, сервер са 2 језгра и 4 GB меморије. Водич за инсталацију корак по корак за Ubuntu доступан је на руском и португалском.

← Назад на преглед HQbird 2027