Questa pagina è stata tradotta automaticamente. Leggi l'originale in inglese. English

Cloud e Docker

HQbird funziona su un server cloud allo stesso modo che sul tuo server. Per Docker c'è un'immagine pronta per ogni linea di Firebird. I backup vanno direttamente su S3, senza alcun file sul disco del server. La connessione al centro non richiede porte in ingresso.

  • 4 immagini Firebird 5 · 4 · 3 · 2.5
  • 1 container Firebird, agente e console
  • S3 backup senza file su disco
  • 0 porte in ingresso per la connessione al centro
  • 200–250 MB di memoria per istanza inattiva

Server · container · storage

Tre parti di un'installazione cloud

Puoi installare HQbird su un server cloud con il normale installer oppure eseguirlo in un container Docker. In entrambi i casi l'agente si connette autonomamente a HQCenter e i backup possono andare su storage S3.

Diagramma: le applicazioni e il browser si connettono al container HQbird sull'host; l'agente si connette autonomamente a HQCenter e invia i backup a S3 cloud server o host Docker HQbird Firebird fbagent HQ Monitor volumi: /db · /backup · /opt porte: 3050 · 23050 cluster: 7051 · 7443 · 7444 Client porta Firebird 3050 Browser HQ Monitor 23050 HQCenter l'agente si connette in uscita S3 backup, HTTPS
Chi si connette a chi. Le applicazioni e il browser arrivano sulle porte di Firebird e HQ Monitor. L'agente si connette autonomamente a HQCenter e a S3: per questo non servono porte in ingresso.
Server

Installer normale

Un solo file installa Firebird, l'agente e la console su un server cloud. L'installer stesso non scarica nulla. È la scelta giusta quando l'intero server è dedicato al database.

Container

Immagine Docker

Un container è un Firebird con tutti i componenti di HQbird. I dati sono su volumi e restano quando sostituisci il container o l'immagine.

Immagini · primo avvio · compose

HQbird in Docker

Il container installa HQbird con lo stesso installer di un server. Al suo interno vengono eseguiti Firebird, l'agente fbagent e HQ Monitor. L'agente installa da solo il nodo del cluster quando l'istanza entra a far parte di un cluster. Installa RCM solo quando questa istanza è assegnata come RCM del cluster.

Le immagini sono nel GitHub Container Registry di IBSurgeon. Sono pubbliche: non è necessario effettuare il login al registry. Il tag dell'immagine è la versione del kit HQbird.

ImmagineFirebirdPorta 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

Primo avvio

  1. 1compose.yamlcopialo dal kit in una cartella sull'host
  2. 2Password SYSDBAin un file secret leggibile solo da te
  3. 3Immagine, nome, secretimposta image e hostname, rimuovi il # dalle righe secrets:
  4. 4docker compose up -dil container installa HQbird
  5. 5✓ healthyFirebird e la console rispondono
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

Su un server con 2 core, l'installazione al primo avvio richiede circa 20 secondi.

Cosa ottieni

  • Firebird: <Docker host>:3050.
  • HQ Monitor: http://<Docker host>:23050/, login admin.
  • L'installer crea la password della console. Si trova nel file /opt/hqbird/conf/access.properties all'interno del container.
  • Il nome dell'agente in HQCenter: il nome host, la data di installazione e la linea di Firebird.

Lavoro quotidiano

AttivitàComando
Stato del serviziodocker compose exec hqbird systemctl list-units --type=service
Riavviare Firebirddocker compose exec hqbird systemctl restart firebird
Firebird 3.0: il servizio firebird-superserver
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Log di un'oradocker compose logs --since 1h
Arrestodocker compose stop: Firebird chiude i database

All'interno del container, il comando systemctl controlla i servizi di HQbird, ma non è systemd. Comprende i comandi usati dai programmi di HQbird: start, stop, restart, status, list-units e altri.

Variabili · secret · volumi

Impostazioni e volumi

Il container legge le impostazioni una sola volta, al primo avvio: questa è l'installazione. I dati, la configurazione, la licenza e i programmi aggiornati sono su volumi. Restano quando ricrei il container o cambi l'immagine.

