一般的なデバッグとトラブルシューティングの問題

重要

AWS OpsWorks Stacks 新規顧客を受け付けなくなった。既存のお客様は、2024 年 5 月 26 OpsWorks 日まではコンソール、API、CLI、 CloudFormation リソースを通常どおり使用できますが、その時点で廃止されます。この移行に備えて、 AWS Systems Manager できるだけ早くスタックをに移行することをおすすめします。詳細については、「AWS OpsWorks Stacks サポート終了に関する FAQ」および「AWS OpsWorks Stacks アプリケーションを Application Manager AWS Systems Manager に移行する」を参照してください。

このセクションでは、一般的なデバッグやトラブルシューティングに関する問題とその解決方法について説明します。

トピック

• スタックのトラブルシューティング AWS OpsWorks
• インスタンス登録の問題のトラブルシューティング

インスタンス登録の問題のトラブルシューティング

このセクションでは、インスタンスの登録の一般的な問題とその解決方法を示します。

注記

登録の問題が発生した場合、register 引数を使用して --debug を実行します。これにより、デバッグの詳細情報を取得できます。

EC2User Is Not Authorized to Perform: ... (EC2User に以下を実行する権限がありません: ...)

問題: register コマンドで、次のような結果が返されます。

A client error (AccessDenied) occurred when calling the CreateGroup operation: 
User: arn:aws:iam::123456789012:user/ImportEC2User is not authorized to
perform: iam:CreateGroup on resource: 
arn:aws:iam::123456789012:group/AWS/OpsWorks/OpsWorks-b583ce55-1d01-4695-b3e5-ee19257d1911

原因: register コマンドは、必要なアクセス権限を付与しないユーザーの認証情報で実行されています。ユーザーのポリシーでは、数あるアクションの中で iam:CreateGroup アクションが許可されている必要があります。

ソリューション: register を必要なアクセス権限が付与された IAM ユーザー認証情報で指定します。詳細については、「AWS CLI のインストールおよび設定」を参照してください。

Credential Should Be Scoped to a Valid Region (認証情報の範囲を有効なリージョンに限定する必要があります)

問題: register コマンドにより、以下のような出力が返されます。

A client error (InvalidSignatureException) occurred when calling the
DescribeStacks operation: Credential should be scoped to a valid region, not 'cn-north-1'.

原因: コマンドのリージョンは、有効な AWS OpsWorks スタックリージョンである必要があります。サポートされているリージョンのリストについては、「リージョンのサポート」を参照してください。通常、このエラーは、次のいずれかの原因により発生します。

• スタックが別のリージョンにあり、スタックのリージョンをコマンドの --region 引数に割り当てた場合。

  スタックリージョンを指定する必要はありません。 AWS OpsWorks Stacks はスタック ID から自動的に決定します。

• --region 引数を省略したことにより、暗黙的にデフォルトのリージョンが指定されたものの、デフォルトのリージョンが AWS OpsWorks スタックでサポートされていません。

解決策:サポートされている AWS OpsWorks Stacks --region リージョンに明示的に設定するか、 AWS CLI configファイルを編集してデフォルトリージョンをサポートされている AWS OpsWorks Stacks リージョンに変更します。詳細については、「AWS コマンドラインインターフェイスの設定」を参照してください。