メニュー
AWS CloudFormation
ユーザーガイド (API Version 2010-05-15)

AWS CloudFormation StackSets のトラブルシューティング

このトピックでは、AWS CloudFormation StackSets に関する一般的な問題と、それらの問題について推奨される解決方法を示します。

スタックオペレーション失敗の一般的な原因

問題: スタックオペレーション失敗。スタックインスタンスのステータスは OUTDATED です。

原因: スタックオペレーションが失敗する一般的な原因は複数あります。

  • テンプレートで指定されているリソースを作成するターゲットアカウントのアクセス権限が不十分。

  • AWS CloudFormation テンプレートでエラーが発生する場合があります。AWS CloudFormation のテンプレートを検証し、スタックセットを作成する前にエラーを修正します。

  • テンプレートで、グローバルリソースを作成しようとしています。S3 バケットのように一意である必要がありますが、このリソースは一意ではありません。

  • 指定されたターゲットアカウント番号は存在しません。ウィザードの [Set deployment options] ページで指定したターゲットアカウント番号を確認します。

  • この管理者アカウントには、ターゲットアカウントとの信頼関係はありません。

  • テンプレートで指定されているリソースの最大数が既にターゲットアカウントに存在しています。たとえば、ターゲットアカウントで許可されている IAM ロールの制限に達していますが、テンプレートを使用して、さらに IAM ロールを作成できます。

  • スタックセットで許可されているスタックの最大数に達しました。最大数は 50 です。

ソリューション: スタックセットを作成する前にターゲットアカウントおよび管理者アカウントで必要なアクセス権限の詳細については、「アカウントのセットアップ」を参照してください。

失敗したスタック作成または更新オペレーションを再試行する

問題: スタック作成またはスタック更新の失敗。スタックインスタンスのステータスは OUTDATED です。スタックの作成または更新に失敗した場合にトラブルシューティングするには、AWS CloudFormation コンソールを開いてスタックのイベントを表示します。ステータスは、DELETED (作成オペレーションに失敗した場合)、または FAILED (更新オペレーションに失敗した場合) と表示されます。スタックイベントを参照し、[Status reason] 列を検索します。[Status reason] の値は、スタックオペレーションが失敗した理由を表します。

スタック作成失敗の根本的な原因を修正したら、スタック作成を再試行するために次の手順を行います。

ソリューション: スタックオペレーションを再試行するために、次のステップを行います。

  1. コンソールで、オペレーションが失敗したスタックを含むスタックセットを選択します。

  2. [Actions] メニューで、[Manage stacks in stack set] を選択します。

  3. [Select action] ページで、[Edit stacks] を選択して、スタックの作成または更新を再試行します。

  4. [Select template] ページで、同一の AWS CloudFormation テンプレートを使用するためにデフォルトオプションを [Current template] のままにします。テンプレートを変更せざるを得なかったことでスタックオペレーションに失敗したため、修正後のテンプレートをアップロードする場合は、[Upload a template to Amazon S3]、[Browse] の順に選択して、アップデート後のテンプレートを選択します。修正後のテンプレートのアップロードが完了したら、[Next] を選択します。

  5. [Specify details] ページで、テンプレート固有のパラメータを変更していない場合は、[Next] を選択します。

  6. [Set deployment options] ページで、必要に応じて [Maximum concurrent accounts] および [Failure tolerance] のデフォルトを変更します。これらの設定の詳細については、「スタックセットオペレーションのオプション」を参照してください。

  7. [Tags] ページで、必要に応じてタグを追加します。タグの詳細については、スタックセットオペレーションのオプション を参照してください。タグを追加したら、[Next] を選択します。

  8. [Review] ページで選択内容を確認し、チェックボックスをオンにして必要な IAM 機能を確認します。[Update stacks] を選択します。

  9. スタックが正常に更新されたら、スタックの作成を妨げている根本的な問題が解決されるまで、この手順を繰り返します。

スタックインスタンスの削除に失敗する場合

問題: スタックの削除に失敗した。

原因: 削除保護が有効になっているスタックでは、スタックを削除できない。

解決策: スタックの削除保護が有効になっているかどうかを確認する。有効になっている場合は、削除保護を無効にし、スタックインスタンスの実行を再度行います。