Debian 13 講座 / 総合実習:サービス配備・破損検知・復元

Debianサーバーの動作を確認するには、サービスが稼働しているかどうかだけでなく、データを正しく読み書きできるかどうか、破損した実データをバックアップで復元した後に新しい書き込みが維持されるかどうかも確認する必要があります。この総合的な実習では、専用アカウントでカウンターサービスをデプロイし、順番に通常のバックアップ、限定的なデータ破損、HTTPエラー検出、実際の復元を行います。

ラボ環境と成功基準を定義する

Debian 13、Python 3.13、および systemd 257 を使用する専用の仮想マシン(VM)を使用してください。Python 3、curl、または tar が利用できない場合は、sudo apt install python3 curl tar を使用して準備してください。sudo 権限を持つ管理者アカウントで実行し、指定されたパス、アカウント、または ポート8086 をすでに使用しているサーバーには適用しないでください。

HTTP サービスは 127.0.0.1:8086 でのみリクエストを受け付けます。GET / は現在の値を読み取り、POST /increment でボディなしで送信すると値が一つ増加します。これはローカル学習用であり、認証、外部向けTLS(Transport Layer Security)、または複数プロセスによる同時書き込みを実装した運用製品ではありません。また、Python HTTP サーバーのドキュメント の範囲も確認してください。

手順 成功基準
展開と書き込み 専用アカウントで: 0 → 1 → 2、サービス再起動後も2のまま
通常バックアップ 停止状態でアーカイブとハッシュを生成し、別々の空ディレクトリに復元して、内容と権限を比較
損傷検出 プロセスとポートは維持されるが、GETおよびPOSTの両方で503を返し、破損ファイルは自動的に初期化されない
復元後の動作 実際のバックアップから2を復元 → 新しい3を書き込み → 再起動後3 → 新しい4を書き込み

以下のコマンドは、新しい実習を一度実行するための手順です。同じバックアップを上書きしないように確認し、途中で失敗した場合は状態とログを確認し、まず失敗したステップの原因を解決してください。通常値を強制的に初期化するために最初のブロックを再実行してはいけません。

専用アカウントで完全なプログラムをデプロイする

セットアップ前に、getent group lf-capstone36 が既存のグループを見つけないことも確認してください。既存のアカウント、ディレクトリ、またはサービスを再利用するのではなく、前提条件や作成ステップが失敗した場合はそこで停止してください。ループバックのcurlリクエストが設定されたプロキシをバイパスすることを確認してください。

プログラムおよびサービスのユニットは root によって所有されており、専用アカウントによって管理されるのはデータディレクトリのみです。ユニットの読み取り専用システム制限内では、データパスは ReadWritePaths に許可されています。一時ファイルを作成し名前を置き換えるストレージ手法では、単一ファイルへの書き込み権限だけでなく、親ディレクトリの書き込み・実行(検索)権限も必要です。

sudo bash <<'ROOT'
set -euo pipefail
for p in /opt/lf-capstone36 /var/lib/lf-capstone36 /var/backups/lf-capstone36 /etc/systemd/system/lf-capstone36.service; do test ! -e "$p"; done
if getent passwd lf-capstone36 >/dev/null; then exit 1; fi
test -z "$(ss -H -ltn 'sport = :8086')"
useradd --system --user-group --home-dir /var/lib/lf-capstone36 --no-create-home --shell /usr/sbin/nologin lf-capstone36
install -d -m 755 /opt/lf-capstone36
install -d -m 750 -o lf-capstone36 -g lf-capstone36 /var/lib/lf-capstone36
install -d -m 700 /var/backups/lf-capstone36
cat > /opt/lf-capstone36/app.py <<'PY'
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path
import json
import os
import tempfile

DATA = Path('/var/lib/lf-capstone36/state.json')

def load_count():
    value = json.loads(DATA.read_text(encoding='utf-8'))
    if (type(value) is not dict or set(value) != {'count'}
            or type(value['count']) is not int or value['count'] < 0):
        raise ValueError('invalid state')
    return value['count']

