Looking for how to use this in your app?See Frontend Libraries →

CDKToolkit スタックの問題をトラブルシューティング

AWS Amplify では、アカウントにリソースをデプロイするために、AWS アカウントとリージョンを_ブートストラップ_する必要があります。Amplify は AWS Cloud Development Kit (AWS CDK) を使用してバックエンドリソース設定をスキャフォールドし、ブートストラップ処理によって作成された補足リソースを使用してデプロイを調整します。

_ブートストラップ_は、AWS 環境を AWS Cloud Development Kit (AWS CDK) で使用するために準備するプロセスです。CDK スタックを AWS 環境にデプロイする前に、環境をまずブートストラップする必要があります。

ブートストラップの詳細については、AWS CDK のブートストラップ概念に関する AWS ドキュメントを参照してください。

アカウントのブートストラップエラー

Amplify アプリケーションをデプロイするときに、現在のアカウント ID とリージョンのブートストラップを完了するために Amplify Console にリダイレクトされることがあります。このプロセスでエラーが発生した場合は、次のメッセージが表示されます。

Amplify Console

Error bootstrapping account in region "<your-aws-region>". There is an issue with the CDKToolkit stack which must be resolved manually.

これは通常、CDKToolkit スタック内の 1 つ以上のリソースの作成または更新に失敗したことを示します。AWS CloudFormation コンソールに移動し、CDKToolkit スタックを選択して、「Events」タブを選択し、リソースイベントを表示します。ここで、対応するアセットバケットの問題またはデプロイに使用される IAM ロールの問題を特定できます。

ブラウザベースの AWS CloudShell を使用して CDKToolkit スタックを手動で更新することで軽減できます。

AWS CloudShell

cdk bootstrap aws://$(aws sts get-caller-identity --query Account --output text)/$AWS_REGION

または、ターミナルから AWS CDK CLI を使用して bootstrap を実行します。

Terminal

npx aws-cdk@latest bootstrap aws://<your-aws-account-id>/<your-aws-region>

上記の回避策を適用した後もこの問題が続く場合は、Amplify Backend の GitHub リポジトリで問題を報告してください。

スタック CDKToolkit は既に存在します

Amplify アプリケーションを初めてデプロイしていて、CDK を使用するために AWS アカウントを以前にブートストラップしており、Amplify Console で以下のエラーが発生した場合: