本指南面向在 Docker 中运行 HQbird 2027 的管理员。一个容器就是一个带有全部 HQbird 组件的 Firebird 实例:

  • Firebird(一个系列的 HQbird 构建:5.0、4.0、3.0 或 2.5);
  • HQbird agent(fbagent):备份、监控、维护作业、更新、与 HQCenter 的连接;
  • HQ Monitor:该实例的 Web 控制台;
  • 集群节点(hqclusternode)和 RCM(hqbirdrcm):当 HQCenter 把该实例加入集群时,或当你给容器一个集群角色时(第 7 节),由代理安装。没有角色、也没有 HQCenter 时,容器不运行任何集群组件。

容器用与服务器相同的离线安装程序安装 HQbird(Linux 安装指南)。然后,代理像在服务器上一样,从 HQCenter 更新 Firebird、HQ Monitor、集群组件以及它自己。你的数据、配置、许可证、HQCenter 证书和更新后的程序都在卷上:重新创建容器或更换镜像时,它们仍然保留。

当前版本:2027.2.33(2026-11-16):Firebird 2.5.9、3.0.15、4.0.8 和 5.0.5,agent 3.4.0,HQ Monitor 1.57.0,RCM 和节点 2027.5.12。

于 2026-11-16 在 Ubuntu 22.04.5(2 vCPU / 4 GB)、Docker 29.10.0、Compose 5.7.1、镜像 hqbird2027-fb40:2027.2.33 上测试(首次测试:2026-11-11,镜像 2027.2.27)。面向 Ubuntu 22.04 的逐步安装:hqbird2027-docker-install-fb40.ru.md(俄文),hqbird2027-docker-install-fb40.pt.md(葡萄牙文)。

集群角色(第 7.1 节)和切换(第 7.3 节)于 2026-11-16 在 5.0、4.0、3.0 和 2.5 镜像上测试,两个“主机”是一台虚拟机的两个地址,并且也在两台分开的 Docker 主机上测试(两个 droplet,4.0 镜像 2027.2.33)。2026-11-17,其余内容在两台 Docker 主机上用 5.0 镜像 2027.2.33 测试:在 2027.2.32 容器中手工建成并迁到新镜像的集群(两个容器都在 35 秒内 healthy)、HQBIRD_RCM_ALLOW、RCM 控制台的 Services 页面,以及自动故障转移。router(HAProxy)在截至 2027.2.33 的镜像中不会启动(第 9 节);下一个镜像包含该修复。

1. 镜像

镜像 Firebird 默认端口
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

