mcpField
R
resilience-hub-getting-started

resilience-hub-getting-started

github.com/awsクラウド・DevOps3.3k4.0k 回インストール1 日前に更新
リポジトリ

resilience-hub-getting-started について

AWS Resilience Hub v2を初めて設定するチーム向けのガイドです。ポリシー、サービス、入力ソース、障害モード評価に加え、トラブルシューティングとセキュリティ上の注意点を扱います。

主な機能

  1. 01Resilience Hub v2の設定手順
  2. 02ポリシー・サービス・入力ソースの説明
  3. 03障害モード評価の手順
  4. 04設定時の問題のトラブルシューティング
  5. 05権限とデータ保護の指針

活用シーン

  1. 01Resilience Hub v2を新規設定
  2. 02評価の停滞やリソース未検出を調査
  3. 03アーキテクチャのポリシー目標への適合確認

MCP 対応

AWS APIの呼び出しにはAWS MCPサーバーが推奨されていますが、AWS CLIも利用できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aws/agent-toolkit-for-aws --skill resilience-hub-getting-started

インストール後、Claude Code で/resilience-hub-getting-startedを入力して読み込まれたか確認します。

同梱ファイルreferences/setup-procedure.md

詳細

AWS Resilience Hub v2 を使い始める

概要

Resilience Hub v2 を初めてセットアップする際に必要となる、ポリシー、システム、ユーザージャーニー、サービス、入力ソース、障害モード評価に関するドメイン知識です。

このスキルの AWS API 呼び出しの実行には AWS MCP サーバーの使用を推奨しますが、必須ではありません。すべての操作は AWS CLI から直接実行することもできます。

ガードレール — このスキルのファイルの保存場所（MCP とローカルインストール）

参照ファイルを読む前に、このスキルがどのように読み込まれたかを確認してください。

  • AWS MCP の retrieve_skill ツール経由で読み込まれた場合： このスキルの参照ファイルはローカルファイルシステム上にありません。file パラメーター（例：file="references/setup-procedure.md"）を指定して、各ファイルを retrieve_skill 経由で取得してください。これらのパスをローカルで file_read したり、ファイルシステム内で検索したりしないでください。
  • ローカルにインストールされている場合（例：.kiro/skills/resilience-hub-getting-started/ または ~/.claude/skills/resilience-hub-getting-started/）：ここに示されている相対パスを使って、ローカルのスキルディレクトリから参照ファイルを読み込んでください。

これはスキル自体の参照ファイルにのみ適用されます。ユーザーまたはセッションのデータは、必ず作業ディレクトリで読み書きし、retrieve_skill 経由では操作しないでください。

Resilience Hub v2 をセットアップする

Resilience Hub v2 を最初から設定するには、手順に正確に従ってください。 references/setup-procedure.md を参照してください。

トラブルシューティング

評価が IN_PROGRESS のまま止まる

aws resiliencehubv2 list-failure-mode-assessments で状態を確認します。30 分以上止まっている場合は、errorCode フィールドを確認してください。よくある原因は、クロスアカウントロールの INVALID_PERMISSIONS または CMK_ACCESS_DENIED です。

達成可能性が NOT_ACHIEVABLE と表示される

アーキテクチャがポリシーの目標を満たせません。FIS 実験を実行する前にインフラストラクチャを修正してください。アーキテクチャが根本的に不十分な場合、テストをしても解決にはなりません。

リソースが検出されない

入力ソースが正しいことを確認してください。CFN スタック ARN が存在すること、Terraform の状態ファイルにアクセスできること、EKS クラスターが指定されたリージョンにあること、またはリソースタグが実際のリソースと一致していることを確認してください。

セキュリティに関する考慮事項

  • 最小権限： 呼び出しロールのスコープを、入力ソースに含まれるリソースタイプのみの読み取り専用検出に限定してください。AWS 管理の AWSResilienceHubAsssessmentExecutionPolicy（AWS のスペルでは s が 3 つです）、またはより制限の厳しいカスタムポリシーをアタッチしてください。
  • 保存時／転送中の暗号化： Terraform の状態ファイルと評価レポートを保存する S3 バケットでは、サーバー側の暗号化（SSE-KMS）を使用し、aws:SecureTransport によって TLS を強制するバケットポリシーを設定することを推奨します。
  • 条件キー（混乱した代理人）： 呼び出しロールの信頼ポリシーに aws:SourceAccount 条件を追加してください。また、可能であれば、特定の Resilience Hub サービス ARN にスコープを限定した aws:SourceArn 条件も追加し、自分のアカウントの Resilience Hub だけがロールを引き受けられるようにしてください。
  • 評価情報の公開範囲を制限する： start-failure-mode-assessment を呼び出せるユーザー（この操作はインフラストラクチャの状態を読み取ります）と、評価結果やレポートを読み取れるユーザーを制限してください。これらには、機密性の高いアーキテクチャの詳細が含まれる場合があります。
  • 詳細情報： AWS Resilience Hub のセキュリティ と IAM のベストプラクティス（クロスサービスでの混乱した代理人の防止を含む）を参照してください。

コメント

Markdown 対応