インストール
Mikagami は RPM で導入します。配布している RPM は Rocky Linux 10(el10)の aarch64 版だけです。
| 配布物 | 場所 |
|---|---|
RPM・ソース RPM・チェックサム(SHA256SUMS) |
GitHub Releases(v0.8.0) |
| ソースコード | github.com/hagix9/mikagami-public |
試験の実績は Rocky Linux 10.2(aarch64)です。Rocky Linux 9 と x86_64 の RPM は配布しておらず、未検証です(検証状況)。RPM に署名はありません。ダウンロードした後に SHA-256 を確かめてください。
ダウンロードと確認
Section titled “ダウンロードと確認”base=https://github.com/hagix9/mikagami-public/releases/download/v0.8.0curl -LO "$base/mikagami-0.8.0-1.el10.aarch64.rpm"curl -LO "$base/SHA256SUMS"sha256sum -c SHA256SUMS --ignore-missingmikagami-0.8.0-1.el10.aarch64.rpm: OK と出ることを確かめます。
ソースから RPM を作る(他の環境)
Section titled “ソースから RPM を作る(他の環境)”Rocky Linux 9 や x86_64 では、ソースから RPM を作ります(未検証)。ビルドには Rocky Linux(el9 なら el9、el10 なら el10)のホストと、rpm-build、systemd-rpm-macros、gcc、python3、Rust(rust-toolchain.toml で固定した版)が要ります。
git clone https://github.com/hagix9/mikagami-public.git && cd mikagami-public# ソースの tarball(依存のソースを含む)を作る(macOS でも可)packaging/rpm/build.sh sources --out ~/mkg-rpm# RPM を作る(Rocky Linux で)packaging/rpm/build.sh rpm --out ~/mkg-rpmel10 で作った RPM は glibc 2.39 を要するので、el9 では el9 で作ってください。
dnf install ./mikagami-0.8.0-1.el10.aarch64.rpm入るもの:
| path | 内容 |
|---|---|
/usr/bin/mikagami、/usr/bin/mkg |
CLI と daemon(mkg は同じプログラム) |
/usr/lib/systemd/system/mikagami.service |
ノードの daemon |
/usr/lib/systemd/system/mikagami-witness.service |
補助ノード(Witness)の daemon |
/usr/libexec/mikagami/check-http |
HTTP のヘルスチェックの script |
/etc/mikagami/mikagami.toml、witness.toml |
注釈だけの雛形(そのままでは起動を拒否します) |
/usr/share/licenses/mikagami/ |
LICENSE(Apache-2.0)と第三者のライセンス |
/usr/share/doc/mikagami/ |
文書と設定例 |
依存:/usr/sbin/arping(iputils)、/usr/bin/curl、systemd。
mikagami --versionmkg --versionsystemctl is-enabled mikagami # disabled(自動では有効にしません)共有鍵(PSK)
Section titled “共有鍵(PSK)”2 台(補助ノード付き構成では 3 台)で同じ共有鍵を使います。1 台で作り、他のノードへ安全に写します。
umask 077head -c 32 /dev/urandom | od -An -tx1 | tr -d ' \n' > /etc/mikagami/cluster.pskchmod 600 /etc/mikagami/cluster.psk形式は 64 文字の 16 進数、mode 0600、所有者 root です。
- 両ノードで
systemctl stop mikagami、補助ノード(Witness)ではsystemctl stop mikagami-witnessで HA を止めます。 dnf upgrade ./mikagami-0.8.0-N.el10.aarch64.rpm/etc/mikagami/*.rpmnewがあれば差分を確かめます。- 起動します(補助ノード付き構成では 補助ノード → node-b → node-a の順)。
版の混在した 2 台での運転(rolling upgrade)はできません。
systemctl stop mikagami # 補助ノードでは mikagami-witnessdnf remove mikagami/var/lib/mikagami* の状態と、編集した設定(.rpmsave)は残ります。