Este guia é para o administrador que executa o HQbird 2027 no Docker. Um contêiner é uma instância do Firebird com todos os componentes do HQbird:

  • Firebird (a compilação do HQbird de uma linha: 5.0, 4.0, 3.0 ou 2.5);
  • agente HQbird (fbagent): cópias de segurança, monitoramento, tarefas de manutenção, atualizações, a conexão com o HQCenter;
  • HQ Monitor: o console web da instância;
  • nó do cluster (hqclusternode) e RCM (hqbirdrcm): o agente os instala quando o HQCenter adiciona esta instância a um cluster, ou quando você dá ao contêiner uma função de cluster (seção 7). Sem uma função e sem o HQCenter, o contêiner não executa nenhum componente de cluster.

O contêiner instala o HQbird com o mesmo instalador offline de um servidor (guia de instalação no Linux). O agente então atualiza o Firebird, o HQ Monitor, os componentes do cluster e a si mesmo a partir do HQCenter, como em um servidor. Os seus dados, a configuração, a licença, os certificados do HQCenter e os programas atualizados ficam em volumes: eles permanecem quando você cria o contêiner de novo ou troca a imagem.

Versão atual: 2027.2.33 (2026-11-16): Firebird 2.5.9, 3.0.15, 4.0.8 e 5.0.5, agente 3.4.0, HQ Monitor 1.57.0, RCM e nó 2027.5.12.

Testado em 2026-11-16 no Ubuntu 22.04.5 (2 vCPU / 4 GB), Docker 29.10.0, Compose 5.7.1, imagem hqbird2027-fb40:2027.2.33 (primeiro teste: 2026-11-11, imagem 2027.2.27). Uma instalação passo a passo para o Ubuntu 22.04: hqbird2027-docker-install-fb40.ru.md (russo), hqbird2027-docker-install-fb40.pt.md (português).

A função de cluster (seção 7.1) e o switchover (seção 7.3) foram testados em 2026-11-16 nas imagens 5.0, 4.0, 3.0 e 2.5, com os dois “hosts” como dois endereços de uma VM, e em dois hosts Docker separados (dois droplets, a imagem 4.0 2027.2.33). Em 2026-11-17 o restante foi testado em dois hosts Docker com a imagem 5.0 2027.2.33: um cluster feito à mão em contêineres 2027.2.32 e transferido para a imagem nova (os dois contêineres healthy em 35 segundos), HQBIRD_RCM_ALLOW, as páginas Services do console do RCM e o failover automático. Os routers (HAProxy) não iniciam nas imagens até 2027.2.33 inclusive (seção 9); a imagem seguinte traz a correção.

1. Imagens

Imagem Firebird Porta padrão
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

