pytest.mark.chaos で始めるカオスエンジニアリング — Python テストに障害注入を組み込む

Fri, 17 Apr 2026 00:00:00 +0000

「本番で障害が起きてから対処する」のではなく、「テスト段階で意図的に障害を起こして耐性を確認する」。これがカオスエンジニアリングの基本思想だ。Python の pytest には、この考え方をテストコードに組み込むためのシンプルな仕組みがある。

pytest.mark.chaos とは

@pytest.mark.chaos は、pytest のカスタムマーカー機能を使って「カオステスト」を分類するためのラベルだ。pytest にはビルトインのマーカー（@pytest.mark.skip、@pytest.mark.parametrize など）があるが、chaos はユーザーが自由に定義するカスタムマーカーに該当する。

1
2
3
4
5
6
7


import pytest

@pytest.mark.chaos
def test_network_timeout():
 """ネットワークタイムアウト時にフォールバックが機能するか"""
 result = call_api_with_timeout(timeout=0.001)
 assert result == "fallback_response"

マーカーの登録

カスタムマーカーは pyproject.toml または pytest.ini に登録しておくと、PytestUnknownMarkWarning 警告を抑制できる。

1
2
3
4
5


# pyproject.toml
[tool.pytest.ini_options]
markers = [
 "chaos: カオスエンジニアリング関連のテスト（障害注入・耐性検証）",
]

選択実行

1
2
3
4
5
6
7
8


# カオステストだけを実行
pytest -m chaos

# カオステスト以外を実行（通常の CI）
pytest -m "not chaos"

# カオステストと統合テストを実行
pytest -m "chaos or integration"

これにより、通常の CI パイプラインではカオステストをスキップし、定期的なレジリエンス検証時にだけ実行するという運用が可能になる。

障害注入 on hdknr blog

pytest.mark.chaos で始めるカオスエンジニアリング — Python テストに障害注入を組み込む

pytest.mark.chaos とは

マーカーの登録

選択実行