HQbird 2027 in Docker:管理员指南
本指南面向在 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 镜像。
docker pull ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.33镜像用 cosign 签名。公钥 hqbird-cosign.pub 尚未发布(2026-11-16)。2027.2.33 镜像已签名。拿到密钥后,使用前请检查镜像:
cosign verify --key hqbird-cosign.pub ghcr.io/ibsurgeon/hqbird2027-fb50:2027.2.332. 首次启动
-
把发行版
ops/docker/中的compose.yaml复制到 Docker 主机上的一个文件夹。 -
把 SYSDBA 密码放入一个只有你能读取的文件:
mkdir -p secrets && openssl rand -hex 12 > secrets/sysdba_password && chmod 600 secrets/sysdba_password -
在
compose.yaml中设置image:、hostname:,并去掉你要使用的secrets:行上的#。 -
启动容器:
docker compose up -d -
观察安装过程(首次启动可能要几分钟):
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 用户):
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:改为新版本,然后: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/)。
-
在 master 主机上,把该 Docker 主机的地址写入
.env,按 replica 主机和浏览器能够到达它的方式填写(不是localhost,也不是容器的地址):echo 'HQBIRD_CLUSTER_ADDRESS=203.0.113.10' >> .env docker compose -f compose.yaml -f compose.master.yaml up -d -
在 replica 主机上:
docker compose -f compose.yaml -f compose.replica.yaml up -d -
读取每个容器的集群行:
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:...。 -
打开控制台
https://<master host>:7444。登录名是rcmadmin。没有 secretrcm_password时,密码在一个文件里;RCM 在首次登录时要求设置新密码:docker compose exec hqbird sh -c 'cat /opt/hqbird/fbagent-*/clusterca/*/rcm-initial-password' -
在 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 是包含两个容器的完整文件:
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 跳过对集群自身证书的检查:
RCM=https://203.0.113.10:7444
api() { curl -sk --digest -u rcmadmin -H 'Content-Type: application/json' "$@"; }-
发布第二个节点端口,在两台主机上:节点端口 + 10。在
compose.master.yaml和compose.replica.yaml中,去掉"7061:7061"这一行的#,然后用相同的-f选项运行docker compose up -d。如果可以,在首次启动之前做这件事。 -
给每个节点它的 Docker 主机地址。 RCM 把这个地址和 Firebird 端口交给应用程序;没有它,应用程序得到的是容器的地址:
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)。 -
添加第二个节点到集群文档:replica 主机上的一个 master 节点,以及 master 主机上的它的 replica 节点,两者的
listen_port都是 7061。读取文档,添加两个成员和一条链接,并连同它的修订号发回去: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: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 -
定义服务。
host是该主机的代理 id。第二台主机上的路径是 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 -
先检查,再切换:
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 端口:
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 并签名:
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/。