ImpostazioneCosa fa
HQBIRD_FB_PORTPorta Firebird all'interno del container, 3050 per impostazione predefinita. HQ Monitor è in ascolto su 20000 + questa porta.
HQBIRD_HQM_PORTUna porta HQ Monitor diversa.
HQBIRD_AGENT_IDNome dell'agente. Per impostazione predefinita è composto dal nome host, dalla data e dalla porta.
HQBIRD_HQM_LOGIN, secret hqmonitor_passwordLogin e password di HQ Monitor.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONERichiesta di una licenza di prova.
secret sysdba_passwordPassword SYSDBA del nuovo Firebird.
secret licenseFile di licenza.
secret attachIl file attach.json di HQCenter: connette l'agente al tuo centro.
VolumePercorsoContenuto
db/dbDatabase. Inserisci qui i tuoi database.
backup/backupBackup.
opt/optFirebird, l'agente, HQ Monitor, il nodo del cluster, RCM.
state/var/lib/hqbird-containerServizi, dati della console, log dell'agente, ID macchina.
trust/usr/libexec/hqbird-fbagentAvvio attendibile degli aggiornamenti dell'agente.
rootwork/var/lib/hqbird-fbagentCartella di lavoro per gli aggiornamenti.
  • Cartelle host solo per database e backupPuoi sostituire i volumi db e backup con cartelle host. Assegnale all'utente con uid 84: è l'utente firebird nell'immagine. Non sostituire gli altri quattro volumi con cartelle host.
  • Backup dei volumiSalva tutti e sei i volumi insieme.
  • Non cambiare il nome hostLa licenza è legata all'ID macchina sul volume state e al nome dell'agente. Un nuovo volume state equivale a una nuova installazione.
  • Connettiti al centro con un solo fileIl segreto attach collega l'agente a HQCenter al primo avvio. Non è necessario accedere al container per questo.

Pubblicazione delle porte · firewall · seconda istanza

Porte e più istanze

Pubblica ogni porta con lo stesso numero all'esterno e all'interno del container: 3051:3051, non 3051:3050. L'agente e il cluster riportano la porta che vedono all'interno del container.

PortaCosaQuando serve
HQBIRD_FB_PORT (3050)Firebirdsempre
20000 + porta Firebird (23050)HQ Monitorsempre
porta del nodo (7051)nodo del clusterl'istanza entra in un cluster
7443, 7444RCM e la sua interfaccia webquesto agente esegue RCM; uno per host

Docker pubblica le porte aggirando ufw. L'abbiamo verificato: con la regola ufw "solo porta 22", le porte di Firebird e HQ Monitor erano aperte da internet. Usa un firewall esterno, pubblica la porta su un solo indirizzo host ("10.0.0.5:23050:23050") oppure aggiungi regole alla catena DOCKER-USER di iptables.

Seconda istanza sullo stesso host

Ogni istanza necessita della propria cartella, del proprio nome di progetto, del proprio nome host e delle proprie porte. Il nome del progetto determina i nomi dei volumi. Con lo stesso nome, il secondo avvio prende i volumi e il container del primo.

  • Firebird: 3050 + N.
  • HQ Monitor: 20000 + porta Firebird.
  • Nodo del cluster: 7051 + N.
  • Solo un'istanza sull'host può eseguire RCM.

Le altre linee Firebird sullo stesso host seguono le stesse regole, ciascuna con la propria immagine.

Istanza 1Istanza 2
Progetto e nome hosthqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Porte3051, 23051, 70523052, 23052, 7053
  • MemoriaUn'istanza inattiva occupa circa 200–250 MB. L'abbiamo verificato: tre istanze Firebird 4.0 su un server con 2 core e 4 GB di memoria, una delle quali sotto carico.
  • Firebird fuori da Docker sullo stesso hostSe Firebird o HQbird è già in esecuzione sull'host senza Docker, salta le porte 3050, 23050 e 7051.

HQCenter · nuova immagine · cluster

Aggiornamenti e cluster

Puoi aggiornare un container in due modi. Entrambi conservano i dati.

Da HQCenter

Come su un server normale: il centro aggiorna l'agente, HQ Monitor, Firebird, il nodo del cluster e RCM all'interno del container. I programmi aggiornati si trovano su un volume, quindi restano dopo un riavvio.

Con una nuova immagine

