このページは機械翻訳されています。英語の原文をお読みください。 English

クラウド と Docker

HQbird は、自社サーバーと同じようにクラウドサーバー上でも動作します。Docker 用には、各 Firebird ラインに対応した既成のイメージがあります。バックアップはサーバーディスク上にファイルを残さず、直接 S3 に保存されます。センターへの接続にインバウンドポートは不要です。

  • 4 イメージ Firebird 5 · 4 · 3 · 2.5
  • 1 コンテナ Firebird、エージェント、コンソール
  • S3 ディスク上にファイルを残さないバックアップ
  • 0 センターへの接続に必要なインバウンドポート
  • 200~250 MB アイドル状態のインスタンスあたりのメモリ

サーバー · コンテナ · ストレージ

クラウドインストールの 3 つの構成要素

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 に接続します。このためインバウンドポートは不要です。
サーバー

通常のインストーラー

1 つのファイルで Firebird、エージェント、コンソールをクラウドサーバーにインストールします。インストーラー自体は何もダウンロードしません。サーバー全体をデータベース専用にする場合に適しています。

コンテナ

Docker イメージ

1 つのコンテナが、HQbird のすべてのコンポーネントを含む 1 つの Firebird です。データはボリューム上にあり、コンテナやイメージを置き換えても保持されます。

ストレージ

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✓ healthyFirebird とコンソールが応答します
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        # healthy になるまで待機

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 firebird
Firebird 3.0: firebird-superserver サービス
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
1 時間分のログ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ライセンスファイル。
シークレット attachHQCenter からの 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 ユーザーです。他の 4 つのボリュームはホストフォルダに置き換えないでください。
  • ボリュームのバックアップ6 つのボリュームをすべてまとめて保存してください。
  • ホスト名を変更しないでくださいライセンスは state ボリューム上のマシン ID とエージェント名に紐付けられています。新しい state ボリュームは新しいインストールです。
  • 1 つのファイルでセンターに接続attach シークレットは初回起動時にエージェントを HQCenter に接続します。そのためにコンテナに入る必要はありません。

ポート公開 · ファイアウォール · 2 つ目のインスタンス

ポートと複数のインスタンス

各ポートはコンテナの外側と内側で同じ番号で公開してください: 3051:3051 であり、3051:3050 ではありません。エージェントとクラスタはコンテナ内で見えるポートを報告します。

ポート用途必要なとき
HQBIRD_FB_PORT (3050)Firebird常に
20000 + Firebird ポート (23050)HQ Monitor常に
ノードポート (7051)クラスタノードインスタンスがクラスタに参加するとき
7443、7444RCM とその Web インターフェースこのエージェントが RCM を実行するとき。ホストごとに 1 つ

Docker は ufw を迂回してポートを公開します。確認済みです: ufw ルールが「ポート 22 のみ」でも、Firebird と HQ Monitor のポートはインターネットから開いていました。外部ファイアウォールを使用するか、ポートを 1 つのホストアドレスで公開するか ("10.0.0.5:23050:23050")、iptables の DOCKER-USER チェーンにルールを追加してください。

同じホスト上の 2 つ目のインスタンス

各インスタンスには独自のフォルダ、プロジェクト名、ホスト名、ポートが必要です。プロジェクト名がボリューム名を決定します。同じ名前だと、2 回目の起動は 1 つ目のボリュームとコンテナを使用します。

  • Firebird: 3050 + N。
  • HQ Monitor: 20000 + Firebird ポート。
  • クラスタノード: 7051 + N。
  • ホスト上で RCM を実行できるインスタンスは 1 つだけです。

同じホスト上の他の Firebird ラインも同じルールに従い、それぞれ独自のイメージを持ちます。

インスタンス 1インスタンス 2
プロジェクト名とホスト名hqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
ポート3051, 23051, 70523052, 23052, 7053
  • メモリアイドル状態のインスタンス 1 つで約 200~250 MB を使用します。確認済みです。2 コア・4 GB メモリのサーバー上で Firebird 4.0 のインスタンスを 3 つ、そのうち 1 つを負荷状態で稼働させました。
  • 同じホスト上で Docker を使わずに動く Firebirdホスト上で Firebird または HQbird が Docker なしですでに稼働している場合は、ポート 3050、23050、7051 を避けてください。

HQCenter · 新しいイメージ · クラスタ

アップデートとクラスタ

コンテナは 2 つの方法でアップデートできます。どちらもデータは保持されます。

HQCenter から

通常のサーバーと同様です。センターがコンテナ内のエージェント、HQ Monitor、Firebird、クラスタノード、RCM をアップデートします。アップデートされたプログラムはボリューム上にあるため、再起動後も残ります。