镜像位于 IBSurgeon 的 GitHub Container Registry(https://github.com/orgs/IBSurgeon/packages)。它们是公开的:你不需要登录。<version> 是 HQbird 安装版本,例如 2027.2.33。标签 2027.2 是最新的 2027.2.x 镜像。

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

镜像用 cosign 签名。公钥 hqbird-cosign.pub 尚未发布(2026-11-16)。2027.2.33 镜像已签名。拿到密钥后,使用前请检查镜像:

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

2. 首次启动

  1. 把发行版 ops/docker/ 中的 compose.yaml 复制到 Docker 主机上的一个文件夹。

  2. 把 SYSDBA 密码放入一个只有你能读取的文件:

    Command
    mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password
  3. 在 compose.yaml 中设置 image:、hostname:,并去掉你要使用的 secrets: 行上的 #。

  4. 启动容器:

    Command
    docker compose up -d
  5. 观察安装过程(首次启动可能要几分钟):

    Command
    docker compose logs -f

    在 2 vCPU 上,安装大约需要 20 秒。日志出现 [hqbird-boot] ready: firebird.service=active ...,并且 docker compose ps 显示 healthy 时,即已完成。

然后:

  • Firebird:<docker host>:3050。
  • HQ Monitor:http://<docker host>:23050/,登录名 admin。安装程序会生成密码;用下面的命令读取:docker compose exec hqbird cat /opt/hqbird/conf/access.properties。
  • HQCenter 中的代理 id:主机名 + 安装日期(YYMMDD)+ -fbNN,例如 hqbird-fb40-3051261111-fb40。

保留主机名。 实例的许可证身份是 state 卷上的 machine-id 和代理 id。新的 state 卷就是一次新安装。

3. 设置

这些设置只在首次启动(安装)时读取。

设置 作用
HQBIRD_FB_PORT 容器内的 Firebird 端口(默认 3050)。HQ Monitor 使用 20000 + 该端口
HQBIRD_HQM_PORT 另一个 HQ Monitor 端口
HQBIRD_AGENT_ID 代理 id(默认:由主机名、日期和端口生成)
HQBIRD_HQM_LOGIN + secret hqmonitor_password HQ Monitor 的登录名
HQBIRD_TRIAL_EMAIL、HQBIRD_TRIAL_ZONE 申请试用许可证(你接受隐私政策)
HQBIRD_DEBUG=1 安装 Firebird 调试文件
secret sysdba_password 新 Firebird 的 SYSDBA 密码
secret license 许可证文件
secret attach 来自 HQCenter 的 attach.json:把代理连接到你的 HQCenter
HQBIRD_CLUSTER_ROLE master 或 replica:没有 HQCenter 的集群(第 7 节)。空:没有集群
HQBIRD_CLUSTER_ADDRESS master,必填:replica 和浏览器能够到达的 Docker 主机地址或 DNS 名。逗号分隔的列表;第一个进入 RCM URL
HQBIRD_CLUSTER_ID master:集群 id(默认:主机名)
secret rcm_password master:RCM 登录名 rcmadmin 的密码(默认:生成的密码)
HQBIRD_RCM_ALLOW replica:只有这些 RCM 可以邀请该容器(IP、CIDR、主机名;默认:任意)。写入 master 的 Docker 主机地址:replica 看到的是该地址。在同一台 Docker 主机上,replica 看到的是自己 Docker 网络的网关
HQBIRD_PAIRING_PORT、HQBIRD_NODE_PORT 集群槽位:配对端口 7450-7459,节点端口 = 配对端口 - 399(默认 7450 和 7051)

4. 卷

卷 路径 内容
opt /opt Firebird、代理、HQ Monitor、集群节点、RCM
state /var/lib/hqbird-container unit、sudoers、HQ Monitor 数据、代理日志、machine-id、安装状态、运行时创建的操作系统账户(RCM 服务用户)
trust /usr/libexec/hqbird-fbagent 代理的更新启动器与 trust
rootwork /var/lib/hqbird-fbagent 更新启动器的工作文件夹
db /db 数据库(把数据库放在这里)
backup /backup 备份

不要把主机文件夹挂载到 opt、state、trust 和 rootwork 上。db 和 backup 可以使用主机文件夹;把它们交给 uid 84(镜像中的 firebird 用户):

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

六个卷要一起备份。

5. 日常操作

任务 命令
服务状态 docker compose exec hqbird systemctl list-units --type=service
重启 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
日志 docker compose logs --since 1h
停止(Firebird 关闭数据库) docker compose stop

在容器内,systemctl 控制 HQbird 服务。它不是 systemd:它支持 HQbird 程序使用的命令(start、stop、restart、status、is-active、enable、disable、show、list-units、daemon-reload)。

6. 更新

有两种更新方式。两种都保留你的数据。

  • 从 HQCenter(与在服务器上相同):HQCenter 更新容器内的代理、HQ Monitor、Firebird、集群节点和 RCM。

  • 新镜像:把 image: 改为新版本,然后:

    Command
    docker compose pull && docker compose up -d

    启动时,容器以更新模式运行新镜像的安装程序。如果 HQCenter 已经把代理更新到比镜像所带版本更新的版本,安装程序不会运行(不会降级);日志会说明这一点。

新容器(新镜像,或不带 -v 的 docker compose down 与 up -d)会保留集群:角色、集群 id、RCM、节点以及到另一台主机的链接都在卷上。compose 文件中的集群设置不会再次读取。截至 2027.2.32 的镜像在这里有两处缺陷:见第 9 节。

7. 集群

有两种建立集群的方式。不要在同一个容器里混用。

7.1. 不使用 HQCenter:带角色的两个容器

一个容器是 master,并运行带控制台的集群管理器(RCM)。另一个是 replica。角色是首次启动时的设置:HQBIRD_CLUSTER_ROLE。没有它,容器不运行 RCM,不运行集群节点,也不打开配对端口。角色需要镜像 2027.2.33 或更新的版本。

两台 Docker 主机。 给两个容器不同的主机名(.env 中的 HQBIRD_HOSTNAME,或 hostname:):主机名相同时,两个代理的 id 相同,RCM 会拒绝 replica(duplicate)。把 compose.master.yaml 复制到 master 主机,把 compose.replica.yaml 复制到 replica 主机,放在 compose.yaml 旁边(发行版的 ops/docker/)。

  1. 在 master 主机上,把该 Docker 主机的地址写入 .env,按 replica 主机和浏览器能够到达它的方式填写(不是 localhost,也不是容器的地址):

    Command
    echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env
    docker compose -f compose.yaml -f compose.master.yaml up -d
  2. 在 replica 主机上:

    Command
    docker compose -f compose.yaml -f compose.replica.yaml up -d
  3. 读取每个容器的集群行:

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

    master 显示控制台地址和 CA hash: [hqbird-boot] cluster: role=master id=... console=https://203.0.113.10:7444 login=rcmadmin。 replica 显示它的配对端口和指纹: [hqbird-boot] cluster: role=replica pairing port 7450: open until ..., fingerprint sha256:...。

  4. 打开控制台 https://<master host>:7444。登录名是 rcmadmin。没有 secret rcm_password 时,密码在一个文件里;RCM 在首次登录时要求设置新密码:

    Command
    docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password'
  5. 在 Settings → Link hosts 中写两行:你在 HQBIRD_CLUSTER_ADDRESS 中给出的地址(master),以及 replica 的 Docker 主机地址。不要写端口:RCM 读取配对端口 7450-7459。配对端口在容器变为 healthy 之后大约 30 秒才应答。Initialize 窗口建议的文件夹是 /databases/replica/...,它在卷之外:请改掉。该窗口大约 1000 px 高,并且不会滚动:如果看不到按钮,请缩小页面。2026-11-16 在浏览器中测试过。把 replica 的指纹与它日志中的指纹比较。RCM URL 留空。然后继续 Linux 集群指南 的第 4 步(数据库文件夹、enroll、初始化 replica)。replica 的数据库文件夹使用 db 卷上的文件夹,例如 /db/replica。测试结果:在 master 上写入的一行,30 秒后出现在 replica 上。

要省去 -f 选项,把 COMPOSE_FILE=compose.yaml:compose.master.yaml(或 ...replica.yaml)放入 .env。

一台 Docker 主机。 compose.cluster-one-host.yaml 是包含两个容器的完整文件:

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

容器在项目的网络上按名称互相到达,因此集群端口不发布。在 Link hosts 中写入 hqbird-master 和 hqbird-replica。master 的 Firebird 在端口 3050,replica 的在 3051;控制台是 https://<docker host>:7444。

规则:

  • 角色及其设置只在首次启动时读取。之后如果给出不同的 HQBIRD_CLUSTER_ROLE,日志里会出现警告,并且什么也不会改变。以后要更改集群,请使用 HQ Monitor(Clusters),或在容器内使用 fbagent --cluster-init 和 fbagent --cluster-pairing 命令。
  • 错误的设置(未知角色、没有 HQBIRD_CLUSTER_ADDRESS 的 master、属于另一角色的设置)会在安装任何内容之前停止启动。日志会说明应该写什么([hqbird-boot] error: ...);Docker 会再次启动容器,并重复这一行,直到你改正设置。
  • replica 的配对窗口开放 24 小时。重启一个尚未加入任何集群的容器,会再次打开它。要把配对端口对其他网络关闭,请使用 HQBIRD_RCM_ALLOW 或你的防火墙;链接之后,可以从 ports: 中去掉该端口。
  • 对于切换(一项 RCM 服务),每台主机需要第二个节点及其发布的端口:见第 7.3 节。

7.2. 使用 HQCenter

HQCenter 把实例加入集群的方式,与把服务器加入集群相同。不要设置 HQBIRD_CLUSTER_ROLE。在 HQCenter 中,把Docker 主机的地址作为成员地址。在 compose.yaml 中,发布集群组件的端口:

组件 端口 何时发布
集群节点 节点的 listen_port(例如 7051) 该实例是集群成员时
RCM 7443 HQCenter 把此代理设为 RCM 时
RCM 操作员控制台 7444 同上;在 RCM 设置中把 operator_addr 设为 0.0.0.0:7444

代理在集群保存之后几分钟安装节点(以及 RCM)。在此之前,节点端口不应答。在 HQCenter 中,把节点的 listen_port 设为已发布的端口。replica 会等待,直到 RCM 代理上传集群 CA。

2026-11-16 在没有角色的情况下测试:代理安装了节点和 RCM,并且在 docker compose down 和 up -d 之后,所有成员再次变为 running。

7.3. 两个容器之间的切换

一项 RCM 服务把数据库的 master 角色从一台主机移到另一台。对于一项服务,每台主机需要两个节点:一个 master 节点和一个 replica 节点。Link hosts 给每台主机一个节点,因此第二个节点要自己添加。2026-11-16 在第 7.1 节的那一对上测试:切换用了 25 秒,原来的 master 变成只读 replica,在新 master 上写入的一行在 15 秒后出现在它上面。

这些步骤使用控制台端口上的 RCM 操作员 API。curl 会询问 rcmadmin 的密码;-k 跳过对集群自身证书的检查:

Command
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }
  1. 发布第二个节点端口,在两台主机上:节点端口 + 10。在 compose.master.yaml 和 compose.replica.yaml 中,去掉 "7061:7061" 这一行的 #,然后用相同的 -f 选项运行 docker compose up -d。如果可以,在首次启动之前做这件事。

  2. 给每个节点它的 Docker 主机地址。 RCM 把这个地址和 Firebird 端口交给应用程序;没有它,应用程序得到的是容器的地址:

    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 显示节点 id(<host name>-master、<host name>-replica)。

  3. 添加第二个节点到集群文档:replica 主机上的一个 master 节点,以及 master 主机上的它的 replica 节点,两者的 listen_port 都是 7061。读取文档,添加两个成员和一条链接,并连同它的修订号发回去:

    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

    然后代理会安装两个节点服务(在两台主机上的测试中为 30 秒;有时需要几分钟)。 然后 docker compose exec hqbird systemctl list-units --type=service 会在每个容器中显示两个 hqclusternode 服务。

    然后给两个 replica 节点在 db 卷上各一个数据库文件夹。没有它,切回去或故障转移会在无法返回的时点之后停止,服务变为 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. 定义服务。 host 是该主机的代理 id。第二台主机上的路径是 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. 先检查,再切换:

    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>

