HQbird 2027 in Docker: 管理者ガイド
このガイドは、Docker で HQbird 2027 を運用する管理者向けです。1 つのコンテナは、HQbird の全コンポーネントを備えた 1 つの Firebird インスタンスです。
- Firebird(1 つの系統の 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。
Ubuntu 22.04.5(2 vCPU / 4 GB)、Docker 29.10.0、Compose 5.7.1、イメージ hqbird2027-fb40:2027.2.33 で 2026-11-16 に検証しました(最初の検証: 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 のイメージで検証しました。2 つの「ホスト」は 1 台の仮想マシンの 2 つのアドレスであり、また 2 台の別々の Docker ホスト(2 つの droplet、4.0 イメージ 2027.2.33)でも検証しました。2026-11-17 には、残りの項目を 2 台の 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 -f2 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 はそのアドレスを見ます。1 台の 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、セットアップ状態、実行時に作られる OS アカウント(RCM のサービスユーザー) |
trust |
/usr/libexec/hqbird-fbagent |
エージェントの更新ランチャーと trust |
rootwork |
/var/lib/hqbird-fbagent |
更新ランチャーの作業フォルダ |
db |
/db |
データベース(データベースはここに置きます) |
backup |
/backup |
バックアップ |
opt、state、trust、rootwork にホストのフォルダをマウントしないでください。db と backup にはホストのフォルダを使えます。イメージの firebird ユーザーである uid 84 に与えます。
chown 84:84 /srv/hqbird/db /srv/hqbird/backup6 つのボリュームは、まとめてバックアップします。
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. 更新
更新の方法は 2 つあります。どちらもデータを残します。
-
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 までのイメージには、ここに 2 つの不具合があります。セクション 9 を参照してください。
7. クラスタ
クラスタを作る方法は 2 つあります。1 つのコンテナで混ぜないでください。
7.1. HQCenter なし: ロールを持つ 2 つのコンテナ
一方のコンテナが master で、コンソール付きのクラスタマネージャ(RCM)を実行します。もう一方は replica です。ロールは初回起動の設定 HQBIRD_CLUSTER_ROLE です。これがないと、コンテナは RCM もクラスタノードも実行せず、ペアリングポートも開きません。ロールには、イメージ 2027.2.33 以降が必要です。
2 台の Docker ホスト。 2 つのコンテナに異なるホスト名を与えます(.env の HQBIRD_HOSTNAME、または hostname:)。同じホスト名だと、2 つのエージェントの 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 に 2 行を書きます。
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 オプションを省くには、.env に COMPOSE_FILE=compose.yaml:compose.master.yaml(または ...replica.yaml)を入れます。
1 台の 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 の Firebird は 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 のサービス)では、各ホストに 2 つ目のノードと、その公開ポートが必要です。セクション 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. 2 つのコンテナの間のスイッチオーバー
RCM のサービスは、データベースの master ロールを、一方のホストから他方へ移します。サービスでは、各ホストに2 つのノードが必要です。master ノードと replica ノードです。Link hosts は各ホストにノードを 1 つ与えるので、2 つ目のノードは自分で追加します。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' "$@"; }-
2 つ目のノードポートを公開します。両方のホストで、ノードポート + 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)。 -
2 つ目のノードを追加します。クラスタ文書へ、replica ホスト上の master ノードと、master ホスト上のその replica ノードを追加します。どちらも
listen_portは 7061 です。文書を読み、メンバーを 2 つとリンクを 1 つ追加し、リビジョンを付けて送り返します。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その後、エージェントは 2 つのノードサービスをインストールします(2 台のホストでの検証では 30 秒。数分かかることもあります)。 その後、
docker compose exec hqbird systemctl list-units --type=serviceを実行すると、各コンテナにhqclusternodeサービスが 2 つ表示されます。次に、両方の 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 です。2 つ目のホスト上のパスは、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 に追従する 1 つのアドレスをアプリケーションに与えます。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 の半数より多くが報告しなければならず、2 つのうち 1 つは失われたホスト上にあるためです。
- RCM は master コンテナの中で動きます。そのホストが失われると RCM も失われ、master を自分で移すものは何もありません。
8. ポート、ファイアウォール、2 つ目のインスタンス
各ポートは、コンテナの外と中で同じ番号で公開します(3051:3051。3051:3050 ではありません)。エージェントとクラスタは、コンテナの内側で見ているポートを報告します。
| ポート | 内容 | 必要なとき |
|---|---|---|
HQBIRD_FB_PORT(3050) |
Firebird | 常に |
| 20000 + Firebird ポート(23050) | HQ Monitor | 常に |
ノードの listen_port(7051) |
クラスタノード | クラスタのメンバー |
| ノードポート + 10(7061) | ホストの 2 つ目のノード | スイッチオーバーのあるサービス(セクション 7.3) |
| 7443、7444 | RCM、RCM オペレータコンソール | このエージェントが RCM であるとき(ホストあたり 1 つ) |
| ペアリングポート(7450) | エージェントのペアリングポート | ロールを持つ replica。リンクされるまで |
エージェントは、自分から HQCenter に接続します(送信)。受信ポートは不要です。
Docker は ufw を越えてポートを公開します。 検証では、ufw がポート 22 だけを許可していても、Firebird と HQ Monitor のポートはインターネットから開いていました。外部ファイアウォールを使うか、1 つのホストアドレスへ公開するか("10.0.0.5:23050:23050")、iptables のチェーン DOCKER-USER にルールを追加してください。
1 台のホスト上の 2 つ目のインスタンスには、専用のフォルダ、プロジェクトの name:、hostname、HQBIRD_FB_PORT、ポートが必要です。プロジェクト名がボリューム名を作ります(<name>_opt、…)。同じ名前だと、2 回目の起動は、最初のインスタンスのボリュームとコンテナを使います。
| インスタンス 1 | インスタンス 2 | |
|---|---|---|
name:、hostname: |
hqbird-fb40-3051 |
hqbird-fb40-3052 |
HQBIRD_FB_PORT |
3051 | 3052 |
ports: |
3051、23051、7052 | 3052、23052、7053 |
1 つの外部 IP 上の N インスタンスのルール:
- Firebird は
3050 + N、HQ Monitor は20000 +Firebird のポート、クラスタノードは7051 + N(HQCenter で同じlisten_portを設定します)。ホストがすでに Docker の外で Firebird または HQbird を動かしている場合は、3050、23050、7051 を飛ばします。 - ホストあたり、RCM になれるインスタンスは 1 つだけです(7443、7444)。
- クラスタロール(セクション 7.1)では、ホストの各インスタンスに専用のスロットが必要です。2 つ目は
HQBIRD_PAIRING_PORT=7451とHQBIRD_NODE_PORT=7052、3 つ目は7452と7053です。 - 1 つのインスタンスは、負荷がない状態で約 200-250 MB のメモリを使います。検証: 2 vCPU / 4 GB 上の FB 4.0 インスタンス 3 つ。うち 1 つに負荷。
- 同じホスト上の他の Firebird 系統も、専用のイメージ(
hqbird2027-fb50、…)と名前(hqbird-fb50-3054)で、同じルールに従います。
最初のインスタンスの compose.yaml からインスタンスを追加します(ここでは 3 つ目: 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 以降を使ってください。より古いイメージのコンテナでは、信頼しないユーザーにシェルアクセスを与えないでください。 - 2027.2.32 までのイメージ: 手作業で作った RCM は、新しいコンテナで起動しません。 コンテナ内で
fbagent --cluster-initによって RCM を作ると、エージェントは OS アカウント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/。