プレビュー期間中に Fault Injection Testing へのアクセスをリクエストするには、Google Cloud アカウントマネージャーにお問い合わせください。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

テストをスケジュール設定する

このページでは、Fault Injection Testing でテストをスケジュールする方法と、外部スケジューリングサービスを使用して復元力テストを自動化する方法について説明します。

テストをスケジュールすると、テストプロセスを自動化し、ユーザーへの影響を最小限に抑える期間にテストを実行できます。たとえば、次のような場合です。

オフピーク時または計画メンテナンスの時間枠。
定期的にスケジュールされたゲームデーまたはカオスエンジニアリングドリル。
デプロイ前に復元力を検証するための自動テストパイプライン（CI/CD）。

テストをスケジュールすると、実行ごとに手動で介入することなく、システムのフォールトトレランスの継続的な検証を確立できます。

スケジュールされたテストの仕組み

Fault Injection Testing には、組み込みのスケジューリングサービスは含まれていません。代わりに、Fault Injection Testing を Cloud Scheduler などの外部スケジューリングサービスと統合して、テストをスケジュールします。

テストをスケジュールするには、特定の時間に Fault Injection Testing API を呼び出すか、gcloud コマンドを実行するように外部スケジューラを構成します。この統合をサポートするため、Fault Injection Testing には、startOnCreateEnabled パラメータが用意されています。このパラメータを true に設定すると、作成直後にテストを自動的に開始するようにシステムに指示します。

スケジュールされたテストのターゲットを選択する

スケジュールされたテストのターゲットリソースは、スケジューリング構成自体ではなく、テストテンプレート内で定義されます。Fault Injection Testing でターゲットを処理する方法は次のとおりです。

テストテンプレートを作成するときに、障害のタイプとターゲットリソースの選択条件を定義します。リソースの例としては、特定の VM インスタンス、一致するタグを持つリソース、特定のゾーン内のリソースなどがあります。
外部スケジューラを構成すると、API ペイロードはテストテンプレートを参照します。
スケジュールされた時間に、外部スケジューラがテストの作成をトリガーします。次に、Fault Injection Testing は、その時点のテンプレートのターゲット選択ルールを評価して、影響を受けるリソースを特定します。

テンプレートがタグに基づいて VM をターゲットにしている場合、スケジュールされたテストは、テストの実行時にそのタグを持つ VM に影響します。

スケジュールされたテストを設定する

続行する前に、roles/faulttesting.operator ロールまたは roles/faulttesting.admin ロールがあることを確認してください。

コンソールと Cloud Scheduler を使用してスケジュールを構成する Google Cloud

Fault Injection Testing コンソール内でスケジュールを直接作成することはできませんが、コンソールには Cloud Scheduler でジョブを設定するために必要なパラメータが用意されています。

コンソールで、[**テストテンプレート**] ページに移動します。 Google Cloud
テンプレートを選択して詳細を表示します。
詳細ページで、次の点に注意してください。
- JSON ペイロード（"startOnCreateEnabled": true を含む）。
- テストを作成するための REST API エンドポイント URL。
これらは Cloud Scheduler で使用します。
コンソールで、 [**Cloud Scheduler**] ページに移動し、 [**ジョブを作成**] をクリックします。 Google Cloud
ジョブのスケジュールとタイムゾーンを定義します。
[ターゲットタイプ] で [HTTP] を選択します。
[URL] を [テストテンプレート] 詳細ページの REST API エンドポイント URL に設定します。
[HTTP メソッド] を [POST] に設定します。

[本文] フィールドに JSON ペイロードを入力します。

{
  "experimentTemplate": "projects/PROJECT_ID/locations/REGION/experimentTemplates/TEMPLATE_ID",
  "startOnCreateEnabled": true,
  "description": "DESCRIPTION"
}

ジョブの認証を構成します。サービスアカウントの推奨事項については、ベストプラクティスをご覧ください。
[作成] をクリックします。

Google Cloud CLI を使用してスケジュールを構成する

シェルコマンドを実行するスクリプトまたはツールを使用している場合は、Cloud Scheduler または独自のスケジューラを構成してコマンドを --start-on-create-enabledフラグとともに実行するようにして、テストをスケジュールできます。gcloud alpha fault-testing experiments create

次のコマンドを実行して、テストインスタンスを作成してすぐに開始します。

gcloud alpha fault-testing experiments create EXPERIMENT_ID \
    --experiment-template=TEMPLATE_ID \
    --location=REGION \
    --start-on-create-enabled \
    [--description="DESCRIPTION"] \
    [--project=PROJECT_ID]

EXPERIMENT_ID: テスト実行の一意の識別子。このコマンドは自動化されているため、スクリプトは実行ごとに一意の ID を生成する必要があります。たとえば、タイムスタンプを追加できます: scheduled-exp-$(date +%s)。
TEMPLATE_ID: 事前構成されたテストテンプレートの ID。
REGION: テストが実行されるリージョン。 Google Cloud
--start-on-create-enabled: このフラグは、作成直後にテストを開始するように Fault Injection Testing に指示します。
DESCRIPTION: 省略可。テスト実行の説明。
PROJECT_ID：省略可。プロジェクト ID。 Google Cloud

テスト実行を管理する

スケジュールされた実行ごとに、新しい個別のテストインスタンスが作成されます。これらのインスタンスは、次のコマンドを使用して管理できます。

すべてのテスト実行を一覧表示するには:

gcloud alpha fault-testing experiments list --location=REGION

特定の実行の詳細を表示するには:

gcloud alpha fault-testing experiments describe EXPERIMENT_ID --location=REGION

実行中のテストを早期に停止するには:

gcloud alpha fault-testing experiments stop EXPERIMENT_ID --location=REGION

ベストプラクティス

テストをスケジュールする際は、次のベストプラクティスを考慮してください。

専用のサービスアカウントを使用する。スケジューラ（Cloud Scheduler など）を構成するときは、専用のサービスアカウントに関連付けます。このサービスアカウントには、プロジェクトの roles/faulttesting.operator や roles/faulttesting.admin など、テストの管理に必要な最小限の権限のみを付与します。
一意のテスト ID を生成する。スクリプトを使用してテストをトリガーする場合は、リソース名の競合を避けるため、スクリプトが実行ごとに一意のテスト ID を生成するようにします。
わかりやすい名前または説明を使用する。スケジュールされた実行ごとに、新しいテストインスタンスが作成されます。以前のテストは再開または上書きされません。わかりやすい名前または説明を使用して、実行をスケジュールにトレースできるようにします。
スケジュールの失敗をモニタリングする。ネットワークの問題、認証情報の有効期限切れ、API クォータが原因で、外部トリガーが失敗する可能性があります。ジョブの実行に失敗した場合やエラーレスポンスを受信した場合に通知されるように、スケジューラジョブにモニタリングとアラートを設定します。
除外時間枠と連携する。スケジュールされたテストが有効な除外時間枠と重複していないことを確認します。除外時間枠中にスケジュールされたテストがトリガーされると、Fault Injection Testing は実行をブロックし、テストは開始されません。