切换之后,.../services/shop/master 给出另一台 Docker 主机的地址及其 Firebird 端口。应用程序必须连接到该地址。切换需要一个处于 IN_SYNC 的 replica:在 master 上第一次写入之后即是如此(测试中为 35 秒)。

router 与自动故障转移。 router(HAProxy)给应用程序一个跟随 master 的地址。在截至 2027.2.33 的镜像中,router 不会启动(第 9 节);下一个镜像包含该修复。自动故障转移需要一个 router 作为证人。2026-11-17 在实验室中测试,对象是带有变通办法的 2027.2.33,以及带有该修复的测试镜像:

  • router 是角色为 router 的集群成员。代理从 Debian 软件源安装 haproxy 软件包,每个新容器中也是如此:容器需要能访问该软件源。发布 router 端口(示例中为 3051)。
  • 仅在 RCM 主机上有 router 时,另一台主机的容器停止 84 秒后,RCM 自行移走了 master;该操作用了 10 秒。那台主机回来后,rejoin 使它再次成为 replica。
  • 每台主机上都有 router 时,自动故障转移不会开始:必须有超过一半的 router 报告,而两个中的一个在已失去的主机上。
  • RCM 运行在 master 容器中。那台主机失去时,RCM 也一起失去,没有任何东西会自行移动 master。

8. 端口、防火墙、第二个实例

发布每个端口时,容器外和容器内使用相同的号码(3051:3051,而不是 3051:3050)。代理和集群报告的是它们在容器内部看到的端口。

端口 用途 何时需要
HQBIRD_FB_PORT(3050) Firebird 始终
20000 + Firebird 端口(23050) HQ Monitor 始终
节点 listen_port(7051) 集群节点 集群成员
节点端口 + 10(7061) 该主机的第二个节点 带有切换的服务(第 7.3 节)
7443、7444 RCM、RCM 操作员控制台 此代理是 RCM 时(每台主机一个)
配对端口(7450) 代理的配对端口 带角色的 replica,直到它被链接

代理自己连接 HQCenter(出站);它不需要入站端口。

Docker 会越过 ufw 发布端口。 测试中:ufw 只允许端口 22 时,Firebird 和 HQ Monitor 端口仍从互联网开放。请使用外部防火墙,或发布到一个主机地址("10.0.0.5:23050:23050"),或向 iptables 链 DOCKER-USER 添加规则。

同一台主机上的第二个实例需要自己的文件夹、项目 name:、hostname、HQBIRD_FB_PORT 和端口。项目名构成卷名(<name>_opt,……):名称相同时,第二次启动会占用第一个实例的卷和容器。

实例 1 实例 2
name:、hostname: hqbird-fb40-3051 hqbird-fb40-3052
HQBIRD_FB_PORT 3051 3052
ports: 3051、23051、7052 3052、23052、7053

