Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał angielski. English

Chmura i Docker

HQbird działa na serwerze w chmurze tak samo jak na własnym serwerze. Dla Dockera dostępny jest gotowy obraz dla każdej linii Firebird. Kopie zapasowe trafiają bezpośrednio do S3, bez pliku na dysku serwera. Połączenie z centrum nie wymaga portów przychodzących.

  • 4 obrazy Firebird 5 · 4 · 3 · 2.5
  • 1 kontener Firebird, agent i konsola
  • S3 kopia zapasowa bez pliku na dysku
  • 0 portów przychodzących dla połączenia z centrum
  • 200–250 MB pamięci na bezczynną instancję

Serwer · kontener · pamięć masowa

Trzy części instalacji w chmurze

HQbird można zainstalować na serwerze w chmurze za pomocą zwykłego instalatora lub uruchomić w kontenerze Docker. W obu przypadkach agent sam łączy się z HQCenter, a kopie zapasowe mogą trafiać do pamięci masowej S3.

Diagram: aplikacje i przeglądarka łączą się z kontenerem HQbird na hoście; agent sam łączy się z HQCenter i wysyła kopie zapasowe do S3 serwer w chmurze lub host Docker HQbird Firebird fbagent HQ Monitor wolumeny: /db · /backup · /opt porty: 3050 · 23050 klaster: 7051 · 7443 · 7444 Klienci port Firebird 3050 Przeglądarka HQ Monitor 23050 HQCenter agent łączy się na zewnątrz S3 kopie zapasowe, HTTPS
Kto z kim się łączy. Aplikacje i przeglądarka wchodzą przez porty Firebird i HQ Monitor. Agent sam łączy się z HQCenter i z S3: nie są do tego potrzebne żadne porty przychodzące.
Serwer

Zwykły instalator

Jeden plik instaluje Firebird, agenta i konsolę na serwerze w chmurze. Sam instalator niczego nie pobiera. Dobre rozwiązanie, gdy cały serwer jest przeznaczony na bazę danych.

Kontener

Obraz Docker

Jeden kontener to jeden Firebird ze wszystkimi komponentami HQbird. Dane są na wolumenach i pozostają przy wymianie kontenera lub obrazu.

Pamięć masowa

Kopie zapasowe do S3

gbak i nbackup zapisują do strumienia, a strumień trafia do zasobnika. Kopia zapasowa nie potrzebuje miejsca na dysku serwera. Działa zarówno na serwerze, jak i w kontenerze.

Więcej na stronie kopii zapasowych →

Obrazy · pierwsze uruchomienie · compose

HQbird w Dockerze

Kontener instaluje HQbird tym samym instalatorem co serwer. Wewnątrz działają Firebird, agent fbagent i HQ Monitor. Agent sam instaluje węzeł klastra, gdy instancja dołącza do klastra. RCM instaluje tylko wtedy, gdy ta instancja jest wyznaczona jako RCM klastra.

Obrazy znajdują się w IBSurgeon GitHub Container Registry. Są publiczne: nie trzeba logować się do rejestru. Tag obrazu to wersja pakietu 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

Pierwsze uruchomienie

  1. 1compose.yamlskopiuj go z pakietu do folderu na hoście
  2. 2hasło SYSDBAdo pliku sekretu, który możesz odczytać tylko Ty
  3. 3Obraz, nazwa, sekretyustaw image i hostname, usuń # z linii secrets:
  4. 4docker compose up -dkontener instaluje HQbird
  5. 5✓ healthyFirebird i konsola odpowiadają
mkdir -p secrets
openssl rand -hex 12 > secrets/sysdba_password
chmod 600 secrets/sysdba_password
docker compose up -d
docker compose logs -f   # postęp instalacji
docker compose ps        # poczekaj na healthy

Na serwerze z 2 rdzeniami instalacja przy pierwszym uruchomieniu trwa około 20 sekund.

Co otrzymujesz

  • Firebird: <host Docker>:3050.
  • HQ Monitor: http://<host Docker>:23050/, login admin.
  • Instalator tworzy hasło konsoli. Znajduje się ono w pliku /opt/hqbird/conf/access.properties wewnątrz kontenera.
  • Nazwa agenta w HQCenter: nazwa hosta, data instalacji i linia Firebird.

Codzienna praca

ZadaniePolecenie
Stan usługdocker compose exec hqbird systemctl list-units --type=service
Restart Firebirddocker compose exec hqbird systemctl restart firebird
Firebird 3.0: usługa firebird-superserver
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Log z ostatniej godzinydocker compose logs --since 1h
Zatrzymaniedocker compose stop: Firebird zamyka bazy danych

Wewnątrz kontenera polecenie systemctl steruje usługami HQbird, ale nie jest to systemd. Rozumie polecenia używane przez programy HQbird: start, stop, restart, status, list-units i inne.

