此页面为机器翻译。请阅读英文原文。 English

云 与 Docker

HQbird 在云服务器上的运行方式与在您自己的服务器上完全相同。对于 Docker,每条 Firebird 产品线都有现成的镜像。备份直接写入 S3,服务器磁盘上不产生文件。与中心的连接无需入站端口。

  • 4 个镜像 Firebird 5 · 4 · 3 · 2.5
  • 1 个容器 Firebird、代理和控制台
  • S3 备份,磁盘上不产生文件
  • 0 与中心连接所需的入站端口
  • 200–250 MB 每个空闲实例的内存占用

服务器 · 容器 · 存储

云安装的三个部分

您可以使用常规安装程序在云服务器上安装 HQbird,也可以在 Docker 容器中运行它。两种情况下,代理都会自行连接到 HQCenter,备份可以写入 S3 存储。

示意图:应用程序和浏览器连接到主机上的 HQbird 容器;代理自行连接到 HQCenter 并将备份发送到 S3 cloud server or Docker host HQbird Firebird fbagent HQ Monitor volumes: /db · /backup · /opt ports: 3050 · 23050 cluster: 7051 · 7443 · 7444 Clients Firebird port 3050 Browser HQ Monitor 23050 HQCenter agent connects out S3 backups, HTTPS
谁连接到谁。应用程序和浏览器通过 Firebird 和 HQ Monitor 端口接入。代理自行连接到 HQCenter 和 S3:此过程无需入站端口。
服务器

常规安装程序

一个文件即可在云服务器上安装 Firebird、代理和控制台。安装程序本身不下载任何内容。当整台服务器都用于数据库时,这是理想选择。

容器

Docker 镜像

一个容器就是一个 Firebird,包含所有 HQbird 组件。数据存放在卷上,替换容器或镜像时数据会保留。

存储

备份到 S3

gbak 和 nbackup 写入流,流再写入存储桶。备份不需要服务器磁盘空间。在服务器和容器中均可使用。

备份页面上的更多内容 →

镜像 · 首次启动 · compose

Docker 中的 HQbird

容器使用与服务器相同的安装程序安装 HQbird。Firebird、fbagent 代理和 HQ Monitor 在容器内运行。当实例加入集群时,代理会自行安装集群节点。仅当此实例被指定为集群 RCM 时,才会安装 RCM。

镜像位于 IBSurgeon GitHub Container Registry。它们是公开的:您无需登录注册表。镜像标签即 HQbird 套件的版本。

镜像FirebirdFirebird 端口HQ Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050

首次启动

  1. 1compose.yaml从套件中复制到主机上的文件夹
  2. 2SYSDBA 密码写入只有您可读的密钥文件
  3. 3镜像、名称、密钥设置 image 和 hostname,去掉 secrets: 行中的 #
  4. 4docker compose up -d容器将安装 HQbird
  5. 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
重启 Firebirddocker compose exec hqbird systemctl restart firebird
Firebird 3.0:firebird-superserver 服务
isqldocker 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_passwordHQ Monitor 登录名和密码。
HQBIRD_TRIAL_EMAIL、HQBIRD_TRIAL_ZONE申请试用许可证。
密钥 sysdba_password新 Firebird 的 SYSDBA 密码。
密钥 license许可证文件。
密钥 attach来自 HQCenter 的 attach.json 文件:它将代理连接到你的中心。
卷路径内容
db/db数据库。将你的数据库放在这里。
backup/backup备份。
opt/optFirebird、代理、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、7444RCM 及其 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-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
端口3051、23051、70523052、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 的分步安装指南提供俄语和葡萄牙语版本。

← 返回 HQbird 2027 概览