As imagens estão no GitHub Container Registry da IBSurgeon (https://github.com/orgs/IBSurgeon/packages). Elas são públicas: você não precisa fazer login. <version> é a versão de instalação do HQbird, por exemplo 2027.2.33. A tag 2027.2 é a imagem 2027.2.x mais nova.

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

As imagens são assinadas com cosign. A chave pública hqbird-cosign.pub ainda não foi publicada (2026-11-16). As imagens 2027.2.33 estão assinadas. Quando você tiver a chave, verifique uma imagem antes de usá-la:

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

2. Primeira inicialização

  1. Copie compose.yaml (de ops/docker/ da versão) para uma pasta no host Docker.

  2. Grave a senha do SYSDBA em um arquivo, legível só por você:

    Command
    mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password
  3. Em compose.yaml, defina image:, hostname: e retire o # das linhas secrets: que você usa.

  4. Inicie o contêiner:

    Command
    docker compose up -d
  5. Acompanhe a instalação (alguns minutos na primeira inicialização):

    Command
    docker compose logs -f

    Em 2 vCPU a instalação leva cerca de 20 segundos. Ela termina quando o log mostra [hqbird-boot] ready: firebird.service=active ... e docker compose ps mostra healthy.

Em seguida:

  • Firebird: <docker host>:3050.
  • HQ Monitor: http://<docker host>:23050/, login admin. O instalador cria a senha; leia-a com docker compose exec hqbird cat /opt/hqbird/conf/access.properties.
  • O id do agente no HQCenter: o hostname + a data de instalação (YYMMDD) + -fbNN, por exemplo hqbird-fb40-3051261111-fb40.

Mantenha o hostname. A identidade da licença da instância é o machine-id no volume state e o id do agente. Um volume state novo é uma instalação nova.

3. Configurações

As configurações são lidas só na primeira inicialização (a instalação).

Configuração O que faz
HQBIRD_FB_PORT Porta do Firebird dentro do contêiner (padrão 3050). O HQ Monitor usa 20000 + esta porta
HQBIRD_HQM_PORT outra porta do HQ Monitor
HQBIRD_AGENT_ID o id do agente (padrão: formado a partir do nome do host, da data e da porta)
HQBIRD_HQM_LOGIN + segredo hqmonitor_password o login do HQ Monitor
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE pedir uma licença de avaliação (você aceita a política de privacidade)
HQBIRD_DEBUG=1 instalar os arquivos de depuração do Firebird
segredo sysdba_password a senha SYSDBA de um Firebird novo
segredo license um arquivo de licença
segredo attach attach.json do HQCenter: conecta o agente ao seu HQCenter
HQBIRD_CLUSTER_ROLE master ou replica: um cluster sem HQCenter (seção 7). Vazio: sem cluster
HQBIRD_CLUSTER_ADDRESS master, obrigatório: o endereço ou o nome DNS do host Docker, como a replica e o seu navegador o alcançam. Uma lista separada por vírgulas; o primeiro entra na URL do RCM
HQBIRD_CLUSTER_ID master: o id do cluster (padrão: o nome do host)
segredo rcm_password master: a senha do login do RCM rcmadmin (padrão: uma gerada)
HQBIRD_RCM_ALLOW replica: só estes RCM podem convidar o contêiner (IP, CIDR, nome de host; padrão: qualquer). Escreva o endereço do host Docker do master: a replica vê esse endereço. Em um único host Docker a replica vê o gateway da rede Docker dela
HQBIRD_PAIRING_PORT, HQBIRD_NODE_PORT o slot do cluster: porta de pareamento 7450-7459 e porta do nó = porta de pareamento - 399 (padrão 7450 e 7051)

4. Volumes

Volume Caminho Conteúdo
opt /opt Firebird, o agente, HQ Monitor, nó do cluster, RCM
state /var/lib/hqbird-container unidades, sudoers, dados do HQ Monitor, logs do agente, machine-id, estado da instalação, as contas do sistema operacional criadas na execução (o usuário de serviço do RCM)
trust /usr/libexec/hqbird-fbagent o lançador de atualização do agente e a confiança
rootwork /var/lib/hqbird-fbagent a pasta de trabalho do lançador de atualização
db /db bancos de dados (coloque os seus bancos aqui)
backup /backup cópias de segurança

Não monte pastas do host em opt, state, trust e rootwork. Você pode usar pastas do host para db e backup; entregue-as ao uid 84 (o usuário firebird da imagem):

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

Faça a cópia de segurança dos seis volumes em conjunto.

5. Trabalho do dia a dia

Tarefa Comando
Estado dos serviços docker compose exec hqbird systemctl list-units --type=service
Reiniciar o 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
Logs docker compose logs --since 1h
Parar (o Firebird fecha os bancos) docker compose stop

Dentro do contêiner, systemctl controla os serviços do HQbird. Não é o systemd: ele aceita os comandos que os programas do HQbird usam (start, stop, restart, status, is-active, enable, disable, show, list-units, daemon-reload).

6. Atualizações

Há duas formas de atualizar. As duas preservam os seus dados.

  • Pelo HQCenter (como em um servidor): o HQCenter atualiza o agente, o HQ Monitor, o Firebird, o nó do cluster e o RCM dentro do contêiner.

  • Imagem nova: troque image: para a versão nova e depois:

    Command
    docker compose pull && docker compose up -d

    Na inicialização, o contêiner executa o instalador da imagem nova em modo de atualização. Se o HQCenter já atualizou o agente para uma versão mais nova do que a da imagem, o instalador não é executado (sem rebaixamento); o log informa isso.

Um contêiner novo (uma imagem nova, ou docker compose down e up -d sem -v) mantém o cluster: a função, o id do cluster, o RCM, os nós e o vínculo com o outro host estão nos volumes. As configurações de cluster no arquivo compose não são lidas de novo. As imagens até 2027.2.32 têm dois defeitos aqui: veja a seção 9.

7. Cluster

Há duas formas de fazer um cluster. Não as misture em um mesmo contêiner.

7.1. Sem HQCenter: dois contêineres com uma função

Um contêiner é o master e executa o gerenciador do cluster (RCM) com o console dele. O outro é uma replica. A função é uma configuração da primeira inicialização: HQBIRD_CLUSTER_ROLE. Sem ela o contêiner não executa RCM, não executa nó de cluster e não abre porta de pareamento. A função exige a imagem 2027.2.33 ou mais nova.

Dois hosts Docker. Dê aos dois contêineres nomes de host diferentes (HQBIRD_HOSTNAME em .env, ou hostname:): com o mesmo nome de host os dois agentes têm o mesmo id, e o RCM recusa a replica (duplicate). Copie compose.master.yaml para o host master e compose.replica.yaml para o host replica, ao lado de compose.yaml (ops/docker/ da versão).

  1. No host master, coloque o endereço desse host Docker em .env, como o host replica e o seu navegador o alcançam (não localhost, não o endereço do contêiner):

    Command
    echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env
    docker compose -f compose.yaml -f compose.master.yaml up -d
  2. No host replica:

    Command
    docker compose -f compose.yaml -f compose.replica.yaml up -d
  3. Leia as linhas de cluster de cada contêiner:

    Command
    docker compose logs | grep -E 'cluster:|CA hash|Password'

    O master mostra o endereço do console e o CA hash: [hqbird-boot] cluster: role=master id=... console=https://203.0.113.10:7444 login=rcmadmin. A replica mostra a porta de pareamento e a impressão digital: [hqbird-boot] cluster: role=replica pairing port 7450: open until ..., fingerprint sha256:....

  4. Abra o console https://<master host>:7444. O login é rcmadmin. Sem o segredo rcm_password a senha está em um arquivo; o RCM pede uma nova no primeiro login:

    Command
    docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password'
  5. Em Settings → Link hosts escreva duas linhas: o endereço que você informou em HQBIRD_CLUSTER_ADDRESS (o master) e o endereço do host Docker da replica. Você não escreve uma porta: o RCM lê as portas de pareamento 7450-7459. A porta de pareamento responde cerca de 30 segundos depois que o contêiner está healthy. A janela Initialize propõe a pasta /databases/replica/..., que fica fora dos volumes: troque-a. Essa janela tem cerca de 1000 px de altura e não rola: diminua o zoom da página se você não vir os botões. Testado no navegador em 2026-11-16. Compare a impressão digital da replica com a do log dela. Deixe RCM URL vazio. Depois continue no passo 4 do guia do cluster no Linux (pasta do banco, registro, inicializar a replica). Para a pasta do banco da replica, use uma pasta no volume db, por exemplo /db/replica. Testado: uma linha gravada no master estava na replica em 30 segundos.

Para dispensar as opções -f, coloque COMPOSE_FILE=compose.yaml:compose.master.yaml (ou ...replica.yaml) em .env.

Um host Docker. compose.cluster-one-host.yaml é um arquivo completo com os dois contêineres:

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

Os contêineres se alcançam pelo nome na rede do projeto, então as portas do cluster não são publicadas. Em Link hosts escreva hqbird-master e hqbird-replica. O Firebird do master está na porta 3050, o da replica na 3051; o console é https://<docker host>:7444.

Regras:

  • A função e as configurações dela são lidas só na primeira inicialização. Depois, um HQBIRD_CLUSTER_ROLE diferente gera um aviso no log e não muda nada. Para mudar o cluster depois, use o HQ Monitor (Clusters) ou os comandos fbagent --cluster-init e fbagent --cluster-pairing dentro do contêiner.
  • Uma configuração errada (uma função desconhecida, um master sem HQBIRD_CLUSTER_ADDRESS, uma configuração da outra função) interrompe a inicialização antes de qualquer instalação. O log diz o que escrever ([hqbird-boot] error: ...); o Docker inicia o contêiner de novo e o log repete a linha até você corrigir a configuração.
  • A janela de pareamento de uma replica fica aberta por 24 horas. Um reinício de um contêiner que ainda não está em nenhum cluster a abre de novo. Para fechar a porta de pareamento para outras redes, use HQBIRD_RCM_ALLOW ou o seu firewall; depois do vínculo você pode tirar a porta de ports:.
  • Para um switchover (um serviço do RCM), cada host precisa de um segundo nó e da porta publicada dele: veja a seção 7.3.

7.2. Com HQCenter

O HQCenter adiciona a instância a um cluster como adiciona um servidor. Não defina HQBIRD_CLUSTER_ROLE. No HQCenter, informe o endereço do host Docker como endereço do membro. Em compose.yaml, publique as portas dos componentes do cluster:

Componente Porta Publicar quando
nó do cluster o listen_port do nó (por exemplo 7051) a instância é membro do cluster
RCM 7443 o HQCenter torna este agente o RCM
console do operador do RCM 7444 como acima; defina operator_addr como 0.0.0.0:7444 nas configurações do RCM

O agente instala o nó (e o RCM) alguns minutos depois que o cluster é salvo. Até lá a porta do nó não responde. No HQCenter, defina o listen_port do nó como a porta publicada. Uma replica espera até o agente do RCM enviar a CA do cluster.

Testado em 2026-11-16 sem função: os agentes instalaram os nós e o RCM, e todos os membros voltaram a running depois de docker compose down e up -d.

7.3. Switchover entre os dois contêineres

Um serviço do RCM move a função master de um banco de um host para o outro. Para um serviço, cada host precisa de dois nós: um nó master e um nó replica. Link hosts dá a cada host um nó, então você adiciona os segundos nós. Testado em 2026-11-16 no par da seção 7.1: o switchover levou 25 segundos, o master antigo virou uma replica somente leitura, e uma linha gravada no master novo estava nela 15 segundos depois.

Os passos usam a API de operador do RCM na porta do console. O curl pede a senha de rcmadmin; -k pula a verificação do certificado próprio do cluster:

Command
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }
  1. Publique a porta do segundo nó nos dois hosts: porta do nó + 10. Em compose.master.yaml e compose.replica.yaml, retire o # da linha "7061:7061" e depois execute docker compose up -d com as mesmas opções -f. Faça isso antes da primeira inicialização, quando puder.

  2. Dê a cada nó o endereço do seu host Docker. O RCM entrega este endereço e a porta do Firebird às aplicações; sem ele elas recebem o endereço do contêiner:

    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 mostra os ids dos nós (<host name>-master, <host name>-replica).

  3. Adicione os segundos nós ao documento do cluster: um nó master no host replica e o nó replica dele no host master, os dois com listen_port 7061. Leia o documento, adicione dois membros e um link e envie-o de volta com a revisão:

    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

    Os agentes então instalam os dois serviços de nó (30 segundos no teste em dois hosts; pode levar alguns minutos). docker compose exec hqbird systemctl list-units --type=service passa a mostrar dois serviços hqclusternode em cada contêiner.

    Em seguida, dê aos dois nós replica uma pasta de banco no volume db. Sem ela, um switchover de volta ou um failover interrompe depois do ponto sem retorno, e o serviço vai para 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. Defina o serviço. host é o id do agente do host. O caminho no segundo host é o caminho do arquivo da 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. Verifique e depois troque:

    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>

