Cloud e Docker
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.
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.
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.
Backup su S3
gbak e nbackup scrivono su uno stream, e lo stream va in un bucket. Il backup non richiede spazio sul disco del server. Funziona sia su un server sia in un container.
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.
| Immagine | Firebird | Porta 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 |
Primo avvio
- 1compose.yamlcopialo dal kit in una cartella sull'host
- 2Password SYSDBAin un file secret leggibile solo da te
- 3Immagine, nome, secretimposta
imageehostname, rimuovi il#dalle righesecrets: - 4docker compose up -dil container installa HQbird
- 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/, loginadmin. - L'installer crea la password della console. Si trova nel file
/opt/hqbird/conf/access.propertiesall'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 servizio | docker compose exec hqbird systemctl list-units --type=service |
| Riavviare Firebird | docker compose exec hqbird systemctl restart firebirdFirebird 3.0: il servizio firebird-superserver |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb |
| Log di un'ora | docker compose logs --since 1h |
| Arresto | docker 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.
| Impostazione | Cosa fa |
|---|---|
HQBIRD_FB_PORT | Porta Firebird all'interno del container, 3050 per impostazione predefinita. HQ Monitor è in ascolto su 20000 + questa porta. |
HQBIRD_HQM_PORT | Una porta HQ Monitor diversa. |
HQBIRD_AGENT_ID | Nome dell'agente. Per impostazione predefinita è composto dal nome host, dalla data e dalla porta. |
HQBIRD_HQM_LOGIN, secret hqmonitor_password | Login e password di HQ Monitor. |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE | Richiesta di una licenza di prova. |
secret sysdba_password | Password SYSDBA del nuovo Firebird. |
secret license | File di licenza. |
secret attach | Il file attach.json di HQCenter: connette l'agente al tuo centro. |
| Volume | Percorso | Contenuto |
|---|---|---|
db | /db | Database. Inserisci qui i tuoi database. |
backup | /backup | Backup. |
opt | /opt | Firebird, l'agente, HQ Monitor, il nodo del cluster, RCM. |
state | /var/lib/hqbird-container | Servizi, dati della console, log dell'agente, ID macchina. |
trust | /usr/libexec/hqbird-fbagent | Avvio attendibile degli aggiornamenti dell'agente. |
rootwork | /var/lib/hqbird-fbagent | Cartella di lavoro per gli aggiornamenti. |
- Cartelle host solo per database e backupPuoi sostituire i volumi
dbebackupcon cartelle host. Assegnale all'utente con uid 84: è l'utentefirebirdnell'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
statee al nome dell'agente. Un nuovo volumestateequivale a una nuova installazione. - Connettiti al centro con un solo fileIl segreto
attachcollega 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.
| Porta | Cosa | Quando serve |
|---|---|---|
HQBIRD_FB_PORT (3050) | Firebird | sempre |
| 20000 + porta Firebird (23050) | HQ Monitor | sempre |
| porta del nodo (7051) | nodo del cluster | l'istanza entra in un cluster |
| 7443, 7444 | RCM e la sua interfaccia web | questo 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 1 | Istanza 2 | |
|---|---|---|
| Progetto e nome host | hqbird-fb40-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| Porte | 3051, 23051, 7052 | 3052, 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:7444nelle 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.
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
-Te</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 verifynon è 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.