云端与 Docker
云 与 Docker
HQbird 在云服务器上的运行方式与在您自己的服务器上完全相同。对于 Docker,每条 Firebird 产品线都有现成的镜像。备份直接写入 S3,服务器磁盘上不产生文件。与中心的连接无需入站端口。
- 4 个镜像 Firebird 5 · 4 · 3 · 2.5
- 1 个容器 Firebird、代理和控制台
- S3 备份,磁盘上不产生文件
- 0 与中心连接所需的入站端口
- 200–250 MB 每个空闲实例的内存占用
服务器 · 容器 · 存储
云安装的三个部分
您可以使用常规安装程序在云服务器上安装 HQbird,也可以在 Docker 容器中运行它。两种情况下,代理都会自行连接到 HQCenter,备份可以写入 S3 存储。
常规安装程序
一个文件即可在云服务器上安装 Firebird、代理和控制台。安装程序本身不下载任何内容。当整台服务器都用于数据库时,这是理想选择。
Docker 镜像
一个容器就是一个 Firebird,包含所有 HQbird 组件。数据存放在卷上,替换容器或镜像时数据会保留。
备份到 S3
gbak 和 nbackup 写入流,流再写入存储桶。备份不需要服务器磁盘空间。在服务器和容器中均可使用。
镜像 · 首次启动 · compose
Docker 中的 HQbird
容器使用与服务器相同的安装程序安装 HQbird。Firebird、fbagent 代理和 HQ Monitor 在容器内运行。当实例加入集群时,代理会自行安装集群节点。仅当此实例被指定为集群 RCM 时,才会安装 RCM。
镜像位于 IBSurgeon GitHub Container Registry。它们是公开的:您无需登录注册表。镜像标签即 HQbird 套件的版本。
| 镜像 | Firebird | Firebird 端口 | HQ Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
首次启动
- 1compose.yaml从套件中复制到主机上的文件夹
- 2SYSDBA 密码写入只有您可读的密钥文件
- 3镜像、名称、密钥设置
image和hostname,去掉secrets:行中的# - 4docker compose up -d容器将安装 HQbird
- 5✓ 健康Firebird 和控制台均有响应
mkdir -p secrets openssl rand -hex 12 > secrets/sysdba_password chmod 600 secrets/sysdba_password docker compose up -d docker compose logs -f # 安装进度 docker compose ps # 等待健康状态
在 2 核服务器上,首次启动的安装大约需要 20 秒。
你将获得
- Firebird:
<Docker 主机>:3050。 - HQ Monitor:
http://<Docker 主机>:23050/,登录名admin。 - 安装程序会创建控制台密码。它位于容器内的
/opt/hqbird/conf/access.properties文件中。 - HQCenter 中的代理名称:主机名、安装日期和 Firebird 版本线。
日常工作
| 任务 | 命令 |
|---|---|
| 服务状态 | docker compose exec hqbird systemctl list-units --type=service |
| 重启 Firebird | docker compose exec hqbird systemctl restart firebirdFirebird 3.0: firebird-superserver 服务 |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb |
| 查看一小时的日志 | docker compose logs --since 1h |
| 停止 | docker compose stop:Firebird 会关闭数据库 |
在容器内,systemctl 命令控制 HQbird 服务,但它不是 systemd。它理解 HQbird 程序使用的命令:start、stop、restart、status、list-units 等。
变量 · 密钥 · 卷
设置与卷
容器只在首次启动时读取一次设置:这就是安装。数据、配置、许可证和更新后的程序都位于卷上。当你重新创建容器或更改镜像时,它们会保留。
| 设置 | 作用 |
|---|---|
HQBIRD_FB_PORT | 容器内的 Firebird 端口,默认为 3050。HQ Monitor 监听 20000 + 此端口。 |
HQBIRD_HQM_PORT | 使用不同的 HQ Monitor 端口。 |
HQBIRD_AGENT_ID | 代理名称。默认由主机名、日期和端口组成。 |
HQBIRD_HQM_LOGIN、密钥 hqmonitor_password | HQ Monitor 登录名和密码。 |
HQBIRD_TRIAL_EMAIL、HQBIRD_TRIAL_ZONE | 申请试用许可证。 |
密钥 sysdba_password | 新 Firebird 的 SYSDBA 密码。 |
密钥 license | 许可证文件。 |
密钥 attach | 来自 HQCenter 的 attach.json 文件:它将代理连接到你的中心。 |
| 卷 | 路径 | 内容 |
|---|---|---|
db | /db | 数据库。将你的数据库放在这里。 |
backup | /backup | 备份。 |
opt | /opt | Firebird、代理、HQ Monitor、集群节点、RCM。 |
state | /var/lib/hqbird-container | 服务、控制台数据、代理日志、机器 ID。 |
trust | /usr/libexec/hqbird-fbagent | 代理更新的可信启动。 |
rootwork | /var/lib/hqbird-fbagent | 更新用的工作文件夹。 |
- 仅数据库和备份可使用主机文件夹你可以将
db和backup卷替换为主机文件夹。将它们交给 uid 为 84 的用户:这是镜像中的firebird用户。不要将其他四个卷替换为主机文件夹。 - 卷的备份将全部六个卷一起保存。
- 不要更改主机名许可证绑定到
state卷上的机器 ID 和代理名称。新的state卷就是一次新的安装。 - 用一个文件连接到中心
attach密钥会在首次启动时将代理连接到 HQCenter。你无需为此进入容器。
端口发布 · 防火墙 · 第二个实例
端口与多个实例
发布每个端口时,容器外部和内部的端口号应相同:3051:3051,而不是 3051:3050。代理和集群会报告它们在容器内看到的端口。
| 端口 | 用途 | 何时需要 |
|---|---|---|
HQBIRD_FB_PORT (3050) | Firebird | 始终 |
| 20000 + Firebird 端口 (23050) | HQ Monitor | 始终 |
| 节点端口 (7051) | 集群节点 | 该实例加入集群时 |
| 7443、7444 | RCM 及其 Web 界面 | 此代理运行 RCM 时;每台主机一个 |
Docker 发布端口时会绕过 ufw。我们验证过:在 ufw 规则为“仅开放端口 22”的情况下,Firebird 和 HQ Monitor 端口仍可从互联网访问。请使用外部防火墙、将端口发布到某个主机地址("10.0.0.5:23050:23050"),或向 iptables 的 DOCKER-USER 链添加规则。
同一主机上的第二个实例
每个实例都需要自己的文件夹、项目名称、主机名和端口。项目名称决定卷的名称。如果名称相同,第二次启动会使用第一个实例的卷和容器。
- Firebird:3050 + N。
- HQ Monitor:20000 + Firebird 端口。
- 集群节点:7051 + N。
- 主机上只能有一个实例运行 RCM。
同一主机上的其他 Firebird 实例遵循相同规则,每个实例都有自己的镜像。
| 实例 1 | 实例 2 | |
|---|---|---|
| 项目与主机名 | hqbird-fb40-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| 端口 | 3051、23051、7052 | 3052、23052、7053 |
- 内存一个空闲实例占用约 200–250 MB。我们验证过:在一台 2 核 4 GB 内存的服务器上运行三个 Firebird 4.0 实例,其中一个处于负载状态。
- 同一主机上 Docker 之外的 Firebird如果主机上已在 Docker 之外运行 Firebird 或 HQbird,请跳过端口 3050、23050 和 7051。
HQCenter · 新镜像 · 集群
更新与集群
你可以通过两种方式更新容器。两种方式都会保留数据。
从 HQCenter 更新
与普通服务器一样:中心会更新容器内的 agent、HQ Monitor、Firebird、集群节点和 RCM。更新后的程序位于卷上,因此重启后仍然保留。
使用新镜像
在 image 行中修改版本号,然后运行:
docker compose pull docker compose up -d
启动时,容器会以更新模式运行新镜像的安装程序。如果中心已将 agent 更新到比镜像中更新的版本,安装程序不会运行:版本不会降级。
集群中的容器
容器中的实例加入集群的方式与服务器相同。成员地址是 Docker 主机的地址。请在 compose.yaml 中发布集群端口。
- 节点端口,例如 7051:当该实例是集群成员时使用。
- 端口 7443 和 7444:当此 agent 运行 RCM 时使用。对于 7444 上的 Web 界面,请在 RCM 设置中将
operator_addr设为0.0.0.0:7444。 - 集群描述中的节点端口必须与已发布的端口一致。
保存集群后,agent 会在几分钟内安装节点。在此之前,节点端口不会响应。
云服务器 · NAT · 防火墙
云服务器上的 HQbird
在云服务器上,你使用普通安装程序安装 HQbird:一个文件,一条命令。Firebird、agent 和控制台都包含在该文件中:安装程序不会下载任何内容。在 Linux 上,它会从发行版仓库获取几个操作系统库(libtommath、ICU)。如果没有仓库,它会打印确切的命令,并且不做任何更改。
- 中心无需入站端口agent 会自行连接到 HQCenter。位于 NAT 之后或私有云网络中的服务器,在中心看来与机架中的服务器完全相同。
- 操作系统防火墙安装程序会在 firewalld 或 ufw 中开放新 Firebird 的端口和 HQ Monitor 端口。云本身的防火墙规则由你设置。
- 服务器要求至少 2 GB 内存、2 核 CPU 和 5 GB 磁盘。Linux x86-64 或 Windows。
- Linux 发行版Ubuntu、Debian、AlmaLinux、Rocky、RHEL、Oracle Linux、openSUSE、RED OS 以及其他使用 apt、dnf、yum 或 zypper 的发行版。
- 通过脚本部署上百台服务器每个安装步骤都提供对应的开关。你可以先查看安装计划:该命令不会做任何更改。
- 机密信息受到保护你在控制台中输入的机密信息会加密发送给 agent。机密信息在报告和配置副本中会被隐藏。在 agent 配置文件中,S3 密钥未加密:请限制对此文件的访问。在 Amazon EC2 服务器上,你可以无需密钥运行:agent 会使用服务器的 IAM 角色。
- 指标接入你的 Grafanaagent 以 Prometheus 格式导出 Firebird 和服务器指标。
- 云磁盘尽在掌控agent 会测量读写延迟,并预测磁盘何时写满。缓慢或即将写满的云磁盘会在健康报告中显示。
限制 · 提示
须知
- Docker 与 ufw已发布的容器端口会绕过 ufw 开放。请使用外部防火墙关闭它,或将其发布到单个地址上。
- 设置仅在首次启动时生效变量和机密信息只读取一次。之后无法更改 Firebird 端口、主机名和机密信息:需要重新安装。你可以在 HQ Monitor 中或从中心更改作业和其他 agent 设置。
- 使用 docker compose exec 的脚本在脚本中,请添加
-T开关和</dev/null。否则,命令会读取标准输入并占用脚本的剩余部分。
- 连接中心之前的警告在 agent 连接到 HQCenter 之前,其日志会显示连接设置不完整。这是正常现象。
- 镜像签名镜像使用 cosign 工具签名。用于通过
cosign verify命令验证镜像的公钥尚未发布。 - 测试环境Ubuntu 22.04、带 Compose 的 Docker、一台 2 核 4 GB 内存的服务器。Ubuntu 的分步安装指南提供俄语和葡萄牙语版本。