Cloud a Docker
Cloud a Docker
HQbird funguje na cloudovém serveru stejně jako na vašem vlastním serveru. Pro Docker je připravený obraz pro každou řadu Firebird. Zálohy jdou přímo do S3, bez souboru na disku serveru. Připojení k centru nepotřebuje žádné příchozí porty.
- 4 obrazy Firebird 5 · 4 · 3 · 2.5
- 1 kontejner Firebird, agent a konzole
- S3 záloha bez souboru na disku
- 0 příchozích portů pro připojení k centru
- 200–250 MB paměti na nečinnou instanci
Server · kontejner · úložiště
Tři části cloudové instalace
HQbird můžete nainstalovat na cloudový server běžným instalátorem nebo jej spustit v kontejneru Docker. V obou případech se agent připojí k HQCenter sám a zálohy mohou jít do úložiště S3.
Běžný instalátor
Jeden soubor nainstaluje Firebird, agenta a konzoli na cloudový server. Instalátor sám nic nestahuje. Vhodné, když je celý server pro databázi.
Obraz Docker
Jeden kontejner je jeden Firebird se všemi komponentami HQbird. Data jsou na svazcích a zůstanou, když kontejner nebo obraz nahradíte.
Zálohy do S3
gbak a nbackup zapisují do streamu a stream jde do bucketu. Záloha nepotřebuje místo na disku serveru. Funguje na serveru i v kontejneru.
Obrazy · první spuštění · compose
HQbird v Dockeru
Kontejner nainstaluje HQbird stejným instalátorem jako server. Uvnitř běží Firebird, agent fbagent a HQ Monitor. Agent sám nainstaluje uzel clusteru, když se instance připojí ke clusteru. RCM nainstaluje pouze tehdy, když je tato instance určena jako RCM clusteru.
Obrazy jsou v IBSurgeon GitHub Container Registry. Jsou veřejné: do registru se nemusíte přihlašovat. Tag obrazu je verze sady HQbird.
| Obraz | Firebird | Port 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 |
První spuštění
- 1compose.yamlzkopírujte jej ze sady do složky na hostiteli
- 2heslo SYSDBAdo souboru secret, který můžete číst jen vy
- 3Obraz, název, secretynastavte
imageahostname, odstraňte#z řádkůsecrets: - 4docker compose up -dkontejner nainstaluje HQbird
- 5✓ healthyFirebird a konzole odpovídají
mkdir -p secrets openssl rand -hex 12 > secrets/sysdba_password chmod 600 secrets/sysdba_password docker compose up -d docker compose logs -f # installation progress docker compose ps # wait for healthy
Na serveru se 2 jádry trvá instalace při prvním spuštění asi 20 sekund.
Co získáte
- Firebird:
<Docker host>:3050. - HQ Monitor:
http://<Docker host>:23050/, přihlášeníadmin. - Instalátor vytvoří heslo konzole. Je v souboru
/opt/hqbird/conf/access.propertiesuvnitř kontejneru. - Název agenta v HQCenter: název hostitele, datum instalace a řada Firebird.
Každodenní práce
| Úkol | Příkaz |
|---|---|
| Stav služeb | docker compose exec hqbird systemctl list-units --type=service |
| Restart Firebird | docker compose exec hqbird systemctl restart firebirdFirebird 3.0: služba firebird-superserver |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb |
| Log za jednu hodinu | docker compose logs --since 1h |
| Zastavení | docker compose stop: Firebird uzavře databáze |
Uvnitř kontejneru příkaz systemctl ovládá služby HQbird, ale není to systemd. Rozumí příkazům, které programy HQbird používají: start, stop, restart, status, list-units a dalším.
Proměnné · secrety · svazky
Nastavení a svazky
Kontejner načte nastavení pouze jednou, při prvním spuštění: to je instalace. Data, konfigurace, licence a aktualizované programy jsou na svazcích. Zůstanou, když kontejner vytvoříte znovu nebo změníte obraz.
| Nastavení | Co dělá |
|---|---|
HQBIRD_FB_PORT | Port Firebird uvnitř kontejneru, ve výchozím nastavení 3050. HQ Monitor naslouchá na 20000 + tento port. |
HQBIRD_HQM_PORT | Jiný port HQ Monitor. |
HQBIRD_AGENT_ID | Název agenta. Ve výchozím nastavení se vytvoří z názvu hostitele, data a portu. |
HQBIRD_HQM_LOGIN, secret hqmonitor_password | Přihlášení a heslo HQ Monitor. |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE | Žádost o zkušební licenci. |
secret sysdba_password | Heslo SYSDBA nového Firebird. |
secret license | Soubor licence. |
secret attach | Soubor attach.json z HQCenter: připojí agenta k vašemu centru. |
| Svazek | Cesta | Obsah |
|---|---|---|
db | /db | Databáze. Sem umístěte své databáze. |
backup | /backup | Zálohy. |
opt | /opt | Firebird, agent, HQ Monitor, uzel clusteru, RCM. |
state | /var/lib/hqbird-container | Služby, data konzole, protokoly agenta, ID stroje. |
trust | /usr/libexec/hqbird-fbagent | Důvěryhodné spuštění aktualizací agenta. |
rootwork | /var/lib/hqbird-fbagent | Pracovní složka pro aktualizace. |
- Hostitelské složky pouze pro databáze a zálohySvazky
dbabackupmůžete nahradit hostitelskými složkami. Přidělte je uživateli s uid 84: to je uživatelfirebirdv image. Ostatní čtyři svazky hostitelskými složkami nenahrazujte. - Záloha svazkůVšech šest svazků zálohujte společně.
- Neměňte název hostiteleLicence je vázána na ID stroje na svazku
statea na název agenta. Nový svazekstateznamená novou instalaci. - Připojení k centru jedním souboremTajemství
attachpřipojí agenta k HQCenter při prvním spuštění. Kvůli tomu není nutné vstupovat do kontejneru.
Publikování portů · firewall · druhá instance
Porty a několik instancí
Každý port publikujte se stejným číslem vně i uvnitř kontejneru: 3051:3051, ne 3051:3050. Agent a cluster hlásí port, který vidí uvnitř kontejneru.
| Port | Co | Kdy je potřeba |
|---|---|---|
HQBIRD_FB_PORT (3050) | Firebird | vždy |
| 20000 + port Firebird (23050) | HQ Monitor | vždy |
| port uzlu (7051) | uzel clusteru | instance se připojí ke clusteru |
| 7443, 7444 | RCM a jeho webové rozhraní | tento agent provozuje RCM; jeden na hostitele |
Docker publikuje porty mimo ufw. Ověřili jsme to: s pravidlem ufw „pouze port 22“ byly porty Firebird a HQ Monitor otevřené z internetu. Použijte externí firewall, publikujte port na jedné adrese hostitele ("10.0.0.5:23050:23050") nebo přidejte pravidla do řetězce DOCKER-USER v iptables.
Druhá instance na stejném hostiteli
Každá instance potřebuje vlastní složku, název projektu, název hostitele a porty. Název projektu určuje názvy svazků. Při stejném názvu druhé spuštění převezme svazky a kontejner prvního.
- Firebird: 3050 + N.
- HQ Monitor: 20000 + port Firebird.
- Uzel clusteru: 7051 + N.
- Na hostiteli může RCM provozovat pouze jedna instance.
Další řady Firebird na stejném hostiteli se řídí stejnými pravidly, každá s vlastním image.
| Instance 1 | Instance 2 | |
|---|---|---|
| Název projektu a hostitele | hqbird-fb40-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| Porty | 3051, 23051, 7052 | 3052, 23052, 7053 |
- PaměťJedna nečinná instance zabírá přibližně 200–250 MB. Ověřili jsme to: tři instance Firebird 4.0 na serveru se 2 jádry a 4 GB paměti, jedna z nich pod zátěží.
- Firebird mimo Docker na stejném hostiteliPokud na hostiteli již běží Firebird nebo HQbird bez Dockeru, vynechejte porty 3050, 23050 a 7051.
HQCenter · nový image · cluster
Aktualizace a cluster
Kontejner můžete aktualizovat dvěma způsoby. Oba zachovají data.
Z HQCenter
Jako na běžném serveru: centrum aktualizuje agenta, HQ Monitor, Firebird, uzel clusteru a RCM uvnitř kontejneru. Aktualizované programy jsou na svazku, takže po restartu zůstanou.
S novým image
Změňte verzi na řádku image a spusťte:
docker compose pull docker compose up -d
Při spuštění kontejner spustí instalátor nového image v režimu aktualizace. Pokud centrum již aktualizovalo agenta na verzi novější, než je v image, instalátor se nespustí: verze se nesníží.
Kontejner v clusteru
Instance v kontejneru se připojí ke clusteru stejně jako server. Adresa člena je adresa hostitele Dockeru. Publikujte porty clusteru v compose.yaml.
- Port uzlu, například 7051: když je instance členem clusteru.
- Porty 7443 a 7444: když tento agent provozuje RCM. Pro webové rozhraní na 7444 nastavte v nastavení RCM
operator_addr=0.0.0.0:7444. - Port uzlu v popisu clusteru musí odpovídat publikovanému portu.
Agent nainstaluje uzel několik minut po uložení clusteru. Do té doby port uzlu neodpovídá.
Cloudový server · NAT · firewall
HQbird na cloudovém serveru
Na cloudovém serveru nainstalujete HQbird běžným instalátorem: jeden soubor, jeden příkaz. Firebird, agent a konzole jsou uvnitř souboru: instalátor nic nestahuje. V Linuxu získá několik systémových knihoven (libtommath, ICU) z úložiště distribuce. Pokud úložiště není k dispozici, vypíše přesné příkazy a nic nezmění.
- Žádné příchozí porty pro centrumAgent se k HQCenter připojuje sám. Server za NAT nebo v privátní cloudové síti vypadá v centru stejně jako server ve vašem racku.
- Firewall operačního systémuInstalátor otevře port nového Firebird a port HQ Monitor ve firewalld nebo ufw. Pravidla firewallu samotného cloudu nastavíte vy.
- Požadavky na serverAlespoň 2 GB paměti, 2 jádra a 5 GB disku. Linux x86-64 nebo Windows.
- Linuxové distribuceUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS a další s apt, dnf, yum nebo zypper.
- Sto serverů skriptemKaždý krok instalace je dostupný jako přepínač. Nejprve si můžete prohlédnout plán instalace: příkaz nic nezmění.
- Tajemství jsou chráněnaTajemství, které zadáte v konzoli, se k agentovi přenese šifrovaně. Tajemství jsou skryta ve zprávách a v kopiích konfigurace. V konfiguračním souboru agenta není klíč S3 šifrován: omezte přístup k tomuto souboru. Na serveru Amazon EC2 můžete pracovat bez klíče: agent použije IAM roli serveru.
- Metriky ve vaší GrafaněAgent exportuje metriky Firebird a serveru ve formátu Prometheus.
- Cloudový disk pod kontrolouAgent měří latenci čtení a zápisu a předpovídá, kdy se disk zaplní. Pomalý nebo téměř plný cloudový disk je vidět ve zprávě o stavu.
Omezení · tipy
Dobré vědět
- Docker a ufwPublikovaný port kontejneru je otevřený mimo ufw. Zavřete jej externím firewallem nebo jej publikujte na jedné adrese.
- Nastavení pouze při prvním spuštěníProměnné a tajemství se načtou jednou. Port Firebird, název hostitele a tajemství nelze později změnit: potřebujete novou instalaci. Úlohy a další nastavení agenta měníte v HQ Monitor nebo z centra.
- Skripty s docker compose execVe skriptech přidejte přepínač
-Ta</dev/null. Bez nich příkaz čte standardní vstup a převezme zbytek skriptu.
- Upozornění před připojením k centruDokud se agent nepřipojí k HQCenter, jeho protokol uvádí, že nastavení připojení je neúplné. To je normální.
- Podpis imageImage jsou podepsány nástrojem cosign. Veřejný klíč pro jejich ověření příkazem
cosign verifyzatím není zveřejněn. - Kde bylo testovánoUbuntu 22.04, Docker s Compose, server se 2 jádry a 4 GB paměti. Podrobný průvodce instalací pro Ubuntu je k dispozici v ruštině a portugalštině.