def save_count(count):
    temporary = None
    try:
        with tempfile.NamedTemporaryFile(
                mode='w', encoding='utf-8', dir=DATA.parent,
                prefix='state.', delete=False) as stream:
            temporary = Path(stream.name)
            json.dump({'count': count}, stream, separators=(',', ':'))
            stream.write('\n')
            stream.flush()
            os.fsync(stream.fileno())
        os.replace(temporary, DATA)
        descriptor = os.open(DATA.parent, os.O_RDONLY | os.O_DIRECTORY)
        try:
            os.fsync(descriptor)
        finally:
            os.close(descriptor)
    finally:
        if temporary is not None:
            temporary.unlink(missing_ok=True)

class Handler(BaseHTTPRequestHandler):
    def reply(self, status, value):
        body = (json.dumps(value, separators=(',', ':')) + '\n').encode()
        self.send_response(status)
        self.send_header('Content-Type', 'application/json; charset=utf-8')
        self.send_header('Content-Length', str(len(body)))
        self.end_headers()
        self.wfile.write(body)

    def do_GET(self):
        if self.path != '/':
            self.reply(404, {'error': 'not found'})
            return
        try:
            count = load_count()
        except (OSError, ValueError):
            self.reply(503, {'error': 'state unavailable'})
            return
        self.reply(200, {'count': count})

    def do_POST(self):
        if self.path != '/increment':
            self.reply(404, {'error': 'not found'})
            return
        if self.headers.get('Content-Length', '0') != '0':
            self.reply(400, {'error': 'empty body required'})
            return
        try:
            count = load_count() + 1
            save_count(count)
        except (OSError, ValueError):
            self.reply(503, {'error': 'state unavailable'})
            return
        self.reply(200, {'count': count})

HTTPServer(('127.0.0.1', 8086), Handler).serve_forever()
PY
cat > /etc/systemd/system/lf-capstone36.service <<'UNIT'
[Unit]
Description=LF capstone counter 36
After=network.target

[Service]
Type=exec
User=lf-capstone36
Group=lf-capstone36
WorkingDirectory=/opt/lf-capstone36
ExecStart=/usr/bin/python3 -B /opt/lf-capstone36/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/var/lib/lf-capstone36
MemoryMax=128M
TasksMax=32
Restart=on-failure
RestartSec=2s

[Install]
WantedBy=multi-user.target
UNIT
chmod 644 /opt/lf-capstone36/app.py /etc/systemd/system/lf-capstone36.service
printf '{"count":0}\n' > /var/lib/lf-capstone36/state.json
chown lf-capstone36:lf-capstone36 /var/lib/lf-capstone36/state.json
chmod 600 /var/lib/lf-capstone36/state.json
systemd-analyze verify /etc/systemd/system/lf-capstone36.service
systemctl daemon-reload
systemctl enable --now lf-capstone36.service
sleep .4
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":0}'
test "$(curl -fsS -X POST http://127.0.0.1:8086/increment)" = '{"count":1}'
test "$(curl -fsS -X POST http://127.0.0.1:8086/increment)" = '{"count":2}'
systemctl restart lf-capstone36.service
sleep .3
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":2}'
systemctl is-enabled lf-capstone36.service
pid=$(systemctl show -p MainPID --value lf-capstone36.service)
ps -o user=,group=,args= -p "$pid"
if runuser -u lf-capstone36 -- test -w /opt/lf-capstone36/app.py; then echo CODE_WRITABLE >&2; exit 1; fi
if runuser -u lf-capstone36 -- test -r /var/backups/lf-capstone36; then echo BACKUP_READABLE >&2; exit 1; fi
systemctl show lf-capstone36.service -p NoNewPrivileges -p ProtectSystem -p ReadWritePaths -p MemoryMax -p TasksMax
echo COUNTER0_TO1_TO2_AND_RESTART_PERSISTENCE_LEAST_PRIVILEGE_PASSED
ROOT

