設定 - Systemdサービスユニットのソースを表示

== 概要 ==
サービスとは、PCの起動時に自動的に実行され、バックグラウンドで仕事をするために待機するソフトウェアのことである。<br>
<br>
一般的に、サービスはグラフィカルユーザインターフェースを持たず、ユーザの操作無しに動作する。<br>
最もよく知られているサービスは、Web、メール、データベース等のサーバで、Apache、MySQL等がある。<br>
<br>
また、ハードウェアの検出やUSBメモリの自動統合(マウント)等もサービスによって行われる。<br>
<br>
サービスには、システム起動時に関連するタスクやハードウェアに関連するタスクを行う"内部サービス"と、<br>
その後にユーザがインストールするサービス(通常は全てのサーバサービスを含む)の2種類がある。<br>
<br>
技術用語やコンピュータ用語では、サービスは伝統的にデーモンと呼ばれている。<br>
そのため、サーバコンポーネントであるsshdやmysqldのように、サービスを表すプログラムの最後の文字として"d"が用いられることが多い。<br>
<br>
一方、Systemdは、システムおよびセッションマネージャ(initシステム)であり、<br>
コンピュータの起動プロセスからシャットダウンまでの全動作時間にわたって、システム上で動作するすべてのサービスを管理する役割を担っている。<br>
<br>
プロセスは常に(可能な限り)並行して起動され、起動プロセスを可能な限り短くする。<br>
ここで、.serviceで終わる設定ファイルを作成して、Systemdが制御・監視するプロセスに関するコードを保持する場合をSystemd Service Unitファイルと呼ぶ。<br>
<br>
Systemdには、サービス、タイマ、マウントポイント、ソケット、スワップスペース、デバイス等のユニットが存在する。<br>
そのため、Systemdは管理用の設定の全てをファイルから取得する。<br>
<br>
Systemdの用語では、これらを"ユニット"と呼び、システム全体に適用されるユニットと各ユーザ領域にのみ適用されるユニットがある。<br>
<br>
ユニットには、サービスを開始するためのサービスユニットや、ある時点でのアクションを(繰り返し)実行するためのタイマユニット等、様々な種類がある。<br>
<br>
各タイプのユニットファイルに共通しているのは、iniファイルに似た構造をしていることである。<br>
ユニットファイルは、いくつかのセクション(多くの場合、3セクション)で構成されている。<br>
<br>
Systemdではセクションと呼ばれ、その中に一連のキーと値のペア(Systemdではディレクティブと呼ばれる)が格納されている。<br>
<br><br>

== コマンドライン ==
コマンドラインやターミナルでSystemdを管理するツールはsystemctlと呼ばれる。<br>
<br>
多くのコマンドはシステムに深く介入するため、root権限が必要である。<br>
そのため、必要な操作を行うには、このコマンドをスーパユーザ権限で実行する必要がある。<br>
<br><br>

== ログ ==
Systemdは、ログ情報を中央のジャーナルに書き込む。<br>
これは、<code>journalctl</code>コマンドにより読み出すことができ、検索やフィルタのオプションも含まれている。<br>
<br><br>

== システム全体の単位 ==
usr/lib/systemd/systemディレクトリには、サービスによってシステム全体にプレインストールされているユニットの全てのファイルがある。<br>
<br>
/etc/systemd/systemディレクトリには、ユーザが作成または編集したシステム全体のユニットの全てのファイルがある。<br>
/etc/systemd/systemディレクトリと/usr/lib/systemd/systemdディレクトリで同名のユニットファイルがある場合は、<br>
/etc/systemd/systemディレクトリのファイルが優先される。<br>
<br><br>

== ユニットの種類 ==
ユニットには様々な種類があり、ファイルの拡張子に応じてsystemdの扱いが異なる。<br>
<br>
<center>
{| class="wikitable" style="background-color:#fefefe;"
|+ Systemdユニットファイルの種類
|-
! style="background-color:#66CCFF;" | 種類(拡張子) 
! style="background-color:#66CCFF;" | 説明
|-
| .device || デバイスファイルを作成する。
|-
| .mount || ファイルシステムのマウントとアンマウントをする。
|-
| .path || ファイルやディレクトリの変更に応じたサービスユニットを実行する。
|-
| .network || ネットワークの設定を行う。
|-
| .service || サービスを設定する。
|-
| .socket || プロセス間の接続を確立する。
|-
| .target || ユニットのグループを定義する。
|-
| .timer || Cronジョブのような定期的なタスクを実行する。
|}
</center>
<br>
ここでは、.service拡張子のユニットについて記載する。<br>
<br><br>

