HQbird 2027 dans Docker : guide de l'administrateur
Ce guide s’adresse à l’administrateur qui exécute HQbird 2027 dans Docker. Un conteneur est une instance Firebird avec tous les composants HQbird :
- Firebird (la compilation HQbird d’une ligne : 5.0, 4.0, 3.0 ou 2.5) ;
- agent HQbird (
fbagent) : sauvegardes, surveillance, tâches de maintenance, mises à jour, la connexion à HQCenter ; - HQ Monitor : la console web de l’instance ;
- nœud de cluster (
hqclusternode) et RCM (hqbirdrcm) : installés par l’agent lorsque HQCenter ajoute cette instance à un cluster, ou lorsque vous donnez au conteneur un rôle de cluster (section 7). Sans rôle et sans HQCenter, le conteneur n’exécute aucun composant de cluster.
Le conteneur installe HQbird avec le même installateur hors ligne qu’un serveur (guide d’installation Linux). L’agent met ensuite à jour Firebird, HQ Monitor, les composants du cluster et lui-même depuis HQCenter, comme sur un serveur. Vos données, la configuration, la licence, les certificats HQCenter et les programmes mis à jour sont sur des volumes : ils restent lorsque vous recréez le conteneur ou changez l’image.
Version actuelle : 2027.2.33 (2026-11-16) : Firebird 2.5.9, 3.0.15, 4.0.8 et 5.0.5, agent 3.4.0, HQ Monitor 1.57.0, RCM et nœud 2027.5.12.
Testé le 2026-11-16 sur Ubuntu 22.04.5 (2 vCPU / 4 Go), Docker 29.10.0,
Compose 5.7.1, image hqbird2027-fb40:2027.2.33 (premier test : 2026-11-11,
image 2027.2.27). Une installation pas à pas
pour Ubuntu 22.04 : hqbird2027-docker-install-fb40.ru.md
(russe), hqbird2027-docker-install-fb40.pt.md
(portugais).
Le rôle de cluster (section 7.1) et le switchover (section 7.3) ont été testés
le 2026-11-16 sur les images 5.0, 4.0, 3.0 et 2.5, avec les deux « hôtes »
comme deux adresses d’une VM, et sur deux hôtes Docker distincts (deux droplets, l’image
4.0 2027.2.33). Le 2026-11-17, le reste a été testé sur deux hôtes Docker
avec l’image 5.0 2027.2.33 : un cluster fait à la main dans des conteneurs 2027.2.32
et déplacé vers la nouvelle image (les deux conteneurs healthy en 35
secondes), HQBIRD_RCM_ALLOW, les pages Services de la console RCM et
le failover automatique. Les routers (HAProxy) ne démarrent pas dans les images jusqu’à
2027.2.33 (section 9) ; l’image suivante contient le correctif.
1. Images
| Image | Firebird | Port par défaut |
|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50:<version> |
5.0 | 3050 |
ghcr.io/ibsurgeon/hqbird2027-fb40:<version> |
4.0 | 3050 |
ghcr.io/ibsurgeon/hqbird2027-fb30:<version> |
3.0 | 3050 |
ghcr.io/ibsurgeon/hqbird2027-fb25:<version> |
2.5 | 3050 |
Les images sont dans le GitHub Container Registry d’IBSurgeon
(https://github.com/orgs/IBSurgeon/packages). Elles sont publiques : vous n’avez
pas besoin de vous connecter. <version> est la version de setup HQbird, par exemple
2027.2.33. L’étiquette 2027.2 est l’image 2027.2.x la plus récente.
docker pull ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.33Les images sont signées avec cosign. La clé publique hqbird-cosign.pub n’est
pas encore publiée (2026-11-16). Les images 2027.2.33 sont signées. Lorsque vous avez la clé, vérifiez une image
avant de l’utiliser :
cosign verify --key hqbird-cosign.pub ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.332. Premier démarrage
-
Copiez
compose.yaml(depuisops/docker/de la version) dans un dossier sur l’hôte Docker. -
Mettez le mot de passe SYSDBA dans un fichier, lisible seulement par vous :
mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password -
Dans
compose.yaml, définissezimage:,hostname:, et retirez le#des lignessecrets:que vous utilisez. -
Démarrez le conteneur :
docker compose up -d -
Suivez l’installation (quelques minutes au premier démarrage) :
docker compose logs -fSur 2 vCPU l’installation prend environ 20 secondes. Elle est terminée lorsque le journal affiche
[hqbird-boot] ready: firebird.service=active ...et quedocker compose psaffichehealthy.
Ensuite :
- Firebird :
<docker host>:3050. - HQ Monitor :
http://<docker host>:23050/, identifiantadmin. L’installateur crée le mot de passe ; lisez-le avecdocker compose exec hqbird cat /opt/hqbird/conf/access.properties. - L’id de l’agent dans HQCenter : le nom d’hôte + la date d’installation (YYMMDD) +
-fbNN, par exemplehqbird-fb40-3051261111-fb40.
Conservez le nom d’hôte. L’identité de licence de l’instance est le
machine-id du volume state et l’id de l’agent. Un nouveau volume state est
une nouvelle installation.
3. Réglages
Les réglages sont lus au premier démarrage seulement (l’installation).
| Réglage | Ce qu’il fait |
|---|---|
HQBIRD_FB_PORT |
Port Firebird dans le conteneur (défaut 3050). HQ Monitor utilise 20000 + ce port |
HQBIRD_HQM_PORT |
un autre port HQ Monitor |
HQBIRD_AGENT_ID |
l’id de l’agent (défaut : formé à partir du nom d’hôte, de la date et du port) |
HQBIRD_HQM_LOGIN + secret hqmonitor_password |
l’identifiant HQ Monitor |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE |
demander une licence d’essai (vous acceptez la politique de confidentialité) |
HQBIRD_DEBUG=1 |
installer les fichiers de débogage de Firebird |
secret sysdba_password |
le mot de passe SYSDBA d’un nouveau Firebird |
secret license |
un fichier de licence |
secret attach |
attach.json de HQCenter : connecter l’agent à votre HQCenter |
HQBIRD_CLUSTER_ROLE |
master ou replica : un cluster sans HQCenter (section 7). Vide : pas de cluster |
HQBIRD_CLUSTER_ADDRESS |
master, obligatoire : l’adresse ou le nom DNS de l’hôte Docker, comme le replica et votre navigateur l’atteignent. Une liste avec des virgules ; le premier va dans le RCM URL |
HQBIRD_CLUSTER_ID |
master : l’id du cluster (défaut : le nom d’hôte) |
secret rcm_password |
master : le mot de passe de l’identifiant RCM rcmadmin (défaut : un mot de passe généré) |
HQBIRD_RCM_ALLOW |
replica : seuls ces RCM peuvent inviter le conteneur (IP, CIDR, nom d’hôte ; défaut : n’importe lequel). Écrivez l’adresse de l’hôte Docker du master : le replica voit cette adresse. Sur un seul hôte Docker le replica voit la passerelle de son réseau Docker |
HQBIRD_PAIRING_PORT, HQBIRD_NODE_PORT |
le slot du cluster : port d’appairage 7450-7459 et port de nœud = port d’appairage - 399 (défaut 7450 et 7051) |
4. Volumes
| Volume | Chemin | Contenu |
|---|---|---|
opt |
/opt |
Firebird, l’agent, HQ Monitor, nœud de cluster, RCM |
state |
/var/lib/hqbird-container |
units, sudoers, données de HQ Monitor, journaux de l’agent, machine-id, état du setup, les comptes du système d’exploitation créés à l’exécution (l’utilisateur de service RCM) |
trust |
/usr/libexec/hqbird-fbagent |
le lanceur de mises à jour de l’agent et la confiance |
rootwork |
/var/lib/hqbird-fbagent |
le dossier de travail du lanceur de mises à jour |
db |
/db |
bases de données (mettez-y vos bases de données) |
backup |
/backup |
sauvegardes |
Ne montez pas de dossiers de l’hôte sur opt, state, trust et rootwork. Vous pouvez
utiliser des dossiers de l’hôte pour db et backup ; donnez-les à l’uid 84 (l’utilisateur firebird
de l’image) :
chown 84:84 /srv/hqbird/db /srv/hqbird/backupSauvegardez les six volumes ensemble.
5. 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 firebird (Firebird 3.0 : firebird-superserver) |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/<port>:/db/my.fdb |
| Journaux | docker compose logs --since 1h |
| Arrêter (Firebird ferme les bases de données) | docker compose stop |
Dans le conteneur, systemctl contrôle les services HQbird. Ce n’est pas
systemd : il prend en charge les commandes que les programmes HQbird utilisent (start, stop,
restart, status, is-active, enable, disable, show,
list-units, daemon-reload).
6. Mises à jour
Il y a deux façons de mettre à jour. Les deux conservent vos données.
-
Depuis HQCenter (comme sur un serveur) : HQCenter met à jour l’agent, HQ Monitor, Firebird, le nœud de cluster et RCM dans le conteneur.
-
Nouvelle image : changez
image:pour la nouvelle version, puis :docker compose pull && docker compose up -dAu démarrage, le conteneur exécute l’installateur de la nouvelle image en mode mise à jour. Si HQCenter a déjà mis à jour l’agent vers une version plus récente que celle de l’image, l’installateur n’est pas exécuté (pas de retour arrière) ; le journal le dit.
Un nouveau conteneur (une nouvelle image, ou docker compose down et up -d sans
-v) conserve le cluster : le rôle, l’id du cluster, RCM, les nœuds et le
lien vers l’autre hôte sont sur les volumes. Les réglages de cluster du
fichier compose ne sont pas relus. Les images jusqu’à 2027.2.32 ont deux défauts
ici : voir la section 9.
7. Cluster
Il y a deux façons de faire un cluster. Ne les mélangez pas dans un même conteneur.
7.1. Sans HQCenter : deux conteneurs avec un rôle
Un conteneur est le master et exécute le gestionnaire de cluster (RCM) avec sa
console. L’autre est un replica. Le rôle est un réglage du premier
démarrage : HQBIRD_CLUSTER_ROLE. Sans lui, le conteneur n’exécute pas de RCM, pas de
nœud de cluster, et n’ouvre aucun port d’appairage. Le rôle exige l’image 2027.2.33 ou
plus récente.
Deux hôtes Docker. Donnez aux deux conteneurs des noms d’hôte différents
(HQBIRD_HOSTNAME dans .env, ou hostname:) : avec le même nom d’hôte
les deux agents ont le même id, et RCM refuse le replica
(duplicate). Copiez compose.master.yaml sur l’hôte master et
compose.replica.yaml sur l’hôte replica, à côté de compose.yaml
(ops/docker/ de la version).
-
Sur l’hôte master, mettez l’adresse de cet hôte Docker dans
.env, telle que l’hôte replica et votre navigateur l’atteignent (paslocalhost, pas l’adresse du conteneur) :echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env docker compose -f compose.yaml -f compose.master.yaml up -d -
Sur l’hôte replica :
docker compose -f compose.yaml -f compose.replica.yaml up -d -
Lisez les lignes de cluster de chaque conteneur :
docker compose logs | grep -E 'cluster:|CA hash|Password'Le master affiche l’adresse de la console et le
CA hash:[hqbird-boot] cluster: role=master id=... console=https://203.0.113.10:7444 login=rcmadmin. Le replica affiche son port d’appairage et l’empreinte :[hqbird-boot] cluster: role=replica pairing port 7450: open until ..., fingerprint sha256:.... -
Ouvrez la console
https://<master host>:7444. L’identifiant estrcmadmin. Sans le secretrcm_password, le mot de passe est dans un fichier ; RCM en demande un nouveau à la première connexion :docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password' -
Dans Settings → Link hosts écrivez deux lignes : l’adresse que vous avez donnée dans
HQBIRD_CLUSTER_ADDRESS(le master) et l’adresse de l’hôte Docker du replica. Vous n’écrivez pas de port : RCM lit les ports d’appairage 7450-7459. Le port d’appairage répond environ 30 secondes après que le conteneur esthealthy. La fenêtre Initialize propose le dossier/databases/replica/..., qui est en dehors des volumes : changez-le. Cette fenêtre fait environ 1000 px de haut et ne défile pas : réduisez le zoom de la page si vous n’en voyez pas les boutons. Testé dans le navigateur le 2026-11-16. Comparez l’empreinte du replica avec celle de son journal. Laissez RCM URL vide. Puis continuez avec l’étape 4 du guide du cluster Linux (dossier de base de données, enrôlement, initialiser le replica). Pour le dossier de base de données du replica, utilisez un dossier du volumedb, par exemple/db/replica. Testé : une ligne écrite sur le master était sur le replica en 30 secondes.
Pour omettre les options -f, mettez
COMPOSE_FILE=compose.yaml:compose.master.yaml (ou ...replica.yaml) dans
.env.
Un hôte Docker. compose.cluster-one-host.yaml est un fichier complet
avec les deux conteneurs :
docker compose -f compose.cluster-one-host.yaml up -dLes conteneurs s’atteignent par nom sur le réseau du projet, donc
les ports du cluster ne sont pas publiés. Dans Link hosts écrivez
hqbird-master et hqbird-replica. Le Firebird du master est sur le port
3050, celui du replica sur 3051 ; la console est https://<docker host>:7444.
Règles :
- Le rôle et ses réglages sont lus au premier démarrage seulement. Plus tard, un
HQBIRD_CLUSTER_ROLEdifférent écrit un avertissement dans le journal et ne change rien. Pour changer le cluster plus tard, utilisez HQ Monitor (Clusters) ou les commandesfbagent --cluster-initetfbagent --cluster-pairingdans le conteneur. - Un réglage incorrect (un rôle inconnu, un master sans
HQBIRD_CLUSTER_ADDRESS, un réglage de l’autre rôle) arrête le démarrage avant toute installation. Le journal dit quoi écrire ([hqbird-boot] error: ...) ; Docker redémarre le conteneur et le journal répète la ligne jusqu’à ce que vous corrigiez le réglage. - La fenêtre d’appairage d’un replica reste ouverte 24 heures. Un redémarrage d’un
conteneur qui n’est encore dans aucun cluster l’ouvre de nouveau. Pour fermer le
port d’appairage vers les autres réseaux, utilisez
HQBIRD_RCM_ALLOWou votre pare-feu ; après le lien vous pouvez retirer le port deports:. - Pour un switchover (un service RCM), chaque hôte a besoin d’un second nœud et de son port publié : voir la section 7.3.
7.2. Avec HQCenter
HQCenter ajoute l’instance à un cluster comme il ajoute un serveur. Ne définissez pas
HQBIRD_CLUSTER_ROLE. Dans HQCenter, donnez l’adresse de l’hôte Docker
comme adresse du membre. Dans compose.yaml, publiez les ports des
composants du cluster :
| Composant | Port | Publier lorsque |
|---|---|---|
| nœud de cluster | le listen_port du nœud (par exemple 7051) |
l’instance est membre du cluster |
| RCM | 7443 | HQCenter fait de cet agent le RCM |
| console opérateur RCM | 7444 | comme ci-dessus ; mettez operator_addr à 0.0.0.0:7444 dans les réglages RCM |
L’agent installe le nœud (et RCM) quelques minutes après l’enregistrement du cluster.
Jusque-là le port du nœud ne répond pas.
Dans HQCenter, mettez le listen_port du nœud au port publié. Un replica attend que l’agent RCM envoie la CA du cluster.
Testé le 2026-11-16 sans rôle : les agents ont installé les nœuds et RCM,
et tous les membres étaient de nouveau running après docker compose down et
up -d.
7.3. Switchover entre les deux conteneurs
Un service RCM déplace le rôle master d’une base de données d’un hôte à l’autre. Pour un service, chaque hôte a besoin de deux nœuds : un nœud master et un nœud replica. Link hosts donne à chaque hôte un nœud, donc vous ajoutez vous-même les seconds nœuds. Testé le 2026-11-16 sur la paire de la section 7.1 : le switchover a pris 25 secondes, l’ancien master est devenu un replica en lecture seule, et une ligne écrite sur le nouveau master s’y trouvait 15 secondes plus tard.
Les étapes utilisent l’API opérateur RCM sur le port de la console. curl demande
le mot de passe de rcmadmin ; -k saute la vérification du certificat propre
du cluster :
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }-
Publiez le port du second nœud sur les deux hôtes : port de nœud + 10. Dans
compose.master.yamletcompose.replica.yaml, retirez le#de la ligne"7061:7061", puis exécutezdocker compose up -davec les mêmes options-f. Faites-le avant le premier démarrage lorsque vous le pouvez. -
Donnez à chaque nœud l’adresse de son hôte Docker. RCM donne cette adresse et le port Firebird aux applications ; sans elle elles obtiennent l’adresse du conteneur :
api -X PUT $RCM/v1/nodes/<master node id>/config -d '{"advertise_addr":"203.0.113.10"}' api -X PUT $RCM/v1/nodes/<replica node id>/config -d '{"advertise_addr":"203.0.113.20"}'api $RCM/v1/nodesaffiche les id de nœud (<host name>-master,<host name>-replica). -
Ajoutez les seconds nœuds au document du cluster : un nœud master sur l’hôte replica et son nœud replica sur l’hôte master, tous deux avec
listen_port7061. Lisez le document, ajoutez deux membres et un lien, et renvoyez-le avec sa révision :api $RCM/v1/admin/clusters/<cluster id> > cluster.json # note "revision" # add to "members": # {"member_id":"<host B>-master","agent_id":"<agent id of host B>","role":"master","addresses":["203.0.113.20"],"listen_port":7061} # {"member_id":"<host A>-replica","agent_id":"<agent id of host A>","role":"replica","addresses":["203.0.113.10"],"listen_port":7061} # add to "links": {"from":"<host B>-master","to":"<host A>-replica"} api -X POST $RCM/v1/admin/clusters/<cluster id>/validate --data-binary @cluster.json api -X PUT -H 'If-Match: <revision>' $RCM/v1/admin/clusters/<cluster id> --data-binary @cluster.jsonLes agents installent alors les deux services de nœud (30 secondes dans le test sur deux hôtes ; cela peut prendre quelques minutes).
docker compose exec hqbird systemctl list-units --type=serviceaffiche alors deux serviceshqclusternodedans chaque conteneur.Donnez ensuite aux deux nœuds replica un dossier de base de données sur le volume
db. Sans lui, un switchover en retour ou un failover s’arrête après le point de non-retour, et le service passe àfailed:for n in <host A>-replica <host B>-replica; do api -X POST $RCM/v1/nodes/$n/databases/root/prepare -d '{"root":"/db/replica"}' api -X PUT $RCM/v1/nodes/$n/config -d '{"databases":{"root":"/db/replica"}}' done -
Définissez le service.
hostest l’id d’agent de l’hôte. Le chemin sur le second hôte est le chemin du fichier du replica :<database folder of the replica>/<master member id>/<file>:cat > service.json <<'J' {"alias":"shop","router_port":3051,"members":[ {"host":"<agent id of host A>","master_node":"<host A>-master","replica_node":"<host A>-replica","path":"/db/shop.fdb","priority":100}, {"host":"<agent id of host B>","master_node":"<host B>-master","replica_node":"<host B>-replica","path":"/db/replica/<host A>-master/shop.fdb","priority":50}]} J api -X PUT "$RCM/v1/services/shop?check=1" --data-binary @service.json # a check, nothing is stored api -X PUT $RCM/v1/services/shop --data-binary @service.json -
Vérifiez, puis basculez :
api $RCM/v1/services/shop/master # the master now, the replicas, problems api -X POST $RCM/v1/services/shop/switchover/check -d '{}' api -X POST $RCM/v1/services/shop/switchover -d '{}' # gives "operation_id" api $RCM/v1/operations/<operation id>
Après le switchover, .../services/shop/master donne l’adresse de
l’autre hôte Docker et son port Firebird. Les applications doivent se connecter à
cette adresse. Un switchover a besoin d’un replica qui est IN_SYNC : il l’est, après
la première écriture sur le master (35 secondes dans le test).
Routers et failover automatique. Un router (HAProxy) donne aux applications une adresse qui suit le master. Dans les images jusqu’à 2027.2.33 le router ne démarre pas (section 9) ; l’image suivante contient le correctif. Le failover automatique a besoin d’un router comme témoin. Testé le 2026-11-17 en laboratoire, sur 2027.2.33 avec un contournement et sur une image de test avec le correctif :
-
Un router est un membre du cluster avec le rôle
router. L’agent installe le paquethaproxydepuis le dépôt Debian, aussi dans chaque nouveau conteneur : le conteneur a besoin d’accéder au dépôt. Publiez le port du router (3051 dans l’exemple). -
Avec un router sur l’hôte RCM seulement, RCM a déplacé le master de lui-même 84 secondes après l’arrêt du conteneur de l’autre hôte ; l’opération a pris 10 secondes. Lorsque cet hôte est revenu,
rejoinen a de nouveau fait le replica. -
Avec un router sur chaque hôte le failover automatique ne démarre pas : plus de la moitié des routers doivent rapporter, et l’un des deux est sur l’hôte perdu.
-
Le RCM s’exécute dans le conteneur master. Lorsque cet hôte est perdu, le RCM est perdu aussi, et rien ne déplace le master de lui-même.
8. Ports, pare-feu, deuxième instance
Publiez chaque port avec le même numéro à l’extérieur et à l’intérieur du conteneur
(3051:3051, pas 3051:3050). L’agent et le cluster indiquent le port
qu’ils voient dans le conteneur.
| Port | Quoi | Nécessaire |
|---|---|---|
HQBIRD_FB_PORT (3050) |
Firebird | toujours |
| 20000 + port Firebird (23050) | HQ Monitor | toujours |
listen_port du nœud (7051) |
nœud de cluster | membre du cluster |
| port de nœud + 10 (7061) | le second nœud de l’hôte | un service avec switchover (section 7.3) |
| 7443, 7444 | RCM, console opérateur RCM | cet agent est le RCM (un par hôte) |
| port d’appairage (7450) | le port d’appairage de l’agent | un replica avec un rôle, jusqu’à ce qu’il soit lié |
L’agent se connecte à HQCenter de lui-même (sortant) ; il n’a besoin d’aucun port entrant.
Docker publie des ports en dehors d’ufw. Testé : avec ufw n’autorisant que le port 22,
les ports Firebird et HQ Monitor étaient ouverts depuis internet. Utilisez un
pare-feu externe, publiez sur une adresse d’hôte ("10.0.0.5:23050:23050"),
ou ajoutez des règles à la chaîne iptables DOCKER-USER.
Une deuxième instance sur un hôte a besoin de son propre dossier, du name: du projet,
hostname, HQBIRD_FB_PORT et des ports. Le nom du projet forme les noms des
volumes (<name>_opt, …) : avec le même nom, le second démarrage prend les
volumes et le conteneur du premier.
| Instance 1 | Instance 2 | |
|---|---|---|
name:, hostname: |
hqbird-fb40-3051 |
hqbird-fb40-3052 |
HQBIRD_FB_PORT |
3051 | 3052 |
ports: |
3051, 23051, 7052 | 3052, 23052, 7053 |
Règles pour N instances sur une IP externe :
- Firebird
3050 + N, HQ Monitor20000 +le port Firebird, nœud de cluster7051 + N(mettez le mêmelisten_portdans HQCenter). Omettez 3050, 23050 et 7051 lorsque l’hôte exécute déjà un Firebird ou HQbird en dehors de Docker. - Une seule instance par hôte peut être le RCM (7443, 7444).
- Avec un rôle de cluster (section 7.1), chaque instance d’un hôte a besoin de son propre
slot :
HQBIRD_PAIRING_PORT=7451etHQBIRD_NODE_PORT=7052pour la deuxième,7452et7053pour la troisième. - Une instance utilise environ 200-250 Mo de mémoire sans charge. Testé : trois instances FB 4.0 sur 2 vCPU / 4 Go, une avec de la charge.
- Les autres lignes Firebird sur le même hôte suivent les mêmes règles avec leur
propre image (
hqbird2027-fb50, …) et leurs noms (hqbird-fb50-3054).
Ajoutez une instance (ici la troisième : 3053, 23053, 7054) à partir du
compose.yaml de la première. Remplacer 3051 change aussi name:, hostname:,
HQBIRD_FB_PORT et le port HQ Monitor :
sudo ss -ltnp | grep -E ':(3053|23053|7054)\b' # must print nothing
sudo mkdir -p /srv/hqbird-fb40-3053/secrets
cd /srv/hqbird-fb40-3053
sudo sh -c 'openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password'
sudo sed -e 's/3051/3053/g' -e 's/7052/7054/g' /srv/hqbird-fb40-3051/compose.yaml | sudo tee compose.yaml >/dev/null
sudo docker compose config | grep -E '^name:|hostname:|HQBIRD_FB_PORT|published:'
sudo docker compose up -d
sudo docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'9. Problèmes connus
- Après avoir connecté l’agent à HQCenter avec
fbagent --enrollà la main, exécutezfbagent --refresh-apply-launcheren tant que root, ou l’auto-mise à jour de l’agent échoue avec “no goafts CA is pinned”. - Dans les scripts, exécutez
docker compose execavec-Tet</dev/null. Sans eux, il lit l’entrée standard et prend le reste d’un script que vous envoyez avecssh ... bash -s. - Avant que l’agent soit connecté à HQCenter, son journal affiche les avertissements
goafts mTLS settings are incompleteetbootstrap CA not found. C’est normal. - Le conteneur donne
/opt/hqbirdà root après chaque installation (l’auto-mise à jour de l’agent en a besoin). L’agent écrit un avertissement : il ne peut pas mettre à jour/opt/hqbird/version.json; vous pouvez l’ignorer. - Images jusqu’à 2027.2.32 : dossiers ouverts en écriture. Dans ces images
/etc,/usret/usr/libont le mode 0777, et certains fichiers du conteneur sont accessibles en écriture à tous les comptes. N’importe quel compte du conteneur peut changer ce que root démarre. L’agent refuse aussi un tel dossier (root trust directory: /usr is writable by group or others) : l’installateur en mode mise à jour échoue alors dans un nouveau conteneur, et le conteneur redémarre sans cesse. Utilisez l’image 2027.2.33 ou plus récente. Ne donnez pas d’accès shell dans le conteneur d’une image plus ancienne à des utilisateurs auxquels vous ne faites pas confiance. - Images jusqu’à 2027.2.32 : un RCM fait à la main ne démarre pas dans un nouveau
conteneur. Lorsque vous créez RCM avec
fbagent --cluster-initdans le conteneur, l’agent crée le compte du système d’exploitationhqbirdrcm. Un nouveau conteneur ne l’a pas (User=hqbirdrcm: invalid userid, le conteneur estunhealthy). Les images plus récentes conservent les comptes sur le volumestate. Un cluster fait par HQCenter n’est pas concerné. - Images jusqu’à 2027.2.33 : un router (HAProxy) ne démarre pas. Pour un
membre du cluster avec le rôle
routerl’agent installe le paquethaproxyet le service du router, maishaproxy.serviceéchoue. Le remplaçant de systemd dans l’image ne place pas les valeurs de$CONFIG,$PIDFILEet$EXTRAOPTSdans la ligne de commande et ne lit aucun fichier drop-in, et rien ne crée le dossier/run/haproxy. L’image suivante contient le correctif. Jusque-là, donnez aux applications l’adresse de.../services/<alias>/masteret n’ajoutez pas de membrerouter. - Image 2027.2.33 : un nouveau conteneur ne démarre pas après l’ajout d’un router. Le journal contient
chown: invalid user: 'haproxy', et Docker redémarre le conteneur sans cesse. Pour le démarrer, supprimez le fichierusr/lib/tmpfiles.d/haproxy.confsur le volumestate. L’image suivante contient le correctif.
10. Construire les images
Pour l’équipe de la version. Sur un hôte Windows avec les fichiers de la version dans
dist\releases, connectez-vous à GHCR avec un jeton qui a write:packages,
puis construisez, envoyez et signez :
Get-Content token.txt | docker login ghcr.io -u <GitHub user> --password-stdin
.\ops\docker\Build-HqbirdImage.ps1 -Line 50 -SetupVersion 2027.2.33 -Registry ghcr.io/ibsurgeon -Tag 2027.2 -Push -CosignKey cosign.keyUn nouveau paquet (le premier envoi d’une ligne) est privé. Dans les réglages du paquet de l’organisation IBSurgeon, mettez sa visibilité sur publique.
-ContextOnly prépare seulement le dossier de construction
(dist\hqbird2027-docker\fbNN-<version>) et affiche la commande docker build
à exécuter sur un hôte Docker Linux.
La construction s’arrête lorsqu’un dossier ou un fichier de l’image sous /etc ou /usr
est accessible en écriture à tous les comptes (le dossier de construction vient de Windows, où les
modes sont perdus). Les tests des scripts du conteneur, des réglages du cluster
et des fichiers compose : go test ./ops/docker/.