Zmienne · sekrety · wolumeny

Ustawienia i wolumeny

Kontener odczytuje ustawienia tylko raz, przy pierwszym uruchomieniu: jest to instalacja. Dane, konfiguracja, licencja i zaktualizowane programy znajdują się na wolumenach. Pozostają przy ponownym utworzeniu kontenera lub zmianie obrazu.

UstawienieCo robi
HQBIRD_FB_PORTPort Firebird wewnątrz kontenera, domyślnie 3050. HQ Monitor nasłuchuje na porcie 20000 + ten port.
HQBIRD_HQM_PORTInny port HQ Monitor.
HQBIRD_AGENT_IDNazwa agenta. Domyślnie tworzona z nazwy hosta, daty i portu.
HQBIRD_HQM_LOGIN, sekret hqmonitor_passwordLogin i hasło HQ Monitor.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONEWniosek o licencję próbną.
sekret sysdba_passwordHasło SYSDBA nowego Firebird.
sekret licensePlik licencji.
sekret attachPlik attach.json z HQCenter: łączy agenta z Twoim centrum.
WolumenŚcieżkaZawartość
db/dbBazy danych. Umieść tutaj swoje bazy danych.
backup/backupKopie zapasowe.
opt/optFirebird, agent, HQ Monitor, węzeł klastra, RCM.
state/var/lib/hqbird-containerUsługi, dane konsoli, logi agenta, identyfikator maszyny.
trust/usr/libexec/hqbird-fbagentZaufany start aktualizacji agenta.
rootwork/var/lib/hqbird-fbagentFolder roboczy dla aktualizacji.
  • Foldery hosta tylko dla baz danych i kopii zapasowychMożesz zastąpić wolumeny db i backup folderami hosta. Przydziel je użytkownikowi o uid 84: to użytkownik firebird w obrazie. Nie zastępuj pozostałych czterech wolumenów folderami hosta.
  • Kopia zapasowa wolumenówZapisuj wszystkie sześć wolumenów razem.
  • Nie zmieniaj nazwy hostaLicencja jest powiązana z identyfikatorem maszyny na wolumenie state oraz z nazwą agenta. Nowy wolumen state to nowa instalacja.
  • Połącz się z centrum jednym plikiemSekret attach łączy agenta z HQCenter przy pierwszym uruchomieniu. Nie musisz w tym celu wchodzić do kontenera.

Publikowanie portów · firewall · druga instancja

Porty i kilka instancji

Publikuj każdy port z tym samym numerem na zewnątrz i wewnątrz kontenera: 3051:3051, a nie 3051:3050. Agent i klaster zgłaszają port, który widzą wewnątrz kontenera.

PortCoKiedy potrzebny
HQBIRD_FB_PORT (3050)Firebirdzawsze
20000 + port Firebird (23050)HQ Monitorzawsze
port węzła (7051)węzeł klastrainstancja dołącza do klastra
7443, 7444RCM i jego interfejs webowyten agent uruchamia RCM; jeden na host

Docker publikuje porty z pominięciem ufw. Sprawdziliśmy to: przy regule ufw „tylko port 22” porty Firebird i HQ Monitor były otwarte z internetu. Użyj zewnętrznego firewalla, publikuj port na jednym adresie hosta ("10.0.0.5:23050:23050") lub dodaj reguły do łańcucha DOCKER-USER w iptables.

Druga instancja na tym samym hoście

Każda instancja potrzebuje własnego folderu, nazwy projektu, nazwy hosta i portów. Nazwa projektu określa nazwy wolumenów. Przy tej samej nazwie drugie uruchomienie przejmuje wolumeny i kontener pierwszego.

  • Firebird: 3050 + N.
  • HQ Monitor: 20000 + port Firebird.
  • Węzeł klastra: 7051 + N.
  • Tylko jedna instancja na hoście może uruchamiać RCM.

Inne linie Firebird na tym samym hoście podlegają tym samym zasadom, każda z własnym obrazem.

Instancja 1Instancja 2
Projekt i nazwa hostahqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Porty3051, 23051, 70523052, 23052, 7053
  • PamięćJedna bezczynna instancja zajmuje około 200–250 MB. Sprawdziliśmy to: trzy instancje Firebird 4.0 na serwerze z 2 rdzeniami i 4 GB pamięci, jedna z nich pod obciążeniem.
  • Firebird poza Dockerem na tym samym hościeJeśli Firebird lub HQbird już działa na hoście bez Dockera, pomiń porty 3050, 23050 i 7051.

HQCenter · nowy obraz · klaster

Aktualizacje i klaster

Kontener możesz aktualizować na dwa sposoby. Oba zachowują dane.

Z HQCenter