== ユニットファイルの構造 ==
ユニットファイルは、3つのセクションで構成される。<br>
<br>
* [Unit]セクション
*: ユニットの種類によらない一般的なオプションの設定
** Description
**: このユニットの説明を記述する。
**: <code>sudo systemctl status</code>を実行する時に表示される。
** Documentation
**: このユニットについてのドキュメントのURIを記述する。
** After
**: このユニットの前に起動するユニットを記述する。
** Before
**: このユニットの後に起動するユニットを記述する。
** Requires
**: このユニットが依存するユニットを記述する。
**: 前のユニットの起動が失敗した場合は起動しない。
** Wants
**: このユニットが依存するユニットを記述する。
**: 前のユニットの起動が失敗した場合でも起動する。
** Conflicts
**: 指定したユニットと一緒に起動しない。
*: <br>
* [Service]セクション
*: サービスに関する設定を記述する。
** Type
**: プロセスの起動方法を記述する。
**: 各方法は以下の6通りある。
**: <u>"起動が完了する"</u>とは、次の他ユニットが実行可能であることを意味する。
*** simple
***: デフォルト。プロセスが起動した時点で起動が完了する。
*** forking
***: フォークして親プロセスが終了した時点で起動が完了する。
*** oneshot
***: simpleと似ているが、次のユニットを実行する前に自身のプロセスを終了する。
*** dbus
***: D-Busを使用するプロセスであり、D-Busの接続名を見つけた時に起動が完了する。
*** notify
***: simpleと似ているが、<code>sd_notify</code>関数で起動完了のメッセージを受信した時に起動が完了する。
*** idle
***: simpleと似ているが、他のジョブが終了するまで待機する。（シェルへの出力が混ざらないようにするため）
** ExecStart
**: 起動時に実行するコマンドを記述する。
** ExecStop
**: 停止時に実行するコマンドを記述する。
** ExecReload
**: リロード時に実行するコマンドを記述する。
** Restart
**: プロセスが停止した時、プロセスを再起動する条件を記述する。
**: 各条件は以下の4つがある。
*** always
***: 常に自動的に再起動する。
*** no
***: 再起動しない。
*** on-success
***: 終了コードが0で再起動する。
*** on-failure
***: 終了コードが0以外で再起動する。
*** on-abort
***: キャッチできないシグナルで終了した時に再起動する。
*** on-watchdog
***: 監視時間切れで再起動する。
*** on-abnormal
***: SIGHUP、SIGINT、SIGTERM、SIGPIPE以外のシグナルで終了した時に再起動する。
** RestartSec
**: 再起動するまでの待ち時間（秒）を記述する。
** ExecStartPreおよびExecStartPost
**: サービス起動前(ExecStartPre)およびサービス起動後(ExecStartPost)の追加コマンドを指定する。
**: これは、サービスの起動判定には関連させたくないコマンドを指定する。
** ExecStopPost
**: サービス停止後に実行するコマンドを指定する。
**: これは、サービスが異常終了した場合にも実行される。
** KillMode
**: ExecStopで停止せずに残ったプロセスの処理方法を指定する。
*** none
***: 残プロセスは放置する。
*** process
***: メインプロセスが残っている場合、SIGTERM / SIGKILLで停止する。
***: その他の残プロセスは放置する。
*** control-group
***: グループ内の全ての残プロセスをSIGTERM / SIGKILLで停止する。
*** mixed
***: メインプロセスをSIGTERM / SIGKILLで停止して、続けてグループ内の全ての残プロセスをSIGKILLで停止する。
** PIDFile
**: fork型サービスのメインプロセスのPIDファイルを指定する。
** BusName
**: D-Bus型サービスのbus接続名を指定する。
** User
**: プロセスを起動するユーザを指定する。
** Group
**: プロセスを起動するグループを指定する。
** PrivateTmp
**: このサービス専用の/tmpと/var/tmpを用意する。
** ReadOnlyDirectories
**: 指定ディレクトリ以下をReadOnlyモードにする。
** InaccessibleDirectories
**: 指定ディレクトリ以下をアクセス不可にする。
** RootDirectory
**: 指定ディレクトリにchrootする。
* [Install]セクション
*: インストール時の設定を記述する。
** Alias
**: <code>sudo systemctl enable</code>コマンドの実行時に、Aliasで指定された名前のユニットのシンボリックリンクを作成する。
** RequiredBy
**: <code>sudo systemctl enable</code>コマンドの実行時に、このユニットの".required"ディレクトリにリンクを作成する。
** WantedBy
**: <code>sudo systemctl enable</code>コマンドの実行時に、このユニットの".wants"ディレクトリにリンクを作成する。
** Also
**: <code>sudo systemctl enable / disable</code>コマンドの実行時に、同時にenable / disableするユニットを記述する。
<br>
ユニットの詳細を知りたい場合は、以下のコマンドを実行する。<br>
 man systemd.unit