新しいイメージで

image 行のバージョンを変更して、次を実行します:

docker compose pull
docker compose up -d

起動時に、コンテナは新しいイメージのインストーラーをアップデートモードで実行します。センターがすでにエージェントをイメージ内のバージョンより新しいバージョンにアップデートしている場合、インストーラーは実行されません。バージョンがダウングレードされることはありません。

クラスタ内のコンテナ

コンテナ内のインスタンスは、サーバーと同じ方法でクラスタに参加します。メンバーのアドレスは Docker ホストのアドレスです。クラスタのポートを compose.yaml で公開してください。

  • ノードポート(例: 7051): インスタンスがクラスタメンバーの場合。
  • ポート 7443 と 7444: このエージェントが RCM を実行する場合。7444 の Web インターフェースには、RCM 設定で operator_addr = 0.0.0.0:7444 を設定してください。
  • クラスタ記述内のノードポートは、公開ポートと一致している必要があります。

エージェントはクラスタを保存してから数分後にノードをインストールします。それまでは、ノードポートは応答しません。

クラスタとレプリケーションの詳細 →

クラウドサーバー · NAT · ファイアウォール

クラウドサーバー上の HQbird

クラウドサーバーでは、HQbird を通常のインストーラーでインストールします。1 ファイル、1 コマンドです。Firebird、エージェント、コンソールはファイル内に含まれているため、インストーラーは何もダウンロードしません。Linux では、ディストリビューションのリポジトリからいくつかの OS ライブラリ(libtommath、ICU)を取得します。リポジトリがない場合は、正確なコマンドを表示し、何も変更しません。

  • センター用のインバウンドポートは不要エージェントは自ら HQCenter に接続します。NAT の背後やプライベートクラウドネットワーク内にあるサーバーも、センターからはラック内のサーバーと同じように見えます。
  • OS ファイアウォールインストーラーは、新しい Firebird のポートと HQ Monitor のポートを firewalld または ufw で開放します。クラウド自体のファイアウォールルールはご自身で設定してください。
  • サーバー要件メモリ 2 GB 以上、2 コア、ディスク 5 GB 以上。Linux x86-64 または Windows。
  • Linux ディストリビューションUbuntu、Debian、AlmaLinux、Rocky、RHEL、Oracle Linux、openSUSE、RED OS など、apt、dnf、yum、zypper を備えたもの。
  • スクリプトで 100 台のサーバーすべてのインストール手順はスイッチとして利用できます。最初にインストール計画を表示できます。そのコマンドは何も変更しません。
  • シークレットは保護されますコンソールで入力したシークレットは、暗号化されてエージェントに送られます。シークレットはレポートや設定のコピーでは非表示になります。エージェント設定ファイル内の S3 キーは暗号化されません。このファイルへのアクセスを制限してください。Amazon EC2 サーバーでは、キーなしで運用できます。エージェントはサーバーの IAM ロールを使用します。
  • Grafana でメトリクスを確認エージェントは Firebird とサーバーのメトリクスを Prometheus 形式でエクスポートします。
  • クラウドディスクを管理エージェントは読み取りと書き込みのレイテンシを測定し、ディスクがいつ満杯になるかを予測します。遅いクラウドディスクやほぼ満杯のクラウドディスクは、ヘルスレポートで確認できます。

インストールとアップデートの詳細 →

制限 · ヒント

知っておくとよいこと

  • Docker と ufw公開されたコンテナポートは ufw を迂回して開きます。外部ファイアウォールで閉じるか、1 つのアドレスでのみ公開してください。
  • 設定は初回起動時のみ変数とシークレットは一度だけ読み込まれます。Firebird のポート、ホスト名、シークレットは後から変更できません。新しいインストールが必要です。ジョブやその他のエージェント設定は、HQ Monitor またはセンターから変更します。
  • docker compose exec を使うスクリプトスクリプトでは、-T スイッチと </dev/null を追加してください。これらがないと、コマンドは標準入力を読み取り、スクリプトの残りを消費してしまいます。
  • センターへの接続前の警告エージェントが HQCenter に接続するまで、ログに接続設定が不完全であると表示されます。これは正常です。
  • イメージの署名イメージは cosign ツールで署名されています。cosign verify コマンドで検証するための公開鍵はまだ公開されていません。
  • テスト環境Ubuntu 22.04、Compose 付き Docker、2 コア・4 GB メモリのサーバー。Ubuntu 向けのステップバイステップのインストールガイドはロシア語とポルトガル語で利用できます。

← HQbird 2027 の概要に戻る