Depois do switchover, .../services/shop/master devolve o endereço do outro host Docker e a porta do Firebird dele. As aplicações precisam se conectar a esse endereço. Um switchover precisa de uma replica que esteja IN_SYNC: ela fica assim depois da primeira gravação no master (35 segundos no teste).

Routers e failover automático. Um router (HAProxy) dá às aplicações um endereço que segue o master. Nas imagens até 2027.2.33 inclusive o router não inicia (seção 9); a imagem seguinte traz a correção. O failover automático precisa de um router como testemunha. Testado em 2026-11-17 no laboratório, na 2027.2.33 com um contorno e em uma imagem de teste com a correção:

  • Um router é um membro do cluster com a função router. O agente instala o pacote haproxy do repositório Debian, também em cada contêiner novo: o contêiner precisa de acesso ao repositório. Publique a porta do router (3051 no exemplo).

  • Com um router só no host do RCM, o RCM moveu o master sozinho 84 segundos depois que o contêiner do outro host parou; a operação levou 10 segundos. Quando esse host voltou, rejoin fez dele a replica de novo.

  • Com um router em cada host o failover automático não começa: mais da metade dos routers precisa informar, e um dos dois está no host perdido.

  • O RCM executa no contêiner master. Quando esse host se perde, o RCM se perde também, e nada move o master sozinho.