<br>
サービスの詳細を知りたい場合は、以下のコマンドを実行する。<br>
 man systemd.service
<br>
以下に、よく使用されるユニットファイルのフォーマットを示す。<br>
 [Unit]
 Description=<ユニットファイルの説明>
 After=<指定したユニットリストの起動後に実行する>
 Before=<指定したユニットリストの前に実行する>
 Requires=<指定したユニットリストの起動成功後に実行する。（ユニット起動時に依存ユニットも起動するが、依存ユニット失敗時は起動しない）>
 Wants=<指定したユニットリストが起動失敗しても実行する。（ユニット起動時に依存ユニットも起動するが、依存ユニット失敗時でも起動する）>
 
 [Service]
 Environment=<環境変数リスト>
 EnvironmentFile=<環境変数ファイル>
 Type=<simple | forking | oneshot | dbus | notify | idle>
 ExecStart=<起動コマンド>
 ExecStop=<停止コマンド>
 ExecReload=<再起動コマンド>
 Restart=<always | on-abort | on-watchdog | on-abnormal | on-failure | on-success | no>
 RemainAfterExit=<yes | no>
 PIDFile=<メインプロセスのPIDファイルパス>
 User=<ユニットファイルの実行ユーザ>
 SuccessExitStatus=<（0以外に）メインプロセス正常終了とみなすexitコードリスト>
 
 [Install]
 Alias=<ユニットの別名>
 RequiredBy=<sudo systemctl enableコマンドの実行時に、このユニットの".required"ディレクトリにリンクを作成する>
 WantedBy=<sudo systemctl enableコマンドの実行時に、このユニットの".wants"ディレクトリにリンクを作成する>
 Also=<同時に起動および停止するユニット>
<br><br>

== ユニットの依存関係および順序の確認 ==
Systemdユニットの依存関係および順序は、以下のコマンドで確認できる。<br>
<br>
指定したユニットが必要とするユニットを表示する。ユニット名を省略した時は、default.targetが指定される。<br>
依存関係のユニットが<u>Target</u>タイプの場合、さらに、それが必要なユニットを再帰的に表示する。<br>
<code>--all</code>オプションを付加することにより、全てのユニットを再帰的に表示する。<br>
 sudo systemctl list-dependencies <ユニット名>
<br>
指定したユニットよりも先に起動するユニットを表示する。<br>
 sudo systemctl list-dependencies <ユニット名> --after
<br>
指定したユニットよりも後に起動するユニットを表示する。<br>
 sudo systemctl list-dependencies <ユニット名> --before
<br><br>

== 独自のユニットやSystemdサービスファイルの作成 ==
例えば、PC起動時に何らかのスクリプトやソフトウェアをバックグラウンドで実行したいとする。<br>
そのためには、サービスユニットを作成する必要がある。<br>
<br>
サービスユニットを作成するための構文を、以下に示す。<br>
<br>
まず、/etc/systemd/systemディレクトリまたは/usr/lib/systemd/systemディレクトリに、ユニットファイルを作成する。<br>
<u>一般的には、ユーザが任意で作成するユニットファイルは、/etc/systemd/systemディレクトリに配置する。</u><br>
 sudo vi /usr/lib/systemd/system/<ユニットファイル名>.service
 または
 sudo vi /etc/systemd/system/<ユニットファイル名>.service