短いスタートアップのスリープは遅延であり、準備完了の保証ではありません。リクエストが失敗した場合は、sudo systemctl status lf-capstone36.service および sudo journalctl -u lf-capstone36.service -n 30 を確認し、現在の値を確認するために GET を使用してください。セットアップ全体を繰り返したり、POST を盲目的に再試行したりしないでください:応答が失われても書き込み済みの可能性があります。ファイル置換後のディレクトリ同期が失敗して503を返した場合にも、値は既に変わっている可能性があります。まずGETで現在値を確認してください。

ブロックの最後までエラーなく実行される場合、0 → 1 → 2 となり、サービスを再起動した後も 2 が維持されることが確認されます。専用アカウントはコードファイルを変更したり、ルート専用のバックアップディレクトリを読み取ったりすることはできず、実行制限の出力には ProtectSystem=strict 、 NoNewPrivileges=yes 、メモリ 128 MiB、32 タスクが表示されます。これらの制限は小さい例のためのものであり、実際のサービスで測定された値に合わせて調整する必要があります。

このプログラムは JSON(JavaScript Object Notation)パーサー を使用して、読み取った値の構造、整数型、および範囲を確認します。無効なファイルに遭遇した場合、0 にリセットするのではなく 503 を返します。自動的に 0 に初期化すると、復元すべき証拠や既存の値を失う可能性があり、エラーを通常の応答として隠してしまうおそれがあります。

保存する際には、同じデータディレクトリ内に NamedTemporaryFile を使用して一時ファイルを作成し、フラッシュと fsync 後に os.replace で名前を置き換えます。ディレクトリも同期されますが、この演習では停電や仮想ディスクキャッシュの損失はテストしていません。すべてのストレージデバイスにおけるアトミックな名前置換(途中状態を見せない置換)と停電に対する耐久性を同じ保証として考えないでください。

このHTTPサーバーは、1つのサーバープロセス内でリクエストを順次処理します。同じファイルを複数のプロセスが変更する場合や外部ツールが同時に書き込む場合の同期は実装されていません。また、インクリメントリクエストは繰り返すたびに値が変わるため、応答が失われたからといって無闇に再送すると値が二重に増える可能性があります。実際の運用では、トランザクションや重複リクエストの処理を考慮したストレージ方法を検討する必要があります。

Debian VMでの実習では、systemctlを使用して有効状態とサービスの再起動を確認しました。VM再起動後の自動起動はこの総合演習では別途テストされていないため、実際の引き渡し前に、コンソールやリカバリ手段を確認しながらブートテストも実施してください。アカウント、パス、および保護設定の意味は、systemd実行環境マニュアル で確認できます。

停止中にバックアップし、空のディレクトリへ復元する

サービスを停止し、カウンターの値が2のときにバックアップを取ってください。追加リクエストの送信で値が変わる場合は、なぜ変わったのかを確認し、意図した参照値を設定してください。次のチェックが失敗した場合に、値を2で上書きしないでください。

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/lf-capstone36
test ! -e "$dest/service.tar"
systemctl stop lf-capstone36.service
test "$(cat /var/lib/lf-capstone36/state.json)" = '{"count":2}'
sha256sum /var/lib/lf-capstone36/state.json > "$dest/state-before.sha256"
stat -c '%u:%g:%a' /var/lib/lf-capstone36/state.json > "$dest/state-mode.txt"
tar --acls --xattrs --numeric-owner -cpf "$dest/service.tar" -C / opt/lf-capstone36 var/lib/lf-capstone36 etc/systemd/system/lf-capstone36.service
cd "$dest"
sha256sum service.tar > service.sha256
sha256sum -c service.sha256
mkdir -m 700 restore-test
tar --acls --xattrs --numeric-owner --same-owner -xpf service.tar -C restore-test
cmp /opt/lf-capstone36/app.py restore-test/opt/lf-capstone36/app.py
cmp /var/lib/lf-capstone36/state.json restore-test/var/lib/lf-capstone36/state.json
test "$(stat -c '%u:%g:%a' restore-test/var/lib/lf-capstone36/state.json)" = "$(cat state-mode.txt)"
systemctl start lf-capstone36.service
sleep .3
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":2}'
echo STOPPED_BACKUP_CHECKSUM_AND_EMPTY_DIRECTORY_RESTORE_PASSED
ROOT

