Chmura i Docker
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.
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.
Obraz Docker
Jeden kontener to jeden Firebird ze wszystkimi komponentami HQbird. Dane są na wolumenach i pozostają przy wymianie kontenera lub obrazu.
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.
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.
| 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 |
Pierwsze uruchomienie
- 1compose.yamlskopiuj go z pakietu do folderu na hoście
- 2hasło SYSDBAdo pliku sekretu, który możesz odczytać tylko Ty
- 3Obraz, nazwa, sekretyustaw
imageihostname, usuń#z liniisecrets: - 4docker compose up -dkontener instaluje HQbird
- 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/, loginadmin. - Instalator tworzy hasło konsoli. Znajduje się ono w pliku
/opt/hqbird/conf/access.propertieswewnątrz kontenera. - Nazwa agenta w HQCenter: nazwa hosta, data instalacji i linia Firebird.
Codzienna praca
| Zadanie | Polecenie |
|---|---|
| Stan usług | docker compose exec hqbird systemctl list-units --type=service |
| Restart Firebird | docker compose exec hqbird systemctl restart firebirdFirebird 3.0: usługa firebird-superserver |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb |
| Log z ostatniej godziny | docker compose logs --since 1h |
| Zatrzymanie | docker 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.
| Ustawienie | Co robi |
|---|---|
HQBIRD_FB_PORT | Port Firebird wewnątrz kontenera, domyślnie 3050. HQ Monitor nasłuchuje na porcie 20000 + ten port. |
HQBIRD_HQM_PORT | Inny port HQ Monitor. |
HQBIRD_AGENT_ID | Nazwa agenta. Domyślnie tworzona z nazwy hosta, daty i portu. |
HQBIRD_HQM_LOGIN, sekret hqmonitor_password | Login i hasło HQ Monitor. |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE | Wniosek o licencję próbną. |
sekret sysdba_password | Hasło SYSDBA nowego Firebird. |
sekret license | Plik licencji. |
sekret attach | Plik attach.json z HQCenter: łączy agenta z Twoim centrum. |
| Wolumen | Ścieżka | Zawartość |
|---|---|---|
db | /db | Bazy danych. Umieść tutaj swoje bazy danych. |
backup | /backup | Kopie zapasowe. |
opt | /opt | Firebird, agent, HQ Monitor, węzeł klastra, RCM. |
state | /var/lib/hqbird-container | Usługi, dane konsoli, logi agenta, identyfikator maszyny. |
trust | /usr/libexec/hqbird-fbagent | Zaufany start aktualizacji agenta. |
rootwork | /var/lib/hqbird-fbagent | Folder roboczy dla aktualizacji. |
- Foldery hosta tylko dla baz danych i kopii zapasowychMożesz zastąpić wolumeny
dbibackupfolderami hosta. Przydziel je użytkownikowi o uid 84: to użytkownikfirebirdw 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
stateoraz z nazwą agenta. Nowy wolumenstateto 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.
| Port | Co | Kiedy potrzebny |
|---|---|---|
HQBIRD_FB_PORT (3050) | Firebird | zawsze |
| 20000 + port Firebird (23050) | HQ Monitor | zawsze |
| port węzła (7051) | węzeł klastra | instancja dołącza do klastra |
| 7443, 7444 | RCM i jego interfejs webowy | ten 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 1 | Instancja 2 | |
|---|---|---|
| Projekt i nazwa hosta | hqbird-fb40-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| Porty | 3051, 23051, 7052 | 3052, 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:7444w 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.
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.
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
-Ti</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 verifynie 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.