Cette page a été traduite automatiquement. Lisez l'original en anglais. English

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.

Diagramme : les applications et le navigateur se connectent au conteneur HQbird sur l'hôte ; l'agent se connecte de lui-même à HQCenter et envoie les sauvegardes vers S3 cloud server or Docker host HQbird Firebird fbagent HQ Monitor volumes: /db · /backup · /opt ports: 3050 · 23050 cluster: 7051 · 7443 · 7444 Clients Firebird port 3050 Browser HQ Monitor 23050 HQCenter agent connects out S3 backups, HTTPS
Qui se connecte à qui. Les applications et le navigateur arrivent par les ports Firebird et HQ Monitor. L'agent se connecte de lui-même à HQCenter et à S3 : aucun port entrant n'est nécessaire pour cela.
Serveur

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.

Conteneur

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.

Stockage

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.

Plus d'informations sur la page des sauvegardes →

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.

ImageFirebirdPort 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

Premier démarrage

  1. 1compose.yamlcopiez-le depuis le kit vers un dossier de l'hôte
  2. 2Mot de passe SYSDBAdans un fichier secret que vous seul pouvez lire
  3. 3Image, nom, secretsdéfinissez image et hostname, retirez le # des lignes secrets:
  4. 4docker compose up -dle conteneur installe HQbird
  5. 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/, identifiant admin.
  • 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âcheCommande
État des servicesdocker compose exec hqbird systemctl list-units --type=service
Redémarrer Firebirddocker compose exec hqbird systemctl restart firebird
Firebird 3.0 : le service firebird-superserver
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Journal sur une heuredocker compose logs --since 1h
Arrêterdocker 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ètreCe qu'il fait
HQBIRD_FB_PORTPort Firebird à l'intérieur du conteneur, 3050 par défaut. HQ Monitor écoute sur 20000 + ce port.
HQBIRD_HQM_PORTUn autre port pour HQ Monitor.
HQBIRD_AGENT_IDNom 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_passwordIdentifiant et mot de passe de HQ Monitor.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONEDemande de licence d'essai.
secret sysdba_passwordMot de passe SYSDBA du nouveau Firebird.
secret licenseFichier de licence.
secret attachLe fichier attach.json provenant de HQCenter : il connecte l'agent à votre centre.
VolumeCheminContenu
db/dbBases de données. Placez vos bases de données ici.
backup/backupSauvegardes.
opt/optFirebird, l'agent, HQ Monitor, le nœud de cluster, RCM.
state/var/lib/hqbird-containerServices, données de la console, journaux de l'agent, identifiant machine.
trust/usr/libexec/hqbird-fbagentDémarrage de confiance des mises à jour de l'agent.
rootwork/var/lib/hqbird-fbagentDossier de travail pour les mises à jour.
  • Dossiers hôtes uniquement pour les bases de données et les sauvegardesVous pouvez remplacer les volumes db et backup par des dossiers hôtes. Attribuez-les à l'utilisateur avec l'uid 84 : c'est l'utilisateur firebird dans 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 state et au nom de l'agent. Un nouveau volume state constitue une nouvelle installation.
  • Connectez-vous au centre avec un seul fichierLe secret attach connecte 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.

PortQuoiQuand c'est nécessaire
HQBIRD_FB_PORT (3050)Firebirdtoujours
20000 + port Firebird (23050)HQ Monitortoujours
port du nœud (7051)nœud de clusterl'instance rejoint un cluster
7443, 7444RCM et son interface webcet 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 1Instance 2
Projet et nom d'hôtehqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Ports3051, 23051, 70523052, 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:7444 dans 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.

En savoir plus sur le cluster et la réplication →

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é.

En savoir plus sur l'installation et les mises à jour →

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 -T et </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 verify n'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.

← Retour à la présentation de HQbird 2027