Jak na zwykłym serwerze: centrum aktualizuje agenta, HQ Monitor, Firebird, węzeł klastra i RCM wewnątrz kontenera. Zaktualizowane programy znajdują się na wolumenie, więc pozostają po restarcie.

Z nowym obrazem

Zmień wersję w wierszu image i uruchom:

docker compose pull
docker compose up -d

Przy starcie kontener uruchamia instalator nowego obrazu w trybie aktualizacji. Jeśli centrum zaktualizowało już agenta do wersji nowszej niż w obrazie, instalator nie uruchamia się: wersja nie zostaje obniżona.

Kontener w klastrze

Instancja w kontenerze dołącza do klastra w taki sam sposób jak serwer. Adres członka to adres hosta Docker. Opublikuj porty klastra w compose.yaml.

  • Port węzła, na przykład 7051: gdy instancja jest członkiem klastra.
  • Porty 7443 i 7444: gdy ten agent uruchamia RCM. Dla interfejsu webowego na 7444 ustaw operator_addr = 0.0.0.0:7444 w ustawieniach RCM.
  • Port węzła w opisie klastra musi odpowiadać opublikowanemu portowi.

Agent instaluje węzeł kilka minut po zapisaniu klastra. Do tego czasu port węzła nie odpowiada.

Więcej o klastrze i replikacji →

Serwer w chmurze · NAT · firewall

HQbird na serwerze w chmurze

Na serwerze w chmurze instalujesz HQbird zwykłym instalatorem: jeden plik, jedno polecenie. Firebird, agent i konsola są w pliku: instalator niczego nie pobiera. W systemie Linux pobiera kilka bibliotek systemowych (libtommath, ICU) z repozytorium dystrybucji. Jeśli nie ma repozytorium, wypisuje dokładne polecenia i niczego nie zmienia.

  • Brak portów przychodzących dla centrumAgent sam łączy się z HQCenter. Serwer za NAT lub w prywatnej sieci chmurowej wygląda w centrum tak samo jak serwer w Twojej serwerowni.
  • Firewall systemowyInstalator otwiera port nowego Firebird i port HQ Monitor w firewalld lub ufw. Reguły firewalla samej chmury konfigurujesz sam.
  • Wymagania serweraCo najmniej 2 GB pamięci, 2 rdzenie i 5 GB dysku. Linux x86-64 lub Windows.
  • Dystrybucje LinuksaUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS i inne z apt, dnf, yum lub zypper.
  • Sto serwerów skryptemKażdy krok instalacji jest dostępny jako przełącznik. Możesz najpierw zobaczyć plan instalacji: polecenie niczego nie zmienia.
  • Sekrety są chronioneSekret wprowadzony w konsoli trafia do agenta zaszyfrowany. Sekrety są ukrywane w raportach i kopiach konfiguracji. W pliku konfiguracji agenta klucz S3 nie jest zaszyfrowany: ogranicz dostęp do tego pliku. Na serwerze Amazon EC2 możesz pracować bez klucza: agent używa roli IAM serwera.
  • Metryki w Twojej GrafanieAgent eksportuje metryki Firebird i serwera w formacie Prometheus.
  • Dysk w chmurze pod kontroląAgent mierzy opóźnienia odczytu i zapisu oraz prognozuje, kiedy dysk się zapełni. Wolny lub prawie pełny dysk w chmurze jest widoczny w raporcie kondycji.

Więcej o instalacji i aktualizacjach →

Ograniczenia · wskazówki

Warto wiedzieć

  • Docker i ufwOpublikowany port kontenera jest otwarty z pominięciem ufw. Zamknij go zewnętrznym firewallem lub publikuj go na jednym adresie.
  • Ustawienia tylko przy pierwszym starcieZmienne i sekrety są odczytywane raz. Nie możesz później zmienić portu Firebird, nazwy hosta i sekretów: potrzebna jest nowa instalacja. Zadania i inne ustawienia agenta zmieniasz w HQ Monitor lub z centrum.
  • Skrypty z docker compose execW skryptach dodaj przełącznik -T i </dev/null. Bez nich polecenie czyta standardowe wejście i przejmuje resztę skryptu.
  • Ostrzeżenia przed połączeniem z centrumDopóki agent nie połączy się z HQCenter, jego log informuje, że ustawienia połączenia są niekompletne. To normalne.
  • Podpis obrazuObrazy są podpisywane narzędziem cosign. Klucz publiczny do ich weryfikacji poleceniem cosign verify nie został jeszcze opublikowany.
  • Gdzie testowanoUbuntu 22.04, Docker z Compose, serwer z 2 rdzeniami i 4 GB pamięci. Przewodnik instalacji krok po kroku dla Ubuntu jest dostępny w języku rosyjskim i portugalskim.

← Powrót do przeglądu HQbird 2027