Debian 13 講座 / systemdサービスとdrop-in設定を管理する

Debian 13 では、active は systemd サービスの現在の稼働状態(ユニット種別によって意味が異なります)を示し、enabled は起動時に開始するように有効になっているかどうかを示します。ユニットファイルやdrop-in(追加設定ファイル)を変更したら、daemon-reloadでsystemdマネージャーに定義を再読み込みさせます。実行コマンドを変更した場合は、さらにサービスを再起動し、実際の応答まで確認します。

ランタイム状態と起動時設定を区別する

systemd は、サービス、タイマー、マウントなどのタスクをユニットとして管理します。このチュートリアルでは、Debian 13 systemd 257 環境でループバック専用の Python HTTP サービスを作成し、そのステータスを表示し、プロセス、ポート、および応答を比較します。これは一般的なシステムサービスを操作するための練習であり、既存のすべてのサービスを同じ方法で再起動することを意味するものではありません。

コマンド 変更する対象 この練習の結果
start / stop 現在実行中のサービス 起動リンクを変更せずにサービスを開始または停止する
enable / disable ユニットの起動リンク 実行中のプロセスを停止せずに、起動リンクを追加または削除する
enable --now 起動設定とランタイム状態 起動リンクを有効にし、サービスを今すぐ開始する
daemon-reload systemdによって読み取られるユニット設定 HTTPプロセスを置き換えずにユニット定義を再読込する
restart サービスプロセス 停止と開始により新しい実行コマンドを適用する

たとえenabledであっても、サービスは失敗することがあり、たとえdisabledであっても、手動で起動するか別のユニットの要求に応じて実行することができます。この例では[Install]内のWantedByが、自動起動用リンクを作る対象のターゲットを指定します。自動起動用の設定を持たないstaticユニットや、ソケット経由で起動するユニットも存在するため、すべてのサービスの起動動作を有効かどうかだけで判断しないでください。詳細なコマンドの意味はDebian 13 systemctlマニュアルで確認できます。

専用ラボの初期状態を確認する

sudo権限のあるlfstudentアカウント、Python 3、およびcurlを使用してください。異なるアカウントの場合は、以下のサービスのUserとドキュメントパスを実際のアカウントに合わせて調整してください。PythonのHTTPサーバーは練習目的であり、ホストやLANに公開する必要はないため、127.0.0.1上でのみリッスンします。NATフォワーディングやファイアウォールの変更は不要です。

id lfstudent
python3 --version
curl --version
systemctl --version
systemctl show lf-http17.service -p LoadState
sudo ss -lntp 'sport = :8080'
sudo ss -lntp 'sport = :8082'
ls -ld /home/lfstudent/lf-http17 /etc/systemd/system/lf-http17.service.d

サービスはLoadState=not-foundであり、どちらのポートにもリスニング行はなく、フォルダーも初期状態として存在しません。最後のlsでは、指定したパスが存在しないことを確認します。想定する結果は「そのようなファイルやディレクトリはありません」というエラーです。既にラボリソースが存在する場合は、ここで停止し、所有者を特定してください。既存のものを上書きしたり他のサービスを停止したりしないでください。Pythonやcurlがインストールされていない場合は、sudo apt install --no-install-recommends python3 curlの変更リストを確認してインストールしてください。

lfstudent にログインしている端末上で専用ファイルを作成します。

mkdir /home/lfstudent/lf-http17 &&
printf 'systemd-service-lab\n' > /home/lfstudent/lf-http17/probe.txt

ディレクトリの作成に失敗した場合、連結された printf コマンドはスキップされます。そこで実習を止め、後続のサービスファイル作成へ進まないでください。実習用ドキュメントルートは別途制限されており、ホームディレクトリ全体は提供されません。システムサービスは通常システム管理者が処理しますが、HTTP プロセス自体は下記の User=lfstudent に示すように通常ユーザーの権限で実行されます。

サービスユニットを作成して検証する