<br>
 # スクリプトを使用する場合
 
 [Unit]
 Description =           # サービスの説明を記述する
 After = network.target  # ※指定しなくてもよい
 
 [Service]
 User=              # ユーザ名  例. root  ※指定しなくてもよい
 WorkingDirectory=  # 実行するファイルまたはスクリプトがあるディレクトリのフルパス  ※指定しなくてもよい
 ExecStart =        # 実行するファイルまたはスクリプトへのフルパス または ファイル名のみ(WorkingDirectoryを指定する場合)
 Restart=always     # ※指定しなくてもよい
 
 [Install]
 WantedBy =         # multi-user.target または graphical.target等
<br>
 # Pythonを使用する場合
 
 [Unit]
 Description =           # サービスの説明を記述する
 After = network.target  # ※指定しなくてもよい
 
 [Service]
 User=              # ユーザ名  例. root  ※指定しなくてもよい
 WorkingDirectory=  # 実行する.pyファイルがあるディレクトリのフルパス  ※指定しなくてもよい
 ExecStart =        # <Pythonの実行ファイル> <実行する.pyファイルへのフルパス または ファイル名のみ(WorkingDirectoryを指定する場合)>
                    # 例. /usr/bin/python3 main.py
 Restart=always     # ※指定しなくてもよい
 
 [Install]
 WantedBy =         # multi-user.target または graphical.target等
<br>
以下の例では、Glancesという名前のサービスファイルを作成して、Linux向けの監視ツールであるglancesをバックグラウンドで動作させている。<br>
 sudo vi /usr/lib/systemd/system/glances.service
<br>
 [Unit]
 Description = Glances in Web Server Mode
 After = network.target
 
 [Service]
 ExecStart = /usr/bin/glances -w -t 5
 
 [Install]
 WantedBy = multi-user.target
<br>
<code>[Install]</code>セクションでは、<code>[WantedBy]</code>キーにより、ユニットがいつ起動するかを指定する。<br>
下表に、指定することができるキーの値を示す。<br>
<center>
{| class="wikitable" style="background-color:#fefefe;"
|-
! style="background-color:#66CCFF;" | ターゲット 
! style="background-color:#66CCFF;" | 説明
|-
| multi-user.target || グラフィカルログインの有無にかかわらず、マルチユーザシステム用(ランレベル3に対応)
|-
| graphical.target || グラフィカルログインが必要なマルチユーザシステム用(ランレベル3 + グラフィカルログインに対応)
|-
| rescue.target || 一般的に、シングルユーザモードはシステムのレスキュー時にのみ必要(ランレベル1に対応)
|-
| reboot.target || システムの再起動時にのみユニットが実行する。
|-
| poweroff.target || システムのシャットダウン開始時にのみ実行するユニットである。
|-
| default.target || 別の既存ターゲットへのシンボリックリンクである。<br>例えば、Ubuntuデスクトップの初期設定では、default.targetはgraphical.targetである。
|}
</center>
<br>
サービスファイルを読み込んで、新しいサービスを追加する。<br>
 sudo systemctl daemon-reload
<br><br>

== 手動で作成したシステムのサービスユニットを有効にする ==
サービスユニットの作成後は、サービスを有効にして起動する必要がある。<br>
<br>
<サービスユニットのファイル名>において、<br>
例えば、上記で作成したglancesサービスを有効にするには、<code>sudo systemctl enable glances.service</code>となる。<br>
<br>
以下のコマンドを実行して、新しいサービスユニットを読み込み・追加する。<br>
 sudo systemctl daemon-reload
<br>
サービスユニットを自動起動に設定する。<br>
 sudo systemctl enable <サービスユニットのファイル名>
<br>
サービスユニットを起動する。<br>
 sudo systemctl start <サービスユニットのファイル名>
<br>
サービスユニットの状態を確認する。<br>
sudo systemctl status <サービスユニットのファイル名>
<br><br>

__FORCETOC__
[[カテゴリ:CentOS]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]]