Cloud et Docker
Cloud et Docker
HQbird fonctionne sur un serveur cloud de la même manière que sur votre propre serveur. Pour Docker, une image prête à l'emploi existe pour chaque version de Firebird. Les sauvegardes vont directement vers S3, sans fichier sur le disque du serveur. La connexion au centre ne nécessite aucun port entrant.
- 4 images Firebird 5 · 4 · 3 · 2.5
- 1 conteneur Firebird, agent et console
- S3 sauvegarde sans fichier sur disque
- 0 port entrant pour la connexion au centre
- 200–250 Mo de mémoire par instance inactive
Serveur · conteneur · stockage
Trois parties d'une installation cloud
Vous pouvez installer HQbird sur un serveur cloud avec l'installateur habituel ou l'exécuter dans un conteneur Docker. Dans les deux cas, l'agent se connecte de lui-même à HQCenter, et les sauvegardes peuvent être envoyées vers le stockage S3.
Installateur habituel
Un seul fichier installe Firebird, l'agent et la console sur un serveur cloud. L'installateur lui-même ne télécharge rien. Un bon choix lorsque le serveur entier est dédié à la base de données.
Image Docker
Un conteneur, c'est un Firebird avec tous les composants HQbird. Les données sont sur des volumes et restent en place lorsque vous remplacez le conteneur ou l'image.
Sauvegardes vers S3
gbak et nbackup écrivent dans un flux, et le flux va vers un bucket. La sauvegarde n'a besoin d'aucun espace sur le disque du serveur. Cela fonctionne aussi bien sur un serveur que dans un conteneur.
Images · premier démarrage · compose
HQbird dans Docker
Le conteneur installe HQbird avec le même installateur qu'un serveur. Firebird, l'agent fbagent et HQ Monitor s'exécutent à l'intérieur. L'agent installe lui-même le nœud de cluster lorsque l'instance rejoint un cluster. Il n'installe RCM que lorsque cette instance est désignée comme RCM du cluster.
Les images se trouvent dans le GitHub Container Registry d'IBSurgeon. Elles sont publiques : vous n'avez pas besoin de vous connecter au registre. Le tag de l'image correspond à la version du kit HQbird.
| Image | 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 |
Premier démarrage
- 1compose.yamlcopiez-le depuis le kit vers un dossier de l'hôte
- 2Mot de passe SYSDBAdans un fichier secret que vous seul pouvez lire
- 3Image, nom, secretsdéfinissez
imageethostname, retirez le#des lignessecrets: - 4docker compose up -dle conteneur installe HQbird
- 5✓ healthyFirebird et la console répondent
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
Sur un serveur à 2 cœurs, l'installation au premier démarrage prend environ 20 secondes.
Ce que vous obtenez
- Firebird :
<Docker host>:3050. - HQ Monitor :
http://<Docker host>:23050/, identifiantadmin. - L'installateur crée le mot de passe de la console. Il se trouve dans le fichier
/opt/hqbird/conf/access.propertiesà l'intérieur du conteneur. - Nom de l'agent dans HQCenter : le nom d'hôte, la date d'installation et la version de Firebird.
Travail quotidien
| Tâche | Commande |
|---|---|
| État des services | docker compose exec hqbird systemctl list-units --type=service |
| Redémarrer Firebird | docker compose exec hqbird systemctl restart firebirdFirebird 3.0 : le service firebird-superserver |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb |
| Journal sur une heure | docker compose logs --since 1h |
| Arrêter | docker compose stop : Firebird ferme les bases de données |
À l'intérieur du conteneur, la commande systemctl contrôle les services HQbird, mais ce n'est pas systemd. Elle comprend les commandes utilisées par les programmes HQbird : start, stop, restart, status, list-units et d'autres.
Variables · secrets · volumes
Paramètres et volumes
Le conteneur ne lit les paramètres qu'une seule fois, au premier démarrage : c'est l'installation. Les données, la configuration, la licence et les programmes mis à jour sont sur des volumes. Ils restent en place lorsque vous recréez le conteneur ou changez l'image.
| Paramètre | Ce qu'il fait |
|---|---|
HQBIRD_FB_PORT | Port Firebird à l'intérieur du conteneur, 3050 par défaut. HQ Monitor écoute sur 20000 + ce port. |
HQBIRD_HQM_PORT | Un autre port pour HQ Monitor. |
HQBIRD_AGENT_ID | Nom de l'agent. Par défaut, il est composé du nom d'hôte, de la date et du port. |
HQBIRD_HQM_LOGIN, secret hqmonitor_password | Identifiant et mot de passe de HQ Monitor. |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE | Demande de licence d'essai. |
secret sysdba_password | Mot de passe SYSDBA du nouveau Firebird. |
secret license | Fichier de licence. |
secret attach | Le fichier attach.json provenant de HQCenter : il connecte l'agent à votre centre. |
| Volume | Chemin | Contenu |
|---|---|---|
db | /db | Bases de données. Placez vos bases de données ici. |
backup | /backup | Sauvegardes. |
opt | /opt | Firebird, l'agent, HQ Monitor, le nœud de cluster, RCM. |
state | /var/lib/hqbird-container | Services, données de la console, journaux de l'agent, identifiant machine. |
trust | /usr/libexec/hqbird-fbagent | Démarrage de confiance des mises à jour de l'agent. |
rootwork | /var/lib/hqbird-fbagent | Dossier de travail pour les mises à jour. |
- Dossiers hôtes uniquement pour les bases de données et les sauvegardesVous pouvez remplacer les volumes
dbetbackuppar des dossiers hôtes. Attribuez-les à l'utilisateur avec l'uid 84 : c'est l'utilisateurfirebirddans l'image. Ne remplacez pas les quatre autres volumes par des dossiers hôtes. - Sauvegarde des volumesSauvegardez les six volumes ensemble.
- Ne changez pas le nom d'hôteLa licence est liée à l'identifiant machine sur le volume
stateet au nom de l'agent. Un nouveau volumestateconstitue une nouvelle installation. - Connectez-vous au centre avec un seul fichierLe secret
attachconnecte l'agent à HQCenter au premier démarrage. Vous n'avez pas besoin d'entrer dans le conteneur pour cela.
Publication des ports · pare-feu · seconde instance
Ports et plusieurs instances
Publiez chaque port avec le même numéro à l'extérieur et à l'intérieur du conteneur : 3051:3051, et non 3051:3050. L'agent et le cluster rapportent le port qu'ils voient à l'intérieur du conteneur.
| Port | Quoi | Quand c'est nécessaire |
|---|---|---|
HQBIRD_FB_PORT (3050) | Firebird | toujours |
| 20000 + port Firebird (23050) | HQ Monitor | toujours |
| port du nœud (7051) | nœud de cluster | l'instance rejoint un cluster |
| 7443, 7444 | RCM et son interface web | cet agent exécute RCM ; un par hôte |
Docker publie les ports au-delà de ufw. Nous l'avons vérifié : avec la règle ufw « uniquement le port 22 », les ports Firebird et HQ Monitor étaient ouverts depuis Internet. Utilisez un pare-feu externe, publiez le port sur une adresse de l'hôte ("10.0.0.5:23050:23050") ou ajoutez des règles à la chaîne iptables DOCKER-USER.
Seconde instance sur le même hôte
Chaque instance a besoin de son propre dossier, nom de projet, nom d'hôte et ports. Le nom de projet définit les noms des volumes. Avec le même nom, le second démarrage reprend les volumes et le conteneur du premier.
- Firebird : 3050 + N.
- HQ Monitor : 20000 + port Firebird.
- Nœud de cluster : 7051 + N.
- Une seule instance sur l'hôte peut exécuter RCM.
Les autres lignes Firebird sur le même hôte suivent les mêmes règles, chacune avec sa propre image.
| Instance 1 | Instance 2 | |
|---|---|---|
| Projet et nom d'hôte | hqbird-fb40-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| Ports | 3051, 23051, 7052 | 3052, 23052, 7053 |
- MémoireUne instance inactive prend environ 200–250 Mo. Nous l'avons vérifié : trois instances Firebird 4.0 sur un serveur avec 2 cœurs et 4 Go de mémoire, dont une sous charge.
- Firebird hors Docker sur le même hôteSi Firebird ou HQbird fonctionne déjà sur l'hôte sans Docker, sautez les ports 3050, 23050 et 7051.
HQCenter · nouvelle image · cluster
Mises à jour et cluster
Vous pouvez mettre à jour un conteneur de deux manières. Les deux conservent les données.
Depuis HQCenter
Comme sur un serveur normal : le centre met à jour l'agent, HQ Monitor, Firebird, le nœud de cluster et RCM à l'intérieur du conteneur. Les programmes mis à jour se trouvent sur un volume, ils restent donc après un redémarrage.
Avec une nouvelle image
Changez la version dans la ligne image et exécutez :
docker compose pull docker compose up -d
Au démarrage, le conteneur exécute l'installateur de la nouvelle image en mode mise à jour. Si le centre a déjà mis à jour l'agent vers une version plus récente que celle de l'image, l'installateur ne s'exécute pas : la version ne redescend pas.
Conteneur dans un cluster
Une instance dans un conteneur rejoint un cluster de la même manière qu'un serveur. L'adresse du membre est l'adresse de l'hôte Docker. Publiez les ports du cluster dans compose.yaml.
- Le port du nœud, par exemple 7051 : lorsque l'instance est membre du cluster.
- Les ports 7443 et 7444 : lorsque cet agent exécute RCM. Pour l'interface web sur 7444, définissez
operator_addr=0.0.0.0:7444dans les paramètres RCM. - Le port du nœud dans la description du cluster doit correspondre au port publié.
L'agent installe le nœud quelques minutes après l'enregistrement du cluster. D'ici là, le port du nœud ne répond pas.
Serveur cloud · NAT · pare-feu
HQbird sur un serveur cloud
Sur un serveur cloud, vous installez HQbird avec l'installateur normal : un fichier, une commande. Firebird, l'agent et la console sont inclus dans le fichier : l'installateur ne télécharge rien. Sous Linux, il récupère quelques bibliothèques du système d'exploitation (libtommath, ICU) depuis le dépôt de la distribution. S'il n'y a pas de dépôt, il affiche les commandes exactes et ne change rien.
- Aucun port entrant pour le centreL'agent se connecte à HQCenter de lui-même. Un serveur derrière NAT ou dans un réseau cloud privé apparaît dans le centre de la même manière qu'un serveur dans votre baie.
- Pare-feu du système d'exploitationL'installateur ouvre le port du nouveau Firebird et le port HQ Monitor dans firewalld ou ufw. Vous configurez les règles de pare-feu du cloud lui-même.
- Configuration requise du serveurAu moins 2 Go de mémoire, 2 cœurs et 5 Go de disque. Linux x86-64 ou Windows.
- Distributions LinuxUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS et autres avec apt, dnf, yum ou zypper.
- Cent serveurs par scriptChaque étape d'installation est disponible sous forme d'option. Vous pouvez d'abord afficher le plan d'installation : la commande ne change rien.
- Les secrets sont protégésUn secret que vous saisissez dans la console est transmis à l'agent de manière chiffrée. Les secrets sont masqués dans les rapports et dans les copies de configuration. Dans le fichier de configuration de l'agent, la clé S3 n'est pas chiffrée : limitez l'accès à ce fichier. Sur un serveur Amazon EC2, vous pouvez travailler sans clé : l'agent utilise le rôle IAM du serveur.
- Métriques dans votre GrafanaL'agent exporte les métriques Firebird et serveur au format Prometheus.
- Disque cloud sous contrôleL'agent mesure la latence de lecture et d'écriture et prévoit quand le disque sera plein. Un disque cloud lent ou presque plein est visible dans le rapport de santé.
Limites · conseils
Bon à savoir
- Docker et ufwUn port de conteneur publié est ouvert au-delà de ufw. Fermez-le avec un pare-feu externe ou publiez-le sur une seule adresse.
- Paramètres uniquement au premier démarrageLes variables et les secrets sont lus une seule fois. Vous ne pouvez pas modifier le port Firebird, le nom d'hôte et les secrets par la suite : une nouvelle installation est nécessaire. Vous modifiez les tâches et les autres paramètres de l'agent dans HQ Monitor ou depuis le centre.
- Scripts avec docker compose execDans les scripts, ajoutez l'option
-Tet</dev/null. Sans elles, la commande lit l'entrée standard et consomme le reste du script.
- Avertissements avant la connexion au centreTant que l'agent ne s'est pas connecté à HQCenter, son journal indique que les paramètres de connexion sont incomplets. C'est normal.
- Signature de l'imageLes images sont signées avec l'outil cosign. La clé publique permettant de les vérifier avec la commande
cosign verifyn'est pas encore publiée. - Où cela a été testéUbuntu 22.04, Docker avec Compose, un serveur avec 2 cœurs et 4 Go de mémoire. Un guide d'installation pas à pas pour Ubuntu est disponible en russe et en portugais.