同一外部 IP 上 N 个实例的规则:

  • Firebird 为 3050 + N,HQ Monitor 为 20000 + Firebird 端口,集群节点为 7051 + N(在 HQCenter 中设置相同的 listen_port)。当主机已经在 Docker 之外运行 Firebird 或 HQbird 时,跳过 3050、23050 和 7051。
  • 每台主机只能有一个实例作为 RCM(7443、7444)。
  • 使用集群角色时(第 7.1 节),一台主机上的每个实例需要自己的槽位:第二个为 HQBIRD_PAIRING_PORT=7451 和 HQBIRD_NODE_PORT=7052,第三个为 7452 和 7053。
  • 一个实例在无负载时大约使用 200-250 MB 内存。测试:在 2 vCPU / 4 GB 上运行三个 FB 4.0 实例,其中一个有负载。
  • 同一主机上的其他 Firebird 系列遵循相同规则,使用自己的镜像(hqbird2027-fb50,……)和名称(hqbird-fb50-3054)。

从第一个实例的 compose.yaml 添加实例(这里是第三个:3053、23053、7054)。替换 3051 也会改变 name:、hostname:、HQBIRD_FB_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. 已知问题

  • 用手工的 fbagent --enroll 把代理连接到 HQCenter 之后,请以 root 运行 fbagent --refresh-apply-launcher,否则代理的自我更新会因 “no goafts CA is pinned” 而失败。
  • 在脚本中,运行 docker compose exec 时带上 -T 和 </dev/null。没有它们,它会读取标准输入,并吃掉你用 ssh ... bash -s 送入的脚本的其余部分。
  • 代理连接到 HQCenter 之前,它的日志会显示警告 goafts mTLS settings are incomplete 和 bootstrap CA not found。这是正常的。
  • 容器在每次安装之后把 /opt/hqbird 交给 root(代理的自我更新需要如此)。代理会写一条警告,说它无法更新 /opt/hqbird/version.json;可以忽略。
  • 截至 2027.2.32 的镜像:文件夹对写入开放。 在这些镜像中,/etc、/usr 和 /usr/lib 的模式为 0777,容器的一些文件对所有账户可写。容器中的任何账户都能改变 root 所启动的内容。代理也会拒绝这样的文件夹(root trust directory: /usr is writable by group or others):于是更新模式的安装程序在新容器中失败,容器会一次又一次地启动。请使用镜像 2027.2.33 或更新的版本。不要把较旧镜像的容器中的 shell 访问权交给你不信任的用户。
  • 截至 2027.2.32 的镜像:手工建立的 RCM 在新容器中不会启动。 当你在容器内用 fbagent --cluster-init 建立 RCM 时,代理会创建操作系统账户 hqbirdrcm。新容器里没有它(User=hqbirdrcm: invalid userid,容器为 unhealthy)。较新的镜像把账户保存在 state 卷上。由 HQCenter 建立的集群不受影响。
  • 截至 2027.2.33 的镜像:router(HAProxy)不会启动。 对于角色为 router 的集群成员,代理会安装 haproxy 软件包和 router 服务,但 haproxy.service 会失败。镜像中的 systemd 替代品不会把 $CONFIG、$PIDFILE 和 $EXTRAOPTS 的值放入命令行,也不读取 drop-in 文件,并且没有任何东西创建文件夹 /run/haproxy。下一个镜像包含该修复。在此之前,请把 .../services/<alias>/master 的地址给应用程序,并且不要添加 router 成员。
  • 镜像 2027.2.33:添加 router 之后,新容器不会启动。 日志中有 chown: invalid user: 'haproxy',Docker 会一次又一次地启动容器。要让它启动,请删除 state 卷上的文件 usr/lib/tmpfiles.d/haproxy.conf。下一个镜像包含该修复。

10. 构建镜像

供发布团队使用。在 Windows 主机上,发行文件位于 dist\releases 时,用拥有 write:packages 的令牌登录 GHCR,然后构建、push 并签名:

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

新软件包(一个系列的第一次 push)是私有的。在 IBSurgeon 组织的软件包设置中,把它的可见性设为 public。

-ContextOnly 只准备构建文件夹(dist\hqbird2027-docker\fbNN-<version>),并打印要在 Linux Docker 主机上运行的 docker build 命令。

当镜像在 /etc 或 /usr 下的某个文件夹或文件对所有账户可写时,构建会停止(构建文件夹来自 Windows,那里的模式会丢失)。容器脚本、集群设置和 compose 文件的测试:go test ./ops/docker/。