クラウドとDocker
クラウド と Docker
HQbird は、自社サーバーと同じようにクラウドサーバー上でも動作します。Docker 用には、各 Firebird ラインに対応した既成のイメージがあります。バックアップはサーバーディスク上にファイルを残さず、直接 S3 に保存されます。センターへの接続にインバウンドポートは不要です。
- 4 イメージ Firebird 5 · 4 · 3 · 2.5
- 1 コンテナ Firebird、エージェント、コンソール
- S3 ディスク上にファイルを残さないバックアップ
- 0 センターへの接続に必要なインバウンドポート
- 200~250 MB アイドル状態のインスタンスあたりのメモリ
サーバー · コンテナ · ストレージ
クラウドインストールの 3 つの構成要素
HQbird は、通常のインストーラーを使ってクラウドサーバーにインストールすることも、Docker コンテナで実行することもできます。どちらの場合も、エージェントは自ら 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 キットのバージョンです。
| イメージ | 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✓ 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 firebirdFirebird 3.0: firebird-superserver サービス |
| isql | docker 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_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ユーザーです。他の 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、7444 | RCM とその 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-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| ポート | 3051, 23051, 7052 | 3052, 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 向けのステップバイステップのインストールガイドはロシア語とポルトガル語で利用できます。