Облак и Docker
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 складиште.
Уобичајени инсталер
Једна датотека инсталира 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 комплета.
| Слика | 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копирајте га из комплета у фасциклу на хосту
- 2SYSDBA лозинкау тајну датотеку коју само ви можете да читате
- 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 | Сервиси, подаци конзоле, дневници агента, 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, 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 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 доступан је на руском и португалском.