Cambia la versione nella riga image ed esegui:

docker compose pull
docker compose up -d

All'avvio, il container esegue l'installer della nuova immagine in modalità aggiornamento. Se il centro ha già aggiornato l'agente a una versione più recente di quella nell'immagine, l'installer non viene eseguito: la versione non viene retrocessa.

Container in un cluster

Un'istanza in un container entra in un cluster allo stesso modo di un server. L'indirizzo del membro è l'indirizzo dell'host Docker. Pubblica le porte del cluster in compose.yaml.

  • La porta del nodo, ad esempio 7051: quando l'istanza è un membro del cluster.
  • Le porte 7443 e 7444: quando questo agente esegue RCM. Per l'interfaccia web sulla 7444, imposta operator_addr = 0.0.0.0:7444 nelle impostazioni di RCM.
  • La porta del nodo nella descrizione del cluster deve corrispondere alla porta pubblicata.

L'agente installa il nodo pochi minuti dopo che hai salvato il cluster. Fino ad allora, la porta del nodo non risponde.

Maggiori informazioni sul cluster e la replica →

Server cloud · NAT · firewall

HQbird su un server cloud

Su un server cloud, installi HQbird con il normale installer: un file, un comando. Firebird, l'agente e la console sono all'interno del file: l'installer non scarica nulla. Su Linux, ottiene alcune librerie del sistema operativo (libtommath, ICU) dal repository della distribuzione. Se non c'è un repository, stampa i comandi esatti e non modifica nulla.

  • Nessuna porta in ingresso per il centroL'agente si connette a HQCenter autonomamente. Un server dietro NAT o in una rete cloud privata appare nel centro come un server nel tuo rack.
  • Firewall del sistema operativoL'installer apre la porta del nuovo Firebird e la porta di HQ Monitor in firewalld o ufw. Le regole del firewall del cloud le configuri tu.
  • Requisiti del serverAlmeno 2 GB di memoria, 2 core e 5 GB di disco. Linux x86-64 o Windows.
  • Distribuzioni LinuxUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS e altre con apt, dnf, yum o zypper.
  • Cento server tramite scriptOgni fase di installazione è disponibile come opzione. Puoi prima visualizzare il piano di installazione: il comando non modifica nulla.
  • I segreti sono protettiUn segreto che inserisci nella console viene inviato all'agente in forma cifrata. I segreti sono nascosti nei report e nelle copie della configurazione. Nel file di configurazione dell'agente, la chiave S3 non è cifrata: limita l'accesso a questo file. Su un server Amazon EC2, puoi lavorare senza chiave: l'agente usa il ruolo IAM del server.
  • Metriche nel tuo GrafanaL'agente esporta le metriche di Firebird e del server in formato Prometheus.
  • Disco cloud sotto controlloL'agente misura la latenza di lettura e scrittura e prevede quando il disco si riempirà. Un disco cloud lento o quasi pieno è visibile nel report di stato.

Maggiori informazioni sull'installazione e gli aggiornamenti →

Limiti · suggerimenti

Da sapere

  • Docker e ufwUna porta pubblicata del container è aperta aggirando ufw. Chiudila con un firewall esterno o pubblicala su un solo indirizzo.
  • Impostazioni solo al primo avvioLe variabili e i segreti vengono letti una sola volta. Non puoi modificare in seguito la porta di Firebird, il nome host e i segreti: serve una nuova installazione. I job e le altre impostazioni dell'agente li modifichi in HQ Monitor o dal centro.
  • Script con docker compose execNegli script, aggiungi l'opzione -T e </dev/null. Senza di esse, il comando legge l'input standard e prende il resto dello script.
  • Avvisi prima della connessione al centroFinché l'agente non si connette a HQCenter, il suo log indica che le impostazioni di connessione sono incomplete. È normale.
  • Firma dell'immagineLe immagini sono firmate con lo strumento cosign. La chiave pubblica per verificarle con il comando cosign verify non è ancora pubblicata.
  • Dove è stato testatoUbuntu 22.04, Docker con Compose, un server con 2 core e 4 GB di memoria. Una guida all'installazione passo passo per Ubuntu è disponibile in russo e portoghese.

← Torna alla panoramica di HQbird 2027