8. Portas, firewall, segunda instância

Publique cada porta com o mesmo número fora e dentro do contêiner (3051:3051, não 3051:3050). O agente e o cluster informam a porta que veem dentro do contêiner.

Porta O quê Necessária
HQBIRD_FB_PORT (3050) Firebird sempre
20000 + porta do Firebird (23050) HQ Monitor sempre
listen_port do nó (7051) nó do cluster membro do cluster
porta do nó + 10 (7061) o segundo nó do host um serviço com switchover (seção 7.3)
7443, 7444 RCM, console do operador do RCM este agente é o RCM (um por host)
porta de pareamento (7450) a porta de pareamento do agente uma replica com função, até ser vinculada

O agente se conecta ao HQCenter por conta própria (saída); ele não precisa de porta de entrada.

O Docker publica portas contornando o ufw. Testado: com o ufw permitindo só a porta 22, as portas do Firebird e do HQ Monitor estavam abertas a partir da internet. Use um firewall externo, publique em um endereço do host ("10.0.0.5:23050:23050") ou acrescente regras à cadeia iptables DOCKER-USER.

Uma segunda instância em um host precisa da própria pasta, do name: do projeto, de hostname, de HQBIRD_FB_PORT e das portas. O nome do projeto forma os nomes dos volumes (<name>_opt, …): com o mesmo nome, a segunda inicialização pega os volumes e o contêiner da primeira.

Instância 1 Instância 2
name:, hostname: hqbird-fb40-3051 hqbird-fb40-3052
HQBIRD_FB_PORT 3051 3052
ports: 3051, 23051, 7052 3052, 23052, 7053

Regras para N instâncias em um IP externo:

  • Firebird 3050 + N, HQ Monitor 20000 + a porta do Firebird, nó do cluster 7051 + N (defina o mesmo listen_port no HQCenter). Pule 3050, 23050 e 7051 quando o host já executa um Firebird ou HQbird fora do Docker.
  • Só uma instância por host pode ser o RCM (7443, 7444).
  • Com uma função de cluster (seção 7.1), cada instância de um host precisa do próprio slot: HQBIRD_PAIRING_PORT=7451 e HQBIRD_NODE_PORT=7052 para a segunda, 7452 e 7053 para a terceira.
  • Uma instância usa cerca de 200-250 MB de memória sem carga. Testado: três instâncias FB 4.0 em 2 vCPU / 4 GB, uma com carga.
  • Outras linhas do Firebird no mesmo host seguem as mesmas regras, com a própria imagem (hqbird2027-fb50, …) e os nomes (hqbird-fb50-3054).

Acrescente uma instância (aqui a terceira: 3053, 23053, 7054) a partir do compose.yaml da primeira. Trocar 3051 também muda name:, hostname:, HQBIRD_FB_PORT e a porta do 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. Problemas conhecidos

  • Depois de conectar o agente ao HQCenter com fbagent --enroll à mão, execute fbagent --refresh-apply-launcher como root, senão a autoatualização do agente falha com “no goafts CA is pinned”.
  • Em scripts, execute docker compose exec com -T e </dev/null. Sem eles ele lê a entrada padrão e toma o resto de um script que você envia com ssh ... bash -s.
  • Antes de o agente estar conectado ao HQCenter, o log dele mostra os avisos goafts mTLS settings are incomplete e bootstrap CA not found. Isso é normal.
  • O contêiner entrega /opt/hqbird ao root depois de cada instalação (a autoatualização do agente precisa disso). O agente grava um aviso de que não consegue atualizar /opt/hqbird/version.json; você pode ignorá-lo.
  • Imagens até 2027.2.32: pastas abertas para escrita. Nestas imagens /etc, /usr e /usr/lib têm o modo 0777, e alguns arquivos do contêiner podem ser gravados por todas as contas. Qualquer conta no contêiner pode mudar o que o root inicia. O agente também recusa uma pasta assim (root trust directory: /usr is writable by group or others): o instalador em modo de atualização então falha em um contêiner novo, e o contêiner inicia de novo e de novo. Use a imagem 2027.2.33 ou mais nova. Não dê acesso de shell no contêiner de uma imagem mais antiga a usuários em quem você não confia.
  • Imagens até 2027.2.32: o RCM feito à mão não inicia em um contêiner novo. Quando você cria o RCM com fbagent --cluster-init dentro do contêiner, o agente cria a conta do sistema operacional hqbirdrcm. Um contêiner novo não a tem (User=hqbirdrcm: invalid userid, o contêiner fica unhealthy). Imagens mais novas guardam as contas no volume state. Um cluster feito pelo HQCenter não é afetado.
  • Imagens até 2027.2.33 inclusive: um router (HAProxy) não inicia. Para um membro do cluster com a função router o agente instala o pacote haproxy e o serviço do router, mas haproxy.service falha. O substituto do systemd na imagem não coloca os valores de $CONFIG, $PIDFILE e $EXTRAOPTS na linha de comando e não lê arquivo drop-in, e nada cria a pasta /run/haproxy. A imagem seguinte traz a correção. Até lá, dê às aplicações o endereço de .../services/<alias>/master e não adicione um membro router.
  • Imagem 2027.2.33: um contêiner novo não inicia depois que um router foi adicionado. O log tem chown: invalid user: 'haproxy', e o Docker inicia o contêiner de novo e de novo. Para iniciá-lo, remova o arquivo usr/lib/tmpfiles.d/haproxy.conf no volume state. A imagem seguinte traz a correção.

10. Construir as imagens

Para a equipe de lançamento. Em um host Windows com os arquivos da versão em dist\releases, faça login no GHCR com um token que tenha write:packages e depois construa, envie e assine:

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

Um pacote novo (o primeiro push de uma linha) é privado. Nas configurações do pacote da organização IBSurgeon, defina a visibilidade como pública.

-ContextOnly prepara só a pasta de build (dist\hqbird2027-docker\fbNN-<version>) e imprime o comando docker build para executar em um host Docker Linux.

O build para quando uma pasta ou um arquivo da imagem sob /etc ou /usr pode ser gravado por todas as contas (a pasta de build vem do Windows, onde os modos se perdem). Os testes dos scripts do contêiner, das configurações do cluster e dos arquivos compose: go test ./ops/docker/.