service.tar: OK はアーカイブの整合性チェックです。その後、抽出されたプログラムやデータのバイト、および空のリストアテスト内のデータファイルのUID(User ID)、GID(Group ID)、権限を比較します。これはバックアップファイルの存在確認だけよりも強力な検証ですが、実際のサービス経路での障害からの復旧とはまだなっていません。そのプロセスは下記で別途実施されます。

アーカイブには、この演習のプログラム、データ、ユニットのみが含まれています。/var/backups は同じディスク上にあるため、完全なディスク損失に対する独立したバックアップではありません。実際の運用データの場合、別の場所に保存したコピーを準備し、アクセス権を分離して、指定された復元間隔でチェックしてください。tar のオプションについては GNU tar Debian マニュアル を参照できます。

ラボデータのみを破損させ、HTTPエラーを検出する

以下のブロックは、あなたが作成したばかりの /var/lib/lf-capstone36/state.json をJSONの文法上は有効でもアプリケーションには無効な状態へ意図的に変更します。整数が必要なcountに文字列を入れる実習です。これは通常のバックアップチェックを通過した後にのみ実行し、運用ファイルでパスを置き換えないでください。プロセスを停止したり、ディスクをいっぱいにする実験は行わないでください。

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/lf-capstone36
printf '{"count":"broken"}\n' > /var/lib/lf-capstone36/state.json
sha256sum /var/lib/lf-capstone36/state.json > "$dest/broken-state.sha256"
test "$(curl -sS -o "$dest/broken-get.txt" -w '%{http_code}' http://127.0.0.1:8086/)" = 503
test "$(curl -sS -X POST -o "$dest/broken-post.txt" -w '%{http_code}' http://127.0.0.1:8086/increment)" = 503
sha256sum -c "$dest/broken-state.sha256"
test "$(cat "$dest/broken-get.txt")" = '{"error":"state unavailable"}'
systemctl is-active lf-capstone36.service
ss -ltn 'sport = :8086'
journalctl -u lf-capstone36.service -n 8 --no-pager
echo ACTIVE_PROCESS_OPEN_PORT_BUT_GET_AND_POST_503_BROKEN_DATA_UNCHANGED
ROOT

JSON内で count が文字列だったため、GET と POST の両方は 503 を返すはずです。curl -f はエラー応答で失敗するため、このセクションでは -f を省略し、本文とステータスコードを別々に保存します。破損後、SHA-256 を再比較して、書き込み失敗リクエストがデータを初期化していないことを確認します。

実際の検証では、サービスは稼働しており、ポートもLISTEN状態でしたが、リクエストは503を返しました。Restart=on-failureはプロセスが失敗して終了した場合のポリシーであり、生きているプロセス内の不正なデータを自動的に修正するものではありません。だからこそ、プロセス、ソケット、HTTPレスポンス、データの意味を個別に確認する必要があります。

実データパスを復元し、新しい書き込みを検証する

サービスを停止した後、破損したファイルを証拠として保持し、確認済みアーカイブから1つのデータファイルのみを元の場所に復元します。通常のプログラムやサービスユニットを無差別に上書きしないでください。ここで復元は同じVM上で行われるため、以前に記録された数値のUIDおよびGIDを直接比較できます。別のサーバに移動する場合は、サービス移行および所有権マッピング のように、対象アカウントに基づいてリセットする必要があります。

