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.

Command
docker pull ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.33

Les 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 :

Command
cosign verify --key hqbird-cosign.pub ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.33

2. Premier démarrage

  1. Copiez compose.yaml (depuis ops/docker/ de la version) dans un dossier sur l’hôte Docker.

  2. Mettez le mot de passe SYSDBA dans un fichier, lisible seulement par vous :

    Command
    mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password
  3. Dans compose.yaml, définissez image:, hostname:, et retirez le # des lignes secrets: que vous utilisez.

  4. Démarrez le conteneur :

    Command
    docker compose up -d
  5. Suivez l’installation (quelques minutes au premier démarrage) :

    Command
    docker compose logs -f

    Sur 2 vCPU l’installation prend environ 20 secondes. Elle est terminée lorsque le journal affiche [hqbird-boot] ready: firebird.service=active ... et que docker compose ps affiche healthy.

Ensuite :

  • Firebird : <docker host>:3050.
  • HQ Monitor : http://<docker host>:23050/, identifiant admin. L’installateur crée le mot de passe ; lisez-le avec docker 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 exemple hqbird-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) :

Command
chown 84:84 /srv/hqbird/db /srv/hqbird/backup

Sauvegardez 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 :

    Command
    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 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).

  1. 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 (pas localhost, pas l’adresse du conteneur) :

    Command
    echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env
    docker compose -f compose.yaml -f compose.master.yaml up -d
  2. Sur l’hôte replica :

    Command
    docker compose -f compose.yaml -f compose.replica.yaml up -d
  3. Lisez les lignes de cluster de chaque conteneur :

    Command
    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:....

  4. Ouvrez la console https://<master host>:7444. L’identifiant est rcmadmin. Sans le secret rcm_password, le mot de passe est dans un fichier ; RCM en demande un nouveau à la première connexion :

    Command
    docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password'
  5. 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 est healthy. 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 volume db, 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 :

Command
docker compose -f compose.cluster-one-host.yaml up -d

Les 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_ROLE différent écrit un avertissement dans le journal et ne change rien. Pour changer le cluster plus tard, utilisez HQ Monitor (Clusters) ou les commandes fbagent --cluster-init et fbagent --cluster-pairing dans 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_ALLOW ou votre pare-feu ; après le lien vous pouvez retirer le port de ports:.
  • 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 :

Command
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }
  1. Publiez le port du second nœud sur les deux hôtes : port de nœud + 10. Dans compose.master.yaml et compose.replica.yaml, retirez le # de la ligne "7061:7061", puis exécutez docker compose up -d avec les mêmes options -f. Faites-le avant le premier démarrage lorsque vous le pouvez.

  2. 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 :

    Command
    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/nodes affiche les id de nœud (<host name>-master, <host name>-replica).

  3. 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_port 7061. Lisez le document, ajoutez deux membres et un lien, et renvoyez-le avec sa révision :

    Command
    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.json

    Les 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=service affiche alors deux services hqclusternode dans 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 :

    Command
    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
  4. Définissez le service. host est 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> :

    Command
    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
  5. Vérifiez, puis basculez :

    Command
    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 paquet haproxy depuis 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, rejoin en 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 Monitor 20000 + le port Firebird, nœud de cluster 7051 + N (mettez le même listen_port dans 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=7451 et HQBIRD_NODE_PORT=7052 pour la deuxième, 7452 et 7053 pour 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 :

Command
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écutez fbagent --refresh-apply-launcher en 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 exec avec -T et </dev/null. Sans eux, il lit l’entrée standard et prend le reste d’un script que vous envoyez avec ssh ... bash -s.
  • Avant que l’agent soit connecté à HQCenter, son journal affiche les avertissements goafts mTLS settings are incomplete et bootstrap 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, /usr et /usr/lib ont 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-init dans le conteneur, l’agent crée le compte du système d’exploitation hqbirdrcm. Un nouveau conteneur ne l’a pas (User=hqbirdrcm: invalid userid, le conteneur est unhealthy). Les images plus récentes conservent les comptes sur le volume state. 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 router l’agent installe le paquet haproxy et le service du router, mais haproxy.service échoue. Le remplaçant de systemd dans l’image ne place pas les valeurs de $CONFIG, $PIDFILE et $EXTRAOPTS dans 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>/master et n’ajoutez pas de membre router.
  • 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 fichier usr/lib/tmpfiles.d/haproxy.conf sur le volume state. 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 :

Command
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.key

Un 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/.