データベース、ワーカー、Webアプリに適したDockerの再起動ポリシーの選び方

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

Composeファイル内のすべてのコンテナにunless-stoppedを割り当てるのではなく、サービスのライフサイクルと終了時の動作に合わせてDockerの再起動ポリシーを選んでください。

再起動ポリシーは、コンテナのメインプロセスが終了したときに反応します。ヘルスチェックでは、稼働し続けているプロセスを異常と判定できますが、それだけで自動的に再起動することはありません。そのため、データベース、ワーカー、Webアプリ、マイグレーション、スケジュールジョブでは、稼働し続ける想定か、正常終了が何を意味するか、障害の繰り返しをどう通知するかに応じて、それぞれ異なる設定が必要です。

再起動の動作をヘルスチェックと準備完了条件から切り分ける

再起動ポリシーは、プロセス停止後にDockerがコンテナを再び起動するかどうかを定めます。ヘルスチェックは、稼働中のサービスが定義された操作を実行できるかどうかを確認します。依存関係の準備完了条件は、別のサービスを起動してよいかどうかを判断します。これらは関連していますが、それぞれ異なる問題を解決します。

2026年のヘルスチェックと再起動は別の仕組みでは、この違いを説明し、サービスが実際に準備できるまで依存サービスの起動を遅らせるComposeのヘルス条件を紹介しています。

restart: alwaysを設定しても、終了せずに異常状態のまま動作し続けるWebプロセスが修復されるとは限りません。また、ヘルスチェックだけでプロセスが再起動されるわけでもありません。安全に処理を続けられない場合はアプリケーションを終了させるか、外部の復旧手段を追加するか、サービスの設計に応じて異常状態をアラートで通知してください。

長時間稼働するデータベースには永続的な再起動ポリシーを使う

ホームサーバーのデータベースは通常、ホストやDockerデーモンの再起動後に復帰することが期待されます。管理者が意図的に停止した状態を維持したい場合は、unless-stoppedが実用的なデフォルトとなることがよくあります。再起動時には手動停止の状態を意図的に無視する必要がある場合は、alwaysが適しています。

2026年7月の再起動ポリシーはプロセスの終了に応じて動作するでは、no、on-failure、always、unless-stoppedの違いを詳しく説明しています。また、ポリシーはヘルスステータスではなく、プロセスの終了に反応することも解説しています。

データベースには、実際に機能するヘルスチェックと永続ストレージも必要です。PostgreSQLを繰り返し再起動しても、ディスク容量不足、無効な設定、状態の破損、互換性のないマイグレーションは解決できません。繰り返しの再起動は、レジリエンスが実現できたと見なすのではなく、アラートで通知してください。

キューと終了時の動作に応じてワーカーのポリシーを選ぶ

長時間稼働するキューワーカーが常にジョブを処理する必要がある場合は、unless-stoppedが適していることがあります。有限のワーカーやバッチ処理にはon-failure:Nを使うと、一時的なエラーには上限付きで再試行し、障害が続く場合は停止して明確に把握できます。

現在の失敗時の再試行回数の上限は、プロセスが常時稼働する想定なのか、正常に終了することが許容されるのかに応じて、再試行の動作を設定すべきであることを示しています。

ワーカーイメージで終了コード0が何を意味するか把握してください。「ジョブ完了」を意味するなら、always によって、正常に完了したワンショットジョブが無限ループになることがあります。ワーカーがデーモンとして動作する想定なら、予期しない正常終了でも unless-stopped による自動復帰が適切な場合があります。

Webアプリは長時間稼働させつつ、実際の依存先の準備が整ってから起動させる

ほとんどのセルフホスト型Webアプリケーションは継続的な稼働を想定しているため、上限付きの失敗時のみのポリシーよりも、通常は unless-stopped のほうが扱いやすくなります。再起動設定を使っても、データベース、キャッシュ、DNS、シークレット、マウントされたパスの準備が整っている必要はなくなりません。

関連するZimaSpaceの診断記事コンテナの依存先が原因の再起動ループでは、目に見えるアプリを何度も再起動すると、最初に発生したデータベース、キャッシュ、マウント、移行、メモリの障害が見えにくくなる理由を説明しています。

適切な場合は起動順序に依存先のヘルスチェックを使い、アプリケーションの再試行にも上限を設けます。PostgreSQLの起動まで5秒ごとにクラッシュするWebサービスより、レディネスを待って一度だけ正常に起動するサービスのほうが、状態を把握しやすくなります。

移行とワンショットジョブに有限のライフサイクルを設定する

移行コンテナ、インポーター、メンテナンスタスク、一度だけ実行する初期化ジョブは、通常のデーモンではありません。成功状態は多くの場合、「終了コード0で終了し、停止したまま」です。always や unless-stopped を使うと、完了した処理が意図せず再実行されることがあります。

ワンショットの運用ツールは明示的に扱い、気づかないうちに常時稼働するサービスにならないようにします。移行ツールやインポーターには、コマンド終了後も確認できる有限の成功状態を持たせてください。

障害時に停止して調査すべき場合は restart: "no" を使います。再試行しても安全なコマンドに限り、上限付きの on-failure を使います。スキーマ移行では、再試行を自動化する前に、途中まで適用された移行を繰り返しても問題ないことを確認してください。

実際の障害モードでポリシーをテストする

各サービスについて、プロセスの正常終了、ゼロ以外の終了コードでのクラッシュ、ホストの再起動、Dockerデーモンの再起動、手動停止、稼働中だが不健康な状態、依存先の利用不可をテストします。設定を回復性ありと判断する前に、各事象の後に期待される状態を記録してください。

再起動回数を追跡し、一定時間内に少ないしきい値を超えたらアラートを出します。一時的な障害からの自動再起動は復旧時間を短縮するためのものであり、コンテナを延々と作り直して継続的なクラッシュを見えなくするためのものではありません。

優れたポリシーマトリックスは明確です。インフラストラクチャの再起動後も長時間稼働するデータベースやWebアプリは復帰し、デーモンワーカーはキューのセマンティクスに従って復旧し、有限のジョブは完了時に停止します。また、ヘルスチェックとレディネスチェックによって、再起動ポリシーでは検知できない障害を明らかにします。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.