表題の通り、以前に見つけていてずっと触りたかった immortal という Go 製の daemon 管理ツールをやっとこさ試すことができたのでメモ。名前がエモくて良いですね。
immortal について
公式ドキュメント には以下のように記載されています。
immortal runs a command or script detached from the controlling terminal as a Unix daemon, it will supervise and restart the service if it has been terminated.
ざっくり訳すと、
immortal は、コマンドやスクリプトを制御中のターミナルから Unix daemon としてデタッチする。また、サービスを監視し、それが終了された場合は再起動する。
という感じでしょうか。
自分にとっての daemon 管理ツールの定番は daemontools なのですが、これとだいたい同じような挙動をしてくれそうです。
それでは以下、実際に触りつつ基本的な挙動を把握していきます。基本的には 公式ドキュメント を参考にしているので、詳細な説明はそちらをご覧ください。
インストールする
今回は Ubuntu 16.04 にインストールしてみます。
$ cd /tmp
$ wget https://github.com/immortal/immortal/releases/download/0.18.0/immortal_0.18.0_amd64.deb
...
$ sudo dpkg -i immortal_0.18.0_amd64.deb
...
バージョンを確認します。
$ immortal -v
0.18.0
immortal だけでも daemonize は可能なのですが、今回は immortaldir を利用し、設定ファイルベースでの監視まで行ってみようと思います（daemontools の svscan のようなイメージです）。
ということで、設定ファイルを設置するディレクトリ（監視対象）を作成しておきます。
$ sudo mkdir /usr/local/etc/immortal
また、systemd 経由で制御できるよう、以下の内容で /etc/systemd/system/immortaldir.service を作成します。
[Unit]
Description=immortaldir
After=network.target
[Service]
ExecStart=/usr/bin/immortaldir /usr/local/etc/immortal 2>&1 | logger -t immortaldir
KillMode=process
Restart=always
Restart=on-failure
Type=simple
User=root
[Install]
WantedBy=multi-user.target
これで基本的な設定は終わりです。まだ設定ファイルは何もありませんが、先に監視を開始しておきます。
$ sudo systemctl start immortaldir
$ sudo systemctl enable immortaldir
btcd を daemonize してみる
試しに btcd を daemonize してみます。
btcd を実行するための app ユーザーを作成し、btcd をインストールします。インストール方法については こちらのエントリ をご覧ください。
インストールが終わったら、以下の内容で /home/app/.btcd/btcd.conf を作成します。
[Application Options]
simnet=1
datadir=/home/app/.btcd/data
logdir=/home/app/.btcd/logs
rpcuser=btcd
rpcpass=btcd
txindex=1
今回は daemonize の検証がしたいだけなので、お手軽に simnet で立ち上げます。
次に、immortaldir 用の設定ファイルを /usr/local/etc/immortal/btcd.yml で作成します。各設定の意味は 公式ドキュメント に記載されているので、ここでは割愛します。
cmd: /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
cwd: /home/app
env:
HOME: /home/app
log:
file: /var/log/btcd.log
age: 86400
num: 7
size: 1
timestamp: true
user: app
immortaldir が /usr/local/etc/immortal/ を監視しているので、自動的にファイルが認識され、btcd が起動します。
root 6678 0.0 0.3 47460 6380 ? Ssl 16:36 0:00 immortal -c /usr/local/etc/immortal/btcd.yml -ctl btcd
app 6682 0.4 0.8 178432 17684 ? Sl 16:36 0:00 \_ /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
immortal が supervisor となり、子プロセスの btcd を監視しているようです。念のため、btcd に対してコマンドが通るかも確認しておきます。
$ btcctl --simnet getinfo
{
"version": 120000,
"protocolversion": 70002,
"blocks": 0,
"timeoffset": 0,
"connections": 0,
"proxy": "",
"difficulty": 1,
"testnet": false,
"relayfee": 0.00001,
"errors": ""
}
daemon の情報は immortalctl を利用することでも確認できます。status コマンドを実行してみます。
$ sudo immortalctl status
PID Up Down Name CMD
6682 51.0s btcd /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
Up で起動からの経過時間が確認できます。
起動が確認できたので、次は徐ろに btcd を終了させてみます。immortal が監視してくれているので、すぐに再起動されるはずです。
$ btcctl --simnet stop
btcd stopping.
再起動されているか確認します。
$ sudo immortalctl status
PID Up Down Name CMD
6702 2.2s btcd /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
PID が新しくなり、Up もリセットされました。
root 6678 0.0 0.3 47460 6380 ? Ssl 16:36 0:00 immortal -c /usr/local/etc/immortal/btcd.yml -ctl btcd
app 6702 0.4 1.1 240796 22720 ? Sl 16:37 0:00 \_ /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
次に、halt コマンドを実行して再起動してみます。なお、halt コマンドの挙動は以下のようになっているようです。
Stop the service by sending a TERM signal and exit the supervisor, if using immortaldir(8) the service will be restarted, first will be stopped and immortaldir(8) will start it up again.
supervisor である immortal も終了させ、immortaldir によって再起動が行われるようです。実際にやってみます。
$ sudo immortalctl halt btcd
PID Up Down Name CMD
$ sudo immortalctl status
PID Up Down Name CMD
6736 0.7s btcd /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
PID が変わり、Up もリセットされました。immortal の PID も変わっています。
root 6732 0.0 0.3 121192 6928 ? Ssl 16:38 0:00 immortal -c /usr/local/etc/immortal/btcd.yml -ctl btcd
app 6736 0.4 0.8 243968 17784 ? Sl 16:38 0:00 \_ /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
daemon を停止させたい（再起動もさせたくない）場合は stop コマンドを実行します。
$ sudo immortalctl stop btcd
PID Up Down Name CMD
6736 1m12.5s btcd /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
$ sudo immortalctl status
PID Up Down Name CMD
6736 23.2s btcd /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
Up が表示されなくなり、代わりに Down（停止からの経過時間）が表示されました。immortal の子プロセスも消えています。
root 6732 0.0 0.3 121192 6928 ? Ssl 16:38 0:00 immortal -c /usr/local/etc/immortal/btcd.yml -ctl btcd
もう一度 btcd を起動するには start コマンドを実行します。
$ sudo immortalctl start btcd
PID Up Down Name CMD
6768 0.0s btcd /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
$ sudo immortalctl status
PID Up Down Name CMD
6768 23.6s btcd /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
再び Up が表示され、immortal の子プロセスも復活したようです。
root 6732 0.0 0.3 121192 6928 ? Ssl 16:38 0:00 immortal -c /usr/local/etc/immortal/btcd.yml -ctl btcd
app 6768 0.7 1.2 186628 25952 ? Sl 16:40 0:00 \_ /home/app/go/bin/btcd --configfile=/home/app/.btcd/btcd.conf
まとめ
- Go 製の daemon 管理ツール immortal で btcd を daemonize してみました
- immortalctl を用いて daemon に対して基本的な管理操作を実行しつつ、その挙動を確認しました