Tato stránka byla strojově přeložena. Přečtěte si anglický originál. English

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.

Diagram: aplikace a prohlížeč se připojují ke kontejneru HQbird na hostiteli; agent se sám připojuje k HQCenter a odesílá zálohy do S3 cloud server or Docker host HQbird Firebird fbagent HQ Monitor volumes: /db · /backup · /opt ports: 3050 · 23050 cluster: 7051 · 7443 · 7444 Klienti Firebird port 3050 Prohlížeč HQ Monitor 23050 HQCenter agent connects out S3 backups, HTTPS
Kdo se připojuje ke komu. Aplikace a prohlížeč přicházejí na porty Firebird a HQ Monitor. Agent se připojuje k HQCenter a k S3 sám: k tomu nejsou potřeba žádné příchozí porty.
Server

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.

Kontejner

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.

Úložiště

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.

Více na stránce o zálohách →

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.

ObrazFirebirdPort 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

První spuštění

  1. 1compose.yamlzkopírujte jej ze sady do složky na hostiteli
  2. 2heslo SYSDBAdo souboru secret, který můžete číst jen vy
  3. 3Obraz, název, secretynastavte image a hostname, odstraňte # z řádků secrets:
  4. 4docker compose up -dkontejner nainstaluje HQbird
  5. 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.properties uvnitř kontejneru.
  • Název agenta v HQCenter: název hostitele, datum instalace a řada Firebird.

Každodenní práce

ÚkolPříkaz
Stav služebdocker compose exec hqbird systemctl list-units --type=service
Restart Firebirddocker compose exec hqbird systemctl restart firebird
Firebird 3.0: služba firebird-superserver
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Log za jednu hodinudocker 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_PORTPort Firebird uvnitř kontejneru, ve výchozím nastavení 3050. HQ Monitor naslouchá na 20000 + tento port.
HQBIRD_HQM_PORTJiný port HQ Monitor.
HQBIRD_AGENT_IDNázev agenta. Ve výchozím nastavení se vytvoří z názvu hostitele, data a portu.
HQBIRD_HQM_LOGIN, secret hqmonitor_passwordPřihlášení a heslo HQ Monitor.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONEŽádost o zkušební licenci.
secret sysdba_passwordHeslo SYSDBA nového Firebird.
secret licenseSoubor licence.
secret attachSoubor attach.json z HQCenter: připojí agenta k vašemu centru.
SvazekCestaObsah
db/dbDatabáze. Sem umístěte své databáze.
backup/backupZálohy.
opt/optFirebird, agent, HQ Monitor, uzel clusteru, RCM.
state/var/lib/hqbird-containerSlužby, data konzole, protokoly agenta, ID stroje.
trust/usr/libexec/hqbird-fbagentDůvěryhodné spuštění aktualizací agenta.
rootwork/var/lib/hqbird-fbagentPracovní složka pro aktualizace.
  • Hostitelské složky pouze pro databáze a zálohySvazky db a backup můžete nahradit hostitelskými složkami. Přidělte je uživateli s uid 84: to je uživatel firebird v 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 state a na název agenta. Nový svazek state znamená novou instalaci.
  • Připojení k centru jedním souboremTajemství attach př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.

PortCoKdy je potřeba
HQBIRD_FB_PORT (3050)Firebirdvždy
20000 + port Firebird (23050)HQ Monitorvždy
port uzlu (7051)uzel clusteruinstance se připojí ke clusteru
7443, 7444RCM 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 1Instance 2
Název projektu a hostitelehqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Porty3051, 23051, 70523052, 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á.

Více o clusteru a replikaci →

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.

Více o instalaci a aktualizacích →

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č -T a </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 verify zatí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ě.

← Zpět na přehled HQbird 2027