実際に触ってみたら操作はとてもシンプルでした。プロセス制御システム である Supervisor を実際に動かしてみて、デーモン化に触れてみました。

Supervisor を実際に操作してデーモン化に触れてみる

プロセス制御システム である Supervisor を実際に動かしてみて、彼のことを理解しようとしてみました。 （内容はメモ書き扱いということで、網羅性はありません）
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#supervisor%E3%82%B9%E3%83%BC%E3%83%91%E3%83%BC%E3%83%90%E3%82%A4%E3%82%B6%E3%83%BC">Supervisor（スーパーバイザー）</a></li>
<li><a href="#%E5%AE%9F%E8%A1%8C%E7%92%B0%E5%A2%83">実行環境</a></li>
<li><a href="#%E7%AE%A1%E7%90%86%E5%AF%BE%E8%B1%A1%E3%82%92%E8%A8%AD%E5%AE%9A%E3%81%99%E3%82%8B">管理対象を設定する</a></li>
<li><a href="#supervisorctl-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">supervisorctl コマンド</a></li>
<li><a href="#%E7%AE%A1%E7%90%86%E5%AF%BE%E8%B1%A1%E3%81%AE%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9%E3%81%AE%E7%8A%B6%E6%85%8B%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B">管理対象のプロセスの状態を確認する</a></li>
<li><a href="#%E7%AE%A1%E7%90%86%E5%AF%BE%E8%B1%A1%E3%82%92%E5%86%8D%E8%B5%B7%E5%8B%95%E3%81%99%E3%82%8B">管理対象を再起動する</a></li>
<li><a href="#%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9%E3%82%92%E8%90%BD%E3%81%A8%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B">プロセスを落としてみる</a></li>
<li><a href="#%E8%A8%AD%E5%AE%9A%E3%82%92%E5%A4%89%E6%9B%B4%E3%81%97%E3%81%A6%E5%8F%8D%E6%98%A0%E3%81%99%E3%82%8B">設定を変更して反映する</a></li>
<li><a href="#%E4%B8%80%E5%BA%A6-remove-%E3%81%97%E3%81%A6%E3%81%8B%E3%82%89%E5%86%8D%E5%BA%A6-add-%E3%81%99%E3%82%8B">一度 remove してから再度 add する</a></li>
<li><a href="#%E3%82%B9%E3%83%86%E3%83%BC%E3%82%BF%E3%82%B9%E3%81%8C-fatal-%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%9F%E3%82%82%E3%81%AE%E3%82%92%E5%86%8D%E5%BA%A6%E8%B5%B7%E5%8B%95%E3%81%95%E3%81%9B%E3%82%8B">ステータスが FATAL になったものを再度起動させる</a></li>
</ol>
<h2 id="supervisorスーパーバイザー">Supervisor（スーパーバイザー）</h2>
Supervisor 
<a href="http://supervisord.org/" rel="noopener noreferrer" target="_blank">http://supervisord.org/</a>
<blockquote>
スーパーバイザーは、ユーザーがUNIXライクなオペレーティングシステム上の多数のプロセスを監視および制御できるようにするクライアント/サーバーシステムです。
</blockquote>
プロセスを監視して、落ちたら起動し直してくれたりするツール。
Supervisor を起動すると、設定している管理対象も一緒に起動してくれる。
<h2 id="実行環境">実行環境</h2>
linux 環境があれば良いので Docker で適当に作成
<dl class="description_setting">
<dt>Dockerfile</dt>
<dd>
<pre><code class="hljs language-dockerfile">FROM amazonlinux:latest

# EPEL インストール
RUN amazon-linux-extras install -y epel

# supervisord インストール
RUN yum install -y supervisor

# 設定ファイル設置
COPY nginx.ini /etc/supervisord.d/nginx.ini
</code></pre>
</dd>
</dl>
イメージをビルドして
<pre><code class="hljs language-shell"># イメージをビルド
docker build -t amazon_linux_20210417 .
</code></pre>
コンテナを起動する
<pre><code class="hljs language-shell"># コンテナ起動
docker run -d --privileged amazon_linux_20210417 /sbin/init

# コンテナ ID 出力
-> e17xxxxxxxxxxxxxxxxxxxxxxxx
</code></pre>
出力されたコンテナ ID を指定してコンテナの中に入る
<pre><code class="hljs language-shell"># コンテナの中に入る
docker exec -it e17 /bin/bash
</code></pre>
Supervisor の起動完了
<pre><code class="hljs language-shell"># バージョン確認
$ supervisorctl version
3.4.0
</code></pre>
<h2 id="管理対象を設定する">管理対象を設定する</h2>
nginx を管理対象にして操作していく。
<dl class="description_setting">
<dt>nginx.ini</dt>
<dd>
<pre><code class="hljs language-shell">[program:nginx]
command=/usr/sbin/nginx -g "daemon off;"
autostart=true
autorestart=true
</code></pre>
</dd>
</dl>
.ini じゃなくて .conf が良ければ、supervisord.conf の最下部に include があるのでそこを変更する。
<dl class="description_setting">
<dt>/etc/supervisord.conf</dt>
<dd>
<pre><code class="hljs language-shell">[include]
files = supervisord.d/*.ini
</code></pre>
</dd>
</dl>
<h2 id="supervisorctl-コマンド">supervisorctl コマンド</h2>
スーパーバイザーを操作するには supervisorctl コマンドを使っていく。
Running supervisorctl - Supervisor 公式 
<a href="http://supervisord.org/running.html#supervisorctl-command-line-options" rel="noopener noreferrer" target="_blank">http://supervisord.org/running.html#supervisorctl-command-line-options</a>
<h2 id="管理対象のプロセスの状態を確認する">管理対象のプロセスの状態を確認する</h2>
supervisorctl status ... で管理対象のプロセスの状態を確認できる
<pre><code class="hljs language-shell">status &#x3C;name> 単一プロセスのステータスを取得する
status &#x3C;gname>:* グループ内のすべてのプロセスのステータスを取得する
status &#x3C;name> &#x3C;name> 複数の名前付きプロセスのステータスを取得する
status すべてのプロセスステータス情報を取得する
</code></pre>
nginx の状態を確認してみます。
<pre><code class="hljs language-shell">$ supervisorctl status
nginx RUNNING pid 136, uptime 0:34:04
</code></pre>
RUNNING しっかり動いてる。
<h2 id="管理対象を再起動する">管理対象を再起動する</h2>
supervisorctl restart ... でプロセスの再起動ができる
<pre><code class="hljs language-shell">restart &#x3C;name> プロセスを再起動します
restart &#x3C;gname>:* グループ内のすべてのプロセスを再起動します
restart &#x3C;name> &#x3C;name> 複数のプロセスまたはグループを再起動します
</code></pre>
nginx を再起動してみます。
<pre><code class="hljs language-shell"># 再起動を実行
$ supervisorctl restart nginx
nginx: stopped
nginx: started

# ログ
2021-04-17 07:12:27,752 INFO waiting for nginx to stop
2021-04-17 07:12:27,767 INFO stopped: nginx (exit status 0)
2021-04-17 07:12:27,771 INFO spawned: 'nginx' with pid 152
2021-04-17 07:12:37,814 INFO success: nginx entered RUNNING state, process has stayed up for > than 10 seconds (startsecs)
</code></pre>
再起動されました。
<h2 id="プロセスを落としてみる">プロセスを落としてみる</h2>
プロセスを何度か落としてみましたが、何度でも這い上がってくる感じがさすがデーモン化といったところ。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/224/kX0JnuwhLes94OSL97H6.png" width="1200" height="905" alt="何度プロセスを落としても起動するnginx"></div>
これがスーパーバイザーの力か。恐るべしデーモン閣下。
<h2 id="設定を変更して反映する">設定を変更して反映する</h2>
nginx の管理設定項目を変更してそれを適用させてみます。
設定ファイルを変更しただけでは適応されないので反映してあげる必要がある。
<dl class="description_setting">
<dt>/etc/supervisord.d/nginx.ini</dt>
<dd>
<pre><code class="hljs language-shell">[program:nginx]
command=/usr/sbin/nginx -g "daemon off;"
autostart=true
autorestart=true

# 起動後設定値（秒）より早くプロセスが終了した場合は起動失敗とする
startsecs=10

# 起動失敗時のリトライ回数。この回数を超えると FATAL 状態となり起動施行をストップする
startretries=2
</code></pre>
</dd>
</dl>
下の 2 を新たに設定値に加えました。
startsecs 起動後設定値（秒）より早くプロセスが終了した場合は起動失敗とする startretries 起動失敗時のリトライ回数。この回数を超えるとステータスが FATAL になって起動をストップする Section Settings 
<a href="http://supervisord.org/configuration.html#program-x-section-settings" rel="noopener noreferrer" target="_blank">http://supervisord.org/configuration.html#program-x-section-settings</a>
変更を反映するには update を使う。プロセスが再起動されて新しい設定値も読み込まれる。
<pre><code class="hljs language-shell">$ supervisorctl update nginx
nginx: stopped
nginx: updated process group
</code></pre>
<h2 id="一度-remove-してから再度-add-する">一度 remove してから再度 add する</h2>
nginx を Supervisor の管理対象から外したのち、再度管理対象にしてみます。
stop でプロセスを止めます。
<pre><code class="hljs language-shell">$ supervisorctl stop nginx
nginx: stopped
</code></pre>
remove で管理対象から外します。
<pre><code class="hljs language-shell">$ supervisorctl remove nginx
nginx: removed process group
</code></pre>
この状態から start でプロセスを開始させようとすると、管理対象から外れているのでエラーになります。
<pre><code class="hljs language-shell">$ supervisorctl start nginx
nginx: ERROR (no such process)
</code></pre>
再度管理対象とするには add を使います。
<pre><code class="hljs language-shell">$ supervisorctl add nginx
nginx: added process group
</code></pre>
再度 nginx が起動します。
ちなみに、remove していようが Supervisor 自体を再起動したら起動します。
<h2 id="ステータスが-fatal-になったものを再度起動させる">ステータスが FATAL になったものを再度起動させる</h2>
起動に失敗して FATAL になった管理対象ってどうやって復帰させるんだろう。という事で確認。
現在、FATAL の状態
<pre><code class="hljs language-shell">$ supervisorctl status
nginx FATAL Exited too quickly (process log may have details)
</code></pre>
手動で起動させるには start で行う
<pre><code class="hljs language-shell">start &#x3C;name> プロセスを開始します
start &#x3C;gname>:* グループ内のすべてのプロセスを開始します
start &#x3C;name> &#x3C;name> 複数のプロセスまたはグループを開始する
start all すべてのプロセスを開始します
</code></pre>
nginx を起動してみます。
<pre><code class="hljs language-shell">$ supervisorctl start nginx
nginx: started
</code></pre>
FATAL ステータスの nginx を起動できました。
<h2 id="まとめ">まとめ</h2>
Supervisor 実際に触ってみたら操作はとてもシンプルでした。
supervisorctl コマンドは add/start とか、reload/reread/update みたいな、シンプルゆえに雰囲気で触ってると意外とどれがどういう動きをするのかわからないなと思ったので、実際に触ってみて確認して理解が深まったことは収穫でした。

プロセス制御システム である Supervisor を実際に動かしてみて、彼のことを理解しようとしてみました。 （内容はメモ書き扱いということで、網羅性はありません）
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#supervisor%E3%82%B9%E3%83%BC%E3%83%91%E3%83%BC%E3%83%90%E3%82%A4%E3%82%B6%E3%83%BC">Supervisor（スーパーバイザー）</a></li>
<li><a href="#%E5%AE%9F%E8%A1%8C%E7%92%B0%E5%A2%83">実行環境</a></li>
<li><a href="#%E7%AE%A1%E7%90%86%E5%AF%BE%E8%B1%A1%E3%82%92%E8%A8%AD%E5%AE%9A%E3%81%99%E3%82%8B">管理対象を設定する</a></li>
<li><a href="#supervisorctl-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">supervisorctl コマンド</a></li>
<li><a href="#%E7%AE%A1%E7%90%86%E5%AF%BE%E8%B1%A1%E3%81%AE%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9%E3%81%AE%E7%8A%B6%E6%85%8B%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%99%E3%82%8B">管理対象のプロセスの状態を確認する</a></li>
<li><a href="#%E7%AE%A1%E7%90%86%E5%AF%BE%E8%B1%A1%E3%82%92%E5%86%8D%E8%B5%B7%E5%8B%95%E3%81%99%E3%82%8B">管理対象を再起動する</a></li>
<li><a href="#%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9%E3%82%92%E8%90%BD%E3%81%A8%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B">プロセスを落としてみる</a></li>
<li><a href="#%E8%A8%AD%E5%AE%9A%E3%82%92%E5%A4%89%E6%9B%B4%E3%81%97%E3%81%A6%E5%8F%8D%E6%98%A0%E3%81%99%E3%82%8B">設定を変更して反映する</a></li>
<li><a href="#%E4%B8%80%E5%BA%A6-remove-%E3%81%97%E3%81%A6%E3%81%8B%E3%82%89%E5%86%8D%E5%BA%A6-add-%E3%81%99%E3%82%8B">一度 remove してから再度 add する</a></li>
<li><a href="#%E3%82%B9%E3%83%86%E3%83%BC%E3%82%BF%E3%82%B9%E3%81%8C-fatal-%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%9F%E3%82%82%E3%81%AE%E3%82%92%E5%86%8D%E5%BA%A6%E8%B5%B7%E5%8B%95%E3%81%95%E3%81%9B%E3%82%8B">ステータスが FATAL になったものを再度起動させる</a></li>
</ol>
<h2 id="supervisorスーパーバイザー">Supervisor（スーパーバイザー）</h2>
Supervisor 
<a href="http://supervisord.org/" rel="noopener noreferrer" target="_blank">http://supervisord.org/</a>
<blockquote>
スーパーバイザーは、ユーザーがUNIXライクなオペレーティングシステム上の多数のプロセスを監視および制御できるようにするクライアント/サーバーシステムです。
</blockquote>
プロセスを監視して、落ちたら起動し直してくれたりするツール。
Supervisor を起動すると、設定している管理対象も一緒に起動してくれる。
<h2 id="実行環境">実行環境</h2>
linux 環境があれば良いので Docker で適当に作成
<dl class="description_setting">
<dt>Dockerfile</dt>
<dd>
<pre><code class="hljs language-dockerfile">FROM amazonlinux:latest

# EPEL インストール
RUN amazon-linux-extras install -y epel

# supervisord インストール
RUN yum install -y supervisor

# 設定ファイル設置
COPY nginx.ini /etc/supervisord.d/nginx.ini
</code></pre>
</dd>
</dl>
イメージをビルドして
<pre><code class="hljs language-shell"># イメージをビルド
docker build -t amazon_linux_20210417 .
</code></pre>
コンテナを起動する
<pre><code class="hljs language-shell"># コンテナ起動
docker run -d --privileged amazon_linux_20210417 /sbin/init

# コンテナ ID 出力
-> e17xxxxxxxxxxxxxxxxxxxxxxxx
</code></pre>
出力されたコンテナ ID を指定してコンテナの中に入る
<pre><code class="hljs language-shell"># コンテナの中に入る
docker exec -it e17 /bin/bash
</code></pre>
Supervisor の起動完了
<pre><code class="hljs language-shell"># バージョン確認
$ supervisorctl version
3.4.0
</code></pre>
<h2 id="管理対象を設定する">管理対象を設定する</h2>
nginx を管理対象にして操作していく。
<dl class="description_setting">
<dt>nginx.ini</dt>
<dd>
<pre><code class="hljs language-shell">[program:nginx]
command=/usr/sbin/nginx -g "daemon off;"
autostart=true
autorestart=true
</code></pre>
</dd>
</dl>
.ini じゃなくて .conf が良ければ、supervisord.conf の最下部に include があるのでそこを変更する。
<dl class="description_setting">
<dt>/etc/supervisord.conf</dt>
<dd>
<pre><code class="hljs language-shell">[include]
files = supervisord.d/*.ini
</code></pre>
</dd>
</dl>
<h2 id="supervisorctl-コマンド">supervisorctl コマンド</h2>
スーパーバイザーを操作するには supervisorctl コマンドを使っていく。
Running supervisorctl - Supervisor 公式 
<a href="http://supervisord.org/running.html#supervisorctl-command-line-options" rel="noopener noreferrer" target="_blank">http://supervisord.org/running.html#supervisorctl-command-line-options</a>
<h2 id="管理対象のプロセスの状態を確認する">管理対象のプロセスの状態を確認する</h2>
supervisorctl status ... で管理対象のプロセスの状態を確認できる
<pre><code class="hljs language-shell">status &#x3C;name> 単一プロセスのステータスを取得する
status &#x3C;gname>:* グループ内のすべてのプロセスのステータスを取得する
status &#x3C;name> &#x3C;name> 複数の名前付きプロセスのステータスを取得する
status すべてのプロセスステータス情報を取得する
</code></pre>
nginx の状態を確認してみます。
<pre><code class="hljs language-shell">$ supervisorctl status
nginx RUNNING pid 136, uptime 0:34:04
</code></pre>
RUNNING しっかり動いてる。
<h2 id="管理対象を再起動する">管理対象を再起動する</h2>
supervisorctl restart ... でプロセスの再起動ができる
<pre><code class="hljs language-shell">restart &#x3C;name> プロセスを再起動します
restart &#x3C;gname>:* グループ内のすべてのプロセスを再起動します
restart &#x3C;name> &#x3C;name> 複数のプロセスまたはグループを再起動します
</code></pre>
nginx を再起動してみます。
<pre><code class="hljs language-shell"># 再起動を実行
$ supervisorctl restart nginx
nginx: stopped
nginx: started

# ログ
2021-04-17 07:12:27,752 INFO waiting for nginx to stop
2021-04-17 07:12:27,767 INFO stopped: nginx (exit status 0)
2021-04-17 07:12:27,771 INFO spawned: 'nginx' with pid 152
2021-04-17 07:12:37,814 INFO success: nginx entered RUNNING state, process has stayed up for > than 10 seconds (startsecs)
</code></pre>
再起動されました。
<h2 id="プロセスを落としてみる">プロセスを落としてみる</h2>
プロセスを何度か落としてみましたが、何度でも這い上がってくる感じがさすがデーモン化といったところ。
<div class="img_wrap"><img src="/images/posts/224/kX0JnuwhLes94OSL97H6.png" width="1200" height="905" alt="何度プロセスを落としても起動するnginx"></div>
これがスーパーバイザーの力か。恐るべしデーモン閣下。
<h2 id="設定を変更して反映する">設定を変更して反映する</h2>
nginx の管理設定項目を変更してそれを適用させてみます。
設定ファイルを変更しただけでは適応されないので反映してあげる必要がある。
<dl class="description_setting">
<dt>/etc/supervisord.d/nginx.ini</dt>
<dd>
<pre><code class="hljs language-shell">[program:nginx]
command=/usr/sbin/nginx -g "daemon off;"
autostart=true
autorestart=true

# 起動後設定値（秒）より早くプロセスが終了した場合は起動失敗とする
startsecs=10

# 起動失敗時のリトライ回数。この回数を超えると FATAL 状態となり起動施行をストップする
startretries=2
</code></pre>
</dd>
</dl>
下の 2 を新たに設定値に加えました。
startsecs 起動後設定値（秒）より早くプロセスが終了した場合は起動失敗とする startretries 起動失敗時のリトライ回数。この回数を超えるとステータスが FATAL になって起動をストップする Section Settings 
<a href="http://supervisord.org/configuration.html#program-x-section-settings" rel="noopener noreferrer" target="_blank">http://supervisord.org/configuration.html#program-x-section-settings</a>
変更を反映するには update を使う。プロセスが再起動されて新しい設定値も読み込まれる。
<pre><code class="hljs language-shell">$ supervisorctl update nginx
nginx: stopped
nginx: updated process group
</code></pre>
<h2 id="一度-remove-してから再度-add-する">一度 remove してから再度 add する</h2>
nginx を Supervisor の管理対象から外したのち、再度管理対象にしてみます。
stop でプロセスを止めます。
<pre><code class="hljs language-shell">$ supervisorctl stop nginx
nginx: stopped
</code></pre>
remove で管理対象から外します。
<pre><code class="hljs language-shell">$ supervisorctl remove nginx
nginx: removed process group
</code></pre>
この状態から start でプロセスを開始させようとすると、管理対象から外れているのでエラーになります。
<pre><code class="hljs language-shell">$ supervisorctl start nginx
nginx: ERROR (no such process)
</code></pre>
再度管理対象とするには add を使います。
<pre><code class="hljs language-shell">$ supervisorctl add nginx
nginx: added process group
</code></pre>
再度 nginx が起動します。
ちなみに、remove していようが Supervisor 自体を再起動したら起動します。
<h2 id="ステータスが-fatal-になったものを再度起動させる">ステータスが FATAL になったものを再度起動させる</h2>
起動に失敗して FATAL になった管理対象ってどうやって復帰させるんだろう。という事で確認。
現在、FATAL の状態
<pre><code class="hljs language-shell">$ supervisorctl status
nginx FATAL Exited too quickly (process log may have details)
</code></pre>
手動で起動させるには start で行う
<pre><code class="hljs language-shell">start &#x3C;name> プロセスを開始します
start &#x3C;gname>:* グループ内のすべてのプロセスを開始します
start &#x3C;name> &#x3C;name> 複数のプロセスまたはグループを開始する
start all すべてのプロセスを開始します
</code></pre>
nginx を起動してみます。
<pre><code class="hljs language-shell">$ supervisorctl start nginx
nginx: started
</code></pre>
FATAL ステータスの nginx を起動できました。
<h2 id="まとめ">まとめ</h2>
Supervisor 実際に触ってみたら操作はとてもシンプルでした。
supervisorctl コマンドは add/start とか、reload/reread/update みたいな、シンプルゆえに雰囲気で触ってると意外とどれがどういう動きをするのかわからないなと思ったので、実際に触ってみて確認して理解が深まったことは収穫でした。

Author