sudo bash <<'ROOT'
set -euo pipefail
dest=/var/backups/lf-capstone36
systemctl stop lf-capstone36.service
cp -a /var/lib/lf-capstone36/state.json "$dest/broken-state.json"
cd "$dest"
sha256sum -c service.sha256
tar --acls --xattrs --numeric-owner --same-owner -xpf service.tar -C / var/lib/lf-capstone36/state.json
sha256sum -c state-before.sha256
test "$(stat -c '%u:%g:%a' /var/lib/lf-capstone36/state.json)" = "$(cat state-mode.txt)"
systemctl start lf-capstone36.service
sleep .3
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":2}'
test "$(curl -fsS -X POST http://127.0.0.1:8086/increment)" = '{"count":3}'
systemctl restart lf-capstone36.service
sleep .3
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":3}'
test "$(curl -fsS -X POST http://127.0.0.1:8086/increment)" = '{"count":4}'
test "$(curl -fsS http://127.0.0.1:8086/)" = '{"count":4}'
stat -c '%U:%G:%a' /var/lib/lf-capstone36/state.json
echo ACTUAL_RESTORE_COUNT2_NEW_WRITE3_RESTART3_NEW_WRITE4_PASSED
ROOT

保存されている状態ハッシュはバックアップ値2を示します。次のPOSTの前に、復元直後にそれを比較してください。3および4への成功した増分は意図的にファイルとそのハッシュを変更するため、後のハッシュ差異すべてを破損と見なすのではなく、新しい期待値を記録してください。

アーカイブおよびデータハッシュに対して予想される結果はOKであり、lf-capstone36:lf-capstone36:600 も同様です。復元された値2を読み取り、POSTで値3を書き込み、プロセスを再起動し、再度3を読み取り、書き込みをもう一度検証して4を取得します。ファイルが抽出されたという事実と、復元後に読み取り/書き込み操作が可能であるという事実を区別します。

変更を行う前に失敗したチェックを解釈する

症状 最初に確認すべきポイント
サービス起動の失敗 実行可能ファイル、ユーザー、パスのエラーをjournalctlで確認し、systemd-analyze verifyの結果も確認します。
プロセスはアクティブ、ポートなし 起動直後にMainPID、実行引数、バインドアドレス、重複ポート、およびログを確認してください。
GETが503を返す ファイルの存在、読み取り権限、JSONの構文、および整数型を確認し、最初に破損したファイルを保護してください。
読み取り成功、書き込み503 データディレクトリの権限、ReadWritePaths、残り容量、inode、およびファイル置換条件を確認してください。
再起動後に値が変わる 実際のデータパス、マウント、保存が成功したか、その他の書き込みプロセスを確認してください。

復旧が完了したら、作業ログにサービス状態、ポート、応答、データハッシュ、および復旧後に変更された通常値を記録してください。復旧ポイント以降に通常の取引やアップロードがあった場合、古いバックアップで現在のデータを上書きすると、それらの新しい変更が失われる可能性があるため、書き込み停止、別途保存、再適用方法を最初に決定してください。

ラボサービスをクリーンアップし、そのバックアップを保持する

以下のブロックは、本記事で新たに作成されたサービス、コード、データ、およびアカウントのみをクリーンアップします。比較のために、バックアップと損傷の証拠はルート専用ディレクトリに保持してください。保持期間後にコピーを削除する際は、正確なファイルを選択し、他のサービスのバックアップを一緒に削除しないでください。

sudo bash <<'ROOT'
set -euo pipefail
systemctl disable --now lf-capstone36.service
rm -- /etc/systemd/system/lf-capstone36.service /opt/lf-capstone36/app.py /var/lib/lf-capstone36/state.json
rmdir /opt/lf-capstone36 /var/lib/lf-capstone36
systemctl daemon-reload
userdel lf-capstone36
test -z "$(ss -H -ltn 'sport = :8086')"
echo OWN_SAMPLE_REMOVED_VALID_BACKUP_AND_BROKEN_EVIDENCE_RETAINED
ROOT