sudo nano /etc/systemd/system/lf-http17.service で新しいファイルを開き、以下の全内容を保存します。別のエディタを使用しても構いませんが、ファイル名、パス、行構造は維持してください。既存のファイルを新しい例で上書きしないでください。

[Unit]
Description=Local HTTP service for lesson 17

[Service]
Type=exec
User=lfstudent
ExecStart=/usr/bin/python3 -m http.server 8080 --bind 127.0.0.1 --directory /home/lfstudent/lf-http17
Restart=on-failure
RestartSec=2s

[Install]
WantedBy=multi-user.target

Type=exec は、実行可能ファイルの起動段階でエラーをチェックするのに役立ちます。ただし、実行可能ファイルの起動に成功したからといって、HTTPリスナーが準備完了であることを保証するものではありません。Restart=on-failure は異常終了時に再起動する設定であり、管理者が通常通り停止したサービスを復旧させるオプションではありません。

ExecStart でのバックグラウンド実行のために & を追加しないでください。systemd はプロセスをフォアグラウンドで実行することで直接管理します。通常のシェルコマンドラインとは異なり、パイプやリダイレクトはシェル構文として自動的に処理されません。実行方法については systemd.service ドキュメント の関連オプションを参照してください。

sudo systemd-analyze verify /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
systemctl cat lf-http17.service

検査エラーや警告がある場合は原因を確認してください。エラーなく読み取った後でも、まだ開始していない場合は、無効および非アクティブが予想されます。これら2つのクエリはステータスに応じてゼロ以外の終了コードを返すため、オートメーションで異常終了を単純にインストール失敗として扱わないでください。

activeとenabledを別々に確認する

まず、サービスを手動で起動し、実際のファイル応答を確認してください。

sudo systemctl start lf-http17.service
systemctl is-active lf-http17.service
systemctl is-enabled lf-http17.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
sudo ss -lntp 'sport = :8080'

状態確認ではactiveとdisabledを、HTTPリクエストからsystemd-service-labを期待してください。curlでの制限された再試行は、プロセス開始直後にポートが準備できるまでの短い差を考慮しています。継続して失敗する場合、ステータスだけに頼らず、sudo journalctl -u lf-http17.service -b --no-pager -n 30で原因を確認してください。

スタートアップリンクを有効にしてから、現在のプロセスを停止します。

sudo systemctl enable lf-http17.service
sudo systemctl stop lf-http17.service
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service

enabledとinactiveが想定される結果です。停止しても起動時のリンクは削除されません。サービスを再開してから、スタートアップリンクを無効にしてください。

sudo systemctl start lf-http17.service
sudo systemctl disable lf-http17.service
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt

disabledとactiveが表示され、同じファイルの内容が返ることを確認します。この例では、無効化しても実行中のHTTPプロセスは停止しません。即時停止が必要な場合は disable --now を使用してください。この比較では、後続のポート変更のためにactiveかつdisabledの状態にしておきます。

drop-inでポートを変更する

ドロップインは、元のユニットファイルの隣にある unit-name.d/ フォルダーに追加される補助設定です。パッケージで提供される /usr/lib/systemd/system/ ファイルを直接変更する代わりに、管理者は一般的に /etc/systemd/system/ のドロップインとして変更を管理します。この例では、元のファイルと補助ファイルを区別するために、手動で作成したユニットに同じ方法を適用しています。

systemctl show lf-http17.service -p MainPID -p ExecStart -p FragmentPath -p DropInPaths
sudo install -d /etc/systemd/system/lf-http17.service.d

PID(Process ID)はプロセスの識別番号です。MainPIDはサービスのメインプロセスのPIDを表すため、後で比較できるように記録します。sudo nano /etc/systemd/system/lf-http17.service.d/20-port.conf でドロップインを作成します。

[Service]
ExecStart=
ExecStart=/usr/bin/python3 -m http.server 8082 --bind 127.0.0.1 --directory /home/lfstudent/lf-http17

空の ExecStart= は、以前に設定された実行コマンドをリセットし、次の行で置き換えるためのものです。リセットせずに2つ目の実行コマンドを追加すると、このサービスタイプで意図した置き換えは行われません。ドロップインはオプションによってマージまたは上書きの方法が異なるため、すべての設定が同じ方法で扱われるわけではありません。systemd.unit の設定検索パスとドロップインの説明 は参考になります。

sudo systemd-analyze verify /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
systemctl cat lf-http17.service
systemctl show lf-http17.service -p MainPID -p ExecStart -p DropInPaths
curl --noproxy '*' --max-time 5 -fsS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --max-time 3 -fsS http://127.0.0.1:8082/probe.txt

マネージャーに ExecStart が 8082 と表示されていても、実行中プロセスの MainPID は以前の値であり、8080 への応答は続きます。8082 へのリクエストは、まだ何もそこをリッスンしていないため失敗すると予想されます。これは、daemon-reload がユニット定義を再読み込みする場合の比較であり、プロセスを再起動する場合とは異なります。

sudo systemctl restart lf-http17.service
systemctl show lf-http17.service -p MainPID -p ActiveState -p SubState -p UnitFileState
sudo ss -lntp 'sport = :8082'
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8082/probe.txt
curl --noproxy '*' --max-time 3 -fsS http://127.0.0.1:8080/probe.txt

再起動したプロセスのPIDを確認し、ポート8082でのリスナーとファイルの応答を確認し、以前のポート8080のリスナーが消えているかどうかを比較してください。PID番号は環境によって異なりますが、数値自体よりもステータス、リスナー、応答を一緒に確認することの方が重要です。reloadコマンドも別の操作です。このユニットではExecReload等は指定されていないため、設定適用のためにサポートされていないリロードを使用しません。

実習用のdrop-inだけを削除し、8080に戻す

元のサービスファイルは保持し、今回作成した20-port.confのみを削除してください。systemctl revertによる一括復元は、ほかの追加設定も消す可能性があります。この実習では、作成したファイルだけを削除します。

sudo rm -- /etc/systemd/system/lf-http17.service.d/20-port.conf
sudo rmdir -- /etc/systemd/system/lf-http17.service.d
sudo systemctl daemon-reload
sudo systemctl restart lf-http17.service
systemctl show lf-http17.service -p ExecStart -p DropInPaths
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
sudo journalctl -u lf-http17.service -b --no-pager -n 20

DropInPaths が空になり、ExecStart が再びポート 8080 を指定し、HTTP リクエストが元のファイルを返すと復元が確認されます。rmdir が空でないため失敗する場合は、まず他のファイルがあるか確認し、フォルダ全体を削除しないでください。ログは開始、停止、リクエストの痕跡を保持しており、状態の遷移を確認できます。

エラーを診断し、専用サービスを削除する

ファイルパスのタイプミスやアクセス権の問題は、HTTP リクエストの失敗やサービス起動の失敗として現れることがあります。ポートの競合は、 ss で他のサーバーがリスンしているかを確認できます。systemctl status lf-http17.service --no-pager の結果とジャーナル内の具体的なエラーを読み取り、それを修正してください。失敗記録を消去するために reset-failed を実行するだけでは、根本原因は解決されません。

練習を終了したら、専用サービスのみを停止し、自動起動を無効にしてから、作成されたファイルを削除してください。

sudo systemctl disable --now lf-http17.service
sudo rm -- /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
rm -- /home/lfstudent/lf-http17/probe.txt
rmdir -- /home/lfstudent/lf-http17
systemctl show lf-http17.service -p LoadState
sudo ss -lntp 'sport = :8080'
sudo ss -lntp 'sport = :8082'

LoadState=not-foundとなり、両方の実習用ポートに待受行がないことを確認してください。サービスが失敗状態のままである場合は、まずファイルの削除とプロセスの終了を確認し、そのユニットの失敗記録のみを sudo systemctl reset-failed lf-http17.service でクリアしてください。他のサービスやシステムログはそのままにしてください。