Init · レッスン 6

systemd の目標

systemd のサービスユニットを確認、上書き、検証、開始、有効化し、問題を調査する方法を学びます。

systemctl は systemd マネージャーへ要求を送ります。このレッスンではシステムのサービスユニットを扱います。状態を変える前に、正確なユニット名、マネージャーの対象範囲、依存関係、運用上の影響を確認してください。

サービスユニットを読む

説明用の最小限のユニットは、次のようになります。

[Unit]
Description=Example worker
Wants=network-online.target
After=network-online.target

[Service]
Type=exec
ExecStart=/usr/local/bin/example-worker
Restart=on-failure

[Install]
WantedBy=multi-user.target

[Unit] には説明と依存関係を記述します。
[Service] にはプロセスのライフサイクルとサービス固有の動作を定義します。
[Install] は、有効化コマンドで作成する別名や依存関係リンクを指定します。実行時に自動で有効になる依存関係ではありません。

ExecStart= は既定ではシェルを経由しません。シェルを意図的かつ明示的に呼び出さない限り、パイプライン、リダイレクト、変数、引用符は対話型コマンドラインと同じようには動作しません。

WantedBy= など、[Install] のディレクティブが持つ主な目的は何ですか？

有効な設定を調べる

読み込み済みユニットを一覧表示します。

$ systemctl list-units --type=service

インストール済みユニットファイルと有効化状態を一覧表示します。

$ systemctl list-unit-files --type=service

両者は異なるビューです。ユニットファイルには、有効だが非アクティブ、アクティブだが無効、static、generated、transient、masked、または一方の一覧に存在しない、といった状態があります。ベンダー設定とドロップインを統合した内容は、次のコマンドで調べます。

$ systemctl cat UNIT.service
$ systemctl show UNIT.service

list-unit-files が主に表示し、list-units は主には表示しないものは何ですか？

ローカルの上書きを作る

パッケージ化されたユニットを編集せず、ドロップインを使います。

$ sudo systemctl edit UNIT.service

現在の実装では通常、保存後にこの編集ワークフローの一部として systemctl がマネージャーへ再読み込みを要求します。ただし、別の方法でファイルを変更した場合は次を実行します。

$ sudo systemctl daemon-reload

daemon-reload はユニット定義を読み直して依存関係を再構築します。アプリケーション設定を再読み込みしたり、実行中のサービスを再起動したりはしません。必要に応じて systemd-analyze verify でユニットの構文と依存関係を検証し、統合後の有効なユニットを確認してください。

systemctl daemon-reload は何をしますか？

実行時のサービス状態

サービス設定を検証し、復旧アクセスを確保した後、次のコマンドを使います。

$ sudo systemctl start peanut.service
$ sudo systemctl stop peanut.service
$ sudo systemctl restart peanut.service
$ sudo systemctl reload peanut.service

reload が成功するのは、ユニットが再読み込み操作を定義またはサポートする場合だけです。restart はプロセスを中断し、サービスを復旧できない場合もあります。リモートアクセス、ネットワーク、ストレージ、認証を扱うときは、別のコンソール経路を維持し、操作前に設定を検証してください。

状態とログを確認します。

$ systemctl status peanut.service
$ systemctl is-active peanut.service
$ journalctl -u peanut.service -b

「Active」はマネージャー上の状態であり、すべてのアプリケーションエンドポイントが正常である証拠ではありません。

peanut.service を今すぐ開始し、それ自体では将来の有効化を変えないコマンドはどれですか？

有効化、無効化、マスク

将来の依存関係リンクは次のコマンドで管理します。

$ sudo systemctl enable peanut.service
$ sudo systemctl disable peanut.service

enable は --now を追加しない限りユニットを開始しません。disable は --now を追加しない限り実行中のユニットを停止しません。static ユニットはインストール用メタデータを持たない場合がありますが、それでも別のユニットの依存関係として有効化できます。

マスクするとユニットを /dev/null へリンクし、解除するまで依存関係による有効化を含む通常の有効化を阻止します。disable より強力で依存先を壊す可能性があるため、使う前に逆方向の依存関係を調べてください。

実行中のサービスに、--now を付けず systemctl disable UNIT を実行するとどうなりますか？

サービスの結果を検証する

変更後は、プロセス状態、直近のログ、待ち受けエンドポイント、依存ユニット、アプリケーションの正常性を確認します。起動時の有効化を変更した場合は、制御された再起動をまたいだ動作も検証してください。必要に応じて systemctl is-failed、systemctl list-dependencies、アプリケーション固有の検査を使います。

レッスン完了