HQbird 2027 no Docker: guia do administrador
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.
docker pull ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.33As 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:
cosign verify --key hqbird-cosign.pub ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.332. Primeira inicialização
-
Copie
compose.yaml(deops/docker/da versão) para uma pasta no host Docker. -
Grave a senha do SYSDBA em um arquivo, legível só por você:
mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password -
Em
compose.yaml, definaimage:,hostname:e retire o#das linhassecrets:que você usa. -
Inicie o contêiner:
docker compose up -d -
Acompanhe a instalação (alguns minutos na primeira inicialização):
docker compose logs -fEm 2 vCPU a instalação leva cerca de 20 segundos. Ela termina quando o log mostra
[hqbird-boot] ready: firebird.service=active ...edocker compose psmostrahealthy.
Em seguida:
- Firebird:
<docker host>:3050. - HQ Monitor:
http://<docker host>:23050/, loginadmin. O instalador cria a senha; leia-a comdocker 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 exemplohqbird-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):
chown 84:84 /srv/hqbird/db /srv/hqbird/backupFaç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:docker compose pull && docker compose up -dNa 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).
-
No host master, coloque o endereço desse host Docker em
.env, como o host replica e o seu navegador o alcançam (nãolocalhost, não o endereço do contêiner):echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env docker compose -f compose.yaml -f compose.master.yaml up -d -
No host replica:
docker compose -f compose.yaml -f compose.replica.yaml up -d -
Leia as linhas de cluster de cada contêiner:
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:.... -
Abra o console
https://<master host>:7444. O login ércmadmin. Sem o segredorcm_passworda senha está em um arquivo; o RCM pede uma nova no primeiro login:docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password' -
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 volumedb, 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:
docker compose -f compose.cluster-one-host.yaml up -dOs 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_ROLEdiferente gera um aviso no log e não muda nada. Para mudar o cluster depois, use o HQ Monitor (Clusters) ou os comandosfbagent --cluster-initefbagent --cluster-pairingdentro 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_ALLOWou o seu firewall; depois do vínculo você pode tirar a porta deports:. - 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:
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }-
Publique a porta do segundo nó nos dois hosts: porta do nó + 10. Em
compose.master.yamlecompose.replica.yaml, retire o#da linha"7061:7061"e depois executedocker compose up -dcom as mesmas opções-f. Faça isso antes da primeira inicialização, quando puder. -
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:
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/nodesmostra os ids dos nós (<host name>-master,<host name>-replica). -
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_port7061. Leia o documento, adicione dois membros e um link e envie-o de volta com a revisão: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.jsonOs 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=servicepassa a mostrar dois serviçoshqclusternodeem 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 parafailed: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 -
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>: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 -
Verifique e depois troque:
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 pacotehaproxydo 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,
rejoinfez 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 Monitor20000 +a porta do Firebird, nó do cluster7051 + N(defina o mesmolisten_portno 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=7451eHQBIRD_NODE_PORT=7052para a segunda,7452e7053para 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:
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, executefbagent --refresh-apply-launchercomo root, senão a autoatualização do agente falha com “no goafts CA is pinned”. - Em scripts, execute
docker compose execcom-Te</dev/null. Sem eles ele lê a entrada padrão e toma o resto de um script que você envia comssh ... bash -s. - Antes de o agente estar conectado ao HQCenter, o log dele mostra os avisos
goafts mTLS settings are incompleteebootstrap CA not found. Isso é normal. - O contêiner entrega
/opt/hqbirdao 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,/usre/usr/libtê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-initdentro do contêiner, o agente cria a conta do sistema operacionalhqbirdrcm. Um contêiner novo não a tem (User=hqbirdrcm: invalid userid, o contêiner ficaunhealthy). Imagens mais novas guardam as contas no volumestate. 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
routero agente instala o pacotehaproxye o serviço do router, mashaproxy.servicefalha. O substituto do systemd na imagem não coloca os valores de$CONFIG,$PIDFILEe$EXTRAOPTSna 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>/mastere não adicione um membrorouter. - 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 arquivousr/lib/tmpfiles.d/haproxy.confno volumestate. 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:
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.keyUm 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/.