Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon CodeCatalyst のトラブルシューティング 次の情報は、CodeCatalyst での一般的な問題のトラブルシューティングに役立ちます。Amazon CodeCatalyst ヘルスレポートを使用して、エクスペリエンスに影響を与える可能性のあるサービスの問題があるかどうかを判断することもできます。 **Topics** + [一般的なアクセスの問題のトラブルシューティング](#troubleshooting-general) + [サポート問題のトラブルシューティング](#troubleshoot-support) + [Amazon CodeCatalyst の一部または全部を利用できません](#service-unavailable) + [CodeCatalyst でプロジェクトを作成できません](#troubleshoot-create-project) + [ユーザー名が切り捨てられているため、新しいユーザーとして BID スペースにアクセスできない、または新しい SSO ユーザーとして追加できません](#troubleshoot-username-truncated) + [新しいユーザーとしてフェデレーティッドスペースに SSO ユーザーを追加すると、重複したユーザーが作成されます](#troubleshoot-username-duplicated-SSO) + [CodeCatalyst でフィードバックを送信します](#troubleshoot-create-feedback) + [ソースリポジトリに関する問題のトラブルシューティング](troubleshooting-source.md) + [プロジェクトとブループリントのトラブルシューティング](projects-troubleshooting.md) + [開発環境に関する問題のトラブルシューティング](devenvironments-troubleshooting.md) + [ワークフローの問題のトラブルシューティング](troubleshooting-workflows.md) + [問題のトラブルシューティング](troubleshooting-issues.md) + [CodeCatalyst での検索に関する問題のトラブルシューティング](troubleshooting-search.md) + [拡張機能に関する問題のトラブルシューティング](troubleshooting-extensions.md) + [スペースに関連付けられたアカウントに関する問題のトラブルシューティング](troubleshooting-connections.md) + [Amazon CodeCatalyst と AWS SDK または AWS CLI の間で生じた問題のトラブルシューティング](troubleshooting-cli-sdk.md) ## 一般的なアクセスの問題のトラブルシューティング ### パスワードを忘れてしまいました **問題:** AWS ビルダー ID と Amazon CodeCatalyst に使用するパスワードを忘れてしまいました。 **解決方法:** この問題の最も簡単な解決方法は、パスワードをリセットすることです。 1. [Amazon CodeCatalyst](https://codecatalyst.aws/) を開き、**E メールアドレス**を入力します。次に、**[続行]**を選択します。 1. **[パスワードを忘れましたか?]** を選択します。 1. パスワード変更用のリンクが記載された E メールが送信されます。受信トレイで E メールが見つからない場合は、スパムフォルダを確認してください。 ### Amazon CodeCatalyst の一部または全部を利用できません **問題:** CodeCatalyst コンソールに移動した、またはそのコンソールへのリンクをたどったのですが、エラーが表示されます。 **解決方法:** この問題の最も一般的な原因は、招待されていないプロジェクトまたはスペースへのリンクをたどったか、サービスに一般提供の問題があることです。[[ヘルスレポート]](health-dashboard.md) をチェックして、サービスに既知の問題がないかどうかを確認します。ない場合は、プロジェクトまたはスペースに招待してくれたユーザーに連絡を取り、別の招待を依頼してください。どのプロジェクトやスペースにも招待されていない場合は、サインアップして[独自のスペースとプロジェクトを作成する](sign-up-create-resources.md)ことができます。 ### CodeCatalyst でプロジェクトを作成できません **問題:** プロジェクトを作成したいのですが、**[プロジェクトの作成]** ボタンが使用不可の状態で表示されるか、エラーメッセージが表示されます。 **解決方法:** この問題の最も一般的な理由は、**スペース管理者**ロールを持たない AWS ビルダー ID を使用してコンソールにサインインしていることです。スペースでプロジェクトを作成するには、このロールが必要です。 このロールがあるのに、ボタンが使用可能な状態で表示されない場合は、サービスに一時的な問題が発生している可能性があります。ブラウザを更新して、もう一度試してください。 ## サポート問題のトラブルシューティング ### Amazon CodeCatalyst サポート の にアクセスするとエラーが表示される **問題:** Amazon CodeCatalyst サポート の オプションを選択すると、次のエラーメッセージが表示されます。 **`Unable to assume role`** `To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the AWS アカウント that is the billing account for the space.` **解決方法:** スペースの請求アカウントである AWS アカウント に必要なロールを追加します。スペースの請求アカウントとして指定されたアカウントは、`AWSRoleForCodeCatalystSupport` ロールと `AmazonCodeCatalystSupportAccess` マネージドポリシーを使用します。詳細については、「[アカウントとスペース用の **AWSRoleForCodeCatalystSupport** ロールを作成する](ipa-iam-roles.md#ipa-iam-roles-support-create)」を参照してください。 **注記** AWS Builder ID は、認証されるエイリアスと、CodeCatalyst のアクセス許可に基づくリソースに対してのみサポートを受けることができます。アカウントと請求に関するサポートは、スペース内のすべてのユーザーが利用できます。ただし、ビルダーは CodeCatalyst でアクセス許可を持つリソースと情報に対してのみサポートを受けることができます。 ### スペースのテクニカルサポートケースを作成できません **問題:** スペースのテクニカルサポートケースを作成できません。 **解決方法:** スペース内のユーザーがテクニカルサポートケースを作成するには、ビジネスサポートプランまたはエンタープライズサポートプランをスペースの請求アカウントに追加する必要があります。スペース請求アカウントに サポート プランを追加するよう依頼するか、https://repost.aws/ にアクセスして AWS コミュニティに尋ねてください。 ### サポートケースのアカウントが CodeCatalyst のスペースに接続されなくなりました **問題:** サポートケースのアカウントが CodeCatalyst のスペースに接続されなくなりました。 **修正:** **スペース管理者**ロールを持つユーザーがスペース請求アカウントを切り替えると、 サポート プランと関連するすべてのケースがスペースから切断されます。古いスペース請求アカウントに関連付けられた サポート ケースは、Amazon CodeCatalyst サポート の に表示されなくなります。その請求アカウントのルートユーザーは、 から古いケースを表示および解決 AWS マネジメントコンソール し、他のユーザーが サポート 古いケースを表示および解決するための の IAM アクセス許可を設定できます。 AWS マネジメントコンソールを通じて古いスペースの請求アカウントから CodeCatalyst のテクニカルサポートを引き続き受けることはできませんが、 サポート プランがキャンセルされるまで他のサービスのテクニカルサポートを受けることはできます。 詳細については、「*サポート ユーザーガイド*」の「[Updating, resolving, and reopening your case](https://docs.aws.amazon.com//awssupport/latest/user/monitoring-your-case.html)」を参照してください。 ### サポート Amazon CodeCatalyst の AWS のサービス で別の のサポートケースを開くことができない **問題:** サポート CodeCatalyst の AWS のサービス で別の のサポートケースを開くことができません。 **解決方法:** CodeCatalyst サポートケースは、CodeCatalyst サポート の からのみ開くことができます。CodeCatalyst から別のサービス、Amazon AWS、またはその他のサードパーティーサービスにデプロイされたサービスまたはリソースのサポートが必要な場合は、 AWS マネジメントコンソール またはサードパーティーのサービスサポートチャネルを通じてケースを作成する必要があります。詳細については、「*サポート ユーザーガイド*」の「[Creating support cases and case management](https://docs.aws.amazon.com//awssupport/latest/user/case-management.html)」を参照してください。 ## Amazon CodeCatalyst の一部または全部を利用できません **問題:** CodeCatalyst コンソールに移動した、またはそのコンソールへのリンクをたどったのですが、エラーが表示されます。 **解決方法:** この問題の最も一般的な原因は、招待されていないプロジェクトまたはスペースへのリンクをたどったか、サービスに一般提供の問題があることです。[[ヘルスレポート]](health-dashboard.md) をチェックして、サービスに既知の問題がないかどうかを確認します。ない場合は、プロジェクトまたはスペースに招待してくれたユーザーに連絡を取り、別の招待を依頼してください。どのプロジェクトやスペースにも招待されていない場合は、サインアップして[独自のスペースとプロジェクトを作成する](sign-up-create-resources.md)ことができます。 ## CodeCatalyst でプロジェクトを作成できません **問題:** プロジェクトを作成したいのですが、**[プロジェクトの作成]** ボタンが使用不可の状態で表示されるか、エラーメッセージが表示されます。 **解決方法:** この問題の最も一般的な理由は、**スペース管理者**ロールを持たない AWS ビルダー ID を使用してコンソールにサインインしていることです。スペースでプロジェクトを作成するには、このロールが必要です。 このロールがあるのに、ボタンが使用可能な状態で表示されない場合は、サービスに一時的な問題が発生している可能性があります。ブラウザを更新して、もう一度試してください。 ## ユーザー名が切り捨てられているため、新しいユーザーとして BID スペースにアクセスできない、または新しい SSO ユーザーとして追加できません **問題:** CodeCatalyst ではユーザー名の 100 文字以降が切り捨てられるため、一部のユーザー名が同一に見える場合があります。CodeCatalyst スペースにアクセスする新規ユーザーの場合、次のように、スペースのタイプに応じてこの問題が発生します。 + CodeCatalyst へのサインインに使用する AWS Builder ID があります。スペースにサインインしようとすると、ユーザー名が無効であるというメッセージが表示されます。 + ID フェデレーションをサポートする CodeCatalyst スペースのフェデレーション ID 管理者です。IAM アイデンティティセンターの SSO ユーザーと SSO グループに新しいユーザーを追加すると、ユーザーが無効であるというメッセージが表示されます。 **解決方法:** CodeCatalyst にサインインした最初のユーザー、または指定の切り捨てられたユーザー名を持つ SSO ユーザーとしてスペースに追加された最初のユーザーが成功します。 AWS ビルダー ID でサインアップしたユーザー、またはその後 IAM Identity Center に追加されたユーザーは、名前が重複しているように見えるためサインインできません。スペースのタイプに応じて、次のいずれかを行います。 + AWS Builder ID スペースにサインインするには、別のユーザー名でサインアップします。 + IAM アイデンティティセンターに新しいユーザーを追加できるようにするために、別のユーザー名を使用するユーザーを追加する。 **注記** ユーザー名が切り捨てられているように見えますが、CodeCatalyst は切り捨てられたユーザー名の影響を受けない方法で ID にマッピングします。ただし、切り捨てられたユーザー名と同じユーザー名が作成された場合で、(同じスペースまたは IAM アイデンティティセンターアプリケーションを持つ) 関連付けられた別のユーザーがすでにその切り捨てられたユーザー名で CodeCatalyst に参加している場合は、そのユーザー名は使用できません。 ## 新しいユーザーとしてフェデレーティッドスペースに SSO ユーザーを追加すると、重複したユーザーが作成されます **問題:** CodeCatalyst SSO ユーザーが CodeCatalyst スペースに追加されてから削除された場合、ユーザー名の再利用を試みると問題が発生する可能性があります。これにより、次のようなエラーが発生する可能性があります。この場合、ユーザーは再作成されても複製は許可されません。 **`Unable to assume role`** `To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the AWS アカウント that is the billing account for the space.` **解決方法:** 既存の IDC ユーザーが削除され、新しいユーザーが同じユーザー名で再作成された場合、ユーザー名が古いユーザーと競合しているため、新しいユーザーはログインできません。SSO ユーザーとしてユーザー名がスペースに追加された後で、その名前を再度使用することはできません。 AWS ビルダー ID でサインアップしたユーザー、またはその後 IAM Identity Center に追加されたユーザーは、名前が重複しているように見えるためサインインできません。 スペースのタイプに応じて、次のいずれかを行います。 + AWS Builder ID スペースにサインインするには、別のユーザー名でサインアップします。 + IAM アイデンティティセンターに新しいユーザーを追加できるようにするために、別のユーザー名を使用するユーザーを追加する。 ## CodeCatalyst でフィードバックを送信します **問題:** CodeCatalyst でバグを見つけたので、フィードバックを送信したいです。 **解決方法:** CodeCatalyst でフィードバックを直接送信できます。 1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。 1. ナビゲーションペインで、**[フィードバックを送信]** を選択します。 1. ドロップダウンメニューからフィードバックのタイプを選択し、フィードバックを入力します。 # ソースリポジトリに関する問題のトラブルシューティング 次の情報は、CodeCatalyst でのソースリポジトリに関する一般的な問題のトラブルシューティングに役立ちます。 **Topics** + [スペースの最大ストレージ容量に達し、警告やエラーが表示されます](#source-troubleshoot-storage) + [Amazon CodeCatalyst ソースリポジトリのクローンを作成またはプッシュしようとするとエラーが表示されます](#source-troubleshoot-clone) + [Amazon CodeCatalyst ソースリポジトリにコミットまたはプッシュしようとするとエラーが表示されます](#source-troubleshoot-commit-code) + [プロジェクトにソースリポジトリが必要です](#source-troubleshoot-need-repository) + [ソースリポジトリはまったく新しいものなのにコミットが含まれています](#source-troubleshoot-initial-commit) + [デフォルトブランチとして別のブランチが必要です](#source-troubleshoot-default-branch) + [プルリクエストのアクティビティに関する E メールが届きます](#source-troubleshoot-repository-emails) + [個人用アクセストークン (PAT) を忘れてしまいました](#source-troubleshoot-forgot-pat) + [プルリクエストには、予想される変更が表示されません](#source-troubleshoot-pull-request-diff) + [プルリクエストに [マージ不可] のステータスが表示されます](#source-troubleshoot-pull-request-not-mergeable) ## スペースの最大ストレージ容量に達し、警告やエラーが表示されます **問題:** CodeCatalyst の 1 つ以上のソースリポジトリにコードをコミットしたいのですが、エラーが表示されます。コンソールには、ソースリポジトリページに、スペースのストレージ制限に達したというメッセージが表示されます。 **解決方法:** プロジェクトまたはスペース内のロールに応じて、1 つ以上のソースリポジトリのサイズを縮小するか、未使用のソースリポジトリを削除するか、請求枠をストレージの大きいものに変更することができます。 + プロジェクト内のソースリポジトリのサイズを縮小するには、未使用のブランチを削除します。詳細については、「[ブランチを削除する](source-branches-delete.md)」および「[コントリビューターロール](ipa-role-types.md#ipa-role-contributor)」を参照してください。 + スペースの全体的なストレージを減らすには、未使用のソースリポジトリを削除します。詳細については、「[ソースリポジトリを削除する](source-repositories-delete.md)」および「[プロジェクト管理者ロール](ipa-role-types.md#ipa-role-project-admin)」を参照してください。 + スペースで使用可能なストレージの量を増やすには、請求枠をストレージの大きいものに変更します。詳細については、「Amazon CodeCatalyst Administrator Guide」の「[Changing your CodeCatalyst billing tier](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-change-plan.html)」を参照してください。 ## Amazon CodeCatalyst ソースリポジトリのクローンを作成またはプッシュしようとするとエラーが表示されます **問題:** ローカルコンピュータまたは統合開発環境 (IDE) にソースリポジトリのクローンを作成しようとすると、アクセス許可エラーが表示されます。 **解決方法:** AWS Builder ID の個人用アクセストークン (PAT) がない、認証情報管理システムに PAT を設定していない、または PAT の有効期限が切れている可能性があります。次のソリューションのうち 1 つまたは複数を試してください。 + 個人用アクセストークン (PAT) を作成します。詳細については、「[個人用アクセストークンを使用してリポジトリアクセスをユーザーに付与する](ipa-tokens-keys.md)」を参照してください。 + ソースリポジトリを含むプロジェクトへの招待を承諾していること、自分がまだそのプロジェクトのメンバーであることを確認します。そのプロジェクトのアクティブなメンバーでない場合は、ソースリポジトリのクローンを作成することはできません。コンソールにサインインし、ソースリポジトリのクローンを作成しようとしているスペースとプロジェクトへの移動を試みます。スペースのプロジェクトのリストにプロジェクトが表示されない場合は、そのプロジェクトのメンバーではないか、そのプロジェクトへの招待を承諾していません。詳細については、「[招待の承諾と AWS ビルダー ID の作成](sign-up-sign-in.md)」を参照してください。 + クローンコマンドが正しくフォーマットされ、 AWS ビルダー ID が含まれていることを確認します。例えば、次のようになります。 ``` https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo ``` + を使用して AWS CLI 、 AWS ビルダー ID に関連付けられた PAT があり、有効期限が切れていないことを確認します。PAT がない場合や PAT の有効期限が切れている場合は、PAT を作成します。詳細については、「[個人用アクセストークンを使用してリポジトリアクセスをユーザーに付与する](ipa-tokens-keys.md)」を参照してください。 + ローカルリポジトリまたは IDE にクローンを作成するのではなく、ソースリポジトリ内のコードで作業するための開発環境の作成を試みます。詳細については、「[開発環境の作成](devenvironment-create.md)」を参照してください。 ## Amazon CodeCatalyst ソースリポジトリにコミットまたはプッシュしようとするとエラーが表示されます **問題:** ソースリポジトリにプッシュしようとすると、アクセス許可エラーが表示されます。 **解決方法:** コード変更をプロジェクトにコミットおよびプッシュできるロールがプロジェクトにない場合があります。変更をソースリポジトリにプッシュしようとしているプロジェクトでロールを表示します。詳細については、「[メンバーとそのプロジェクトロールのリストを取得する](projects-members.md#projects-members-view)」および「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」を参照してください。 変更のコミットとプッシュを許可するロールがある場合、変更をコミットしようとしているブランチに、そのブランチへのコード変更のプッシュを妨げるブランチルールが設定されている可能性があります。代わりに、ブランチを作成して、コードをそのブランチにプッシュしてみてください。詳細については、「[ブランチルールを使用してブランチで許可されたアクションを管理する](source-branches-branch-rules.md)」を参照してください。 ## プロジェクトにソースリポジトリが必要です **問題:** プロジェクトにソースリポジトリがないか、プロジェクトに別のソースリポジトリが必要です。 **解決方法:** 一部のプロジェクトはリソースなしで作成されます。プロジェクトのメンバーである場合は、CodeCatalyst でそのプロジェクトのソースリポジトリを作成できます。**スペース管理者**ロールを持つユーザーが **GitHub リポジトリ**をインストールして GitHub アカウントに接続した場合、**プロジェクト管理者**ロールを持っていれば、利用可能な GitHub リポジトリにリンクしてプロジェクトに追加できます。詳細については、「[ソースリポジトリを作成する](source-repositories-create.md)」および「[ソースリポジトリをリンクする](source-repositories-link.md)」を参照してください。 ## ソースリポジトリはまったく新しいものなのにコミットが含まれています **問題:** ソースリポジトリを作成したばかりです。空であるべきなのに、コミット、ブランチ、`README.md` ファイルが含まれています。 **解決方法:** これは想定されている動作です。CodeCatalyst のすべてのソースリポジトリには、デフォルトブランチを `main` に設定して、サンプルコード (サンプルコードが含まれているブループリントを使用してプロジェクト用にリポジトリが作成された場合) か、リポジトリ README ファイルのテンプレートマークダウンファイルのいずれかを含む初期コミットが含まれています。追加のブランチは、コンソール内および Git クライアント内で作成できます。コンソールでファイルを作成および編集し、開発環境と Git クライアントでファイルを削除できます。 ## デフォルトブランチとして別のブランチが必要です **問題:** ソースリポジトリに `main` という名前のデフォルトブランチが付属していましたが、デフォルトブランチとして別のブランチが必要です。 **解決方法:** CodeCatalyst のソースリポジトリ内でデフォルトブランチを変更または削除することはできません。追加のブランチを作成して、ワークフローのソースアクションでそれらのブランチを使用できます。GitHub リポジトリをリンクし、プロジェクトのリポジトリとして使用することもできます。 ## プルリクエストのアクティビティに関する E メールが届きます **問題:** プルリクエストアクティビティに関する E メール通知はサインアップも設定もしていませんが、なぜか届きます。 **解決方法:** プルリクエストアクティビティに関する E メール通知は自動的に送信されます。詳細については、「[Amazon CodeCatalyst でプルリクエストを用いてコードをレビューする](source-pull-requests.md)」を参照してください。 ## 個人用アクセストークン (PAT) を忘れてしまいました **問題:** ソースリポジトリのコードのクローン作成、プッシュ、プルに PAT を使用していましたが、トークンの値がわからなくなり、CodeCatalyst コンソールでも見つけることができません。 **解決方法:** この問題を解決する手っ取り早い方法は、別の PAT を作成し、この新しい PAT を使用するように認証情報マネージャーまたは IDE を設定することです。PAT の値は作成時にのみ表示されます。この値は失うと探し出せません。詳細については、「[個人用アクセストークンを使用してリポジトリアクセスをユーザーに付与する](ipa-tokens-keys.md)」を参照してください。 ## プルリクエストには、予想される変更が表示されません **問題:** プルリクエストを作成しましたが、送信元ブランチと送信先ブランチの間に表示されるはずの変更が表示されません。 **解決方法:** いくつかの問題が原因の可能性があります。次のソリューションのうち 1 つまたは複数を試してください。 + 古いリビジョン間の変更を確認しているか、最新の変更が表示されていない可能性があります。ブラウザを更新し、表示するリビジョン間の比較が選択されていることを確認してください。 + プルリクエストのすべての変更がコンソールに表示されるわけではありません。例えば、コンソールでは Git サブモジュールを表示できないため、プルリクエストのサブモジュールの違いを表示することはできません。違いが大きすぎて表示できない場合もあります。詳細については、「[CodeCatalyst のソースリポジトリのクォータ](source-quotas.md)」および「[ファイルを表示するファイルの変更履歴を表示する](source-files-view.md)」を参照してください。 + プルリクエストには、マージベースと選択したリビジョンの違いが表示されます。プルリクエストを作成すると表示される違いは、ソースブランチの一部とターゲットブランチの一部の間の違いです。プルリクエストが作成された後に表示される違いは、リビジョンとそのマージベースの違いです。マージベースは、リビジョンの作成時に送信先ブランチのチップであったコミットです。マージベースはリビジョン間で変更される可能性があります。Git の違いとマージベースの詳細については、Git ドキュメントの「[git-merge-base](https://git-scm.com/docs/git-merge-base)」を参照してください。 ## プルリクエストに [マージ不可] のステータスが表示されます **問題:** プルリクエストをマージしたいのですが、そのステータスが **[マージ不可]** と表示されます。 **解決方法:** 1 つ以上の問題が原因の可能性があります。 + プルリクエストは、すべての必須のレビュアーがプルリクエストを承認した後でマージできます。必須のレビュアーのリストで、名前の横に時計アイコンが付いているレビュアーを確認します。時計アイコンは、レビュアーがプルリクエストを承認していないことを示します。 **注記** 必須のレビュアーがプルリクエストを承認する前にプロジェクトから削除された場合、プルリクエストをマージすることはできません。プルリクエストを閉じて、新しいプルリクエストを作成してください。 + 送信元ブランチと送信先ブランチの間にマージの競合がある可能性があります。CodeCatalyst は、すべての可能な Git マージ戦略とオプションをサポートしているわけではありません。開発環境のマージの競合を確認するためにブランチを評価したり、マージの競合を見つけて解決するためにリポジトリを複製して IDE または Git のツールを使用したりできます。詳細については、「[プルリクエストをマージする](pull-requests-merge.md)」を参照してください。 # プロジェクトとブループリントのトラブルシューティング このセクションでは、Amazon CodeCatalyst のプロジェクトとブループリントの操作時に発生する可能性のある一般的な問題のトラブルシューティングについて説明します。 # AWS Fargate 設計図に apache-maven-3.8.6 の依存関係がない Java API **問題:** AWS Fargate 設計図を使用して Java API から作成されたプロジェクトの場合、ワークフローは失敗し、`apache-maven-3.8.6`依存関係が欠落しているというエラーが発生します。ワークフローは失敗し、次の例のように出力されています。 ``` Step 8/25 : RUN wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz -P /tmp ---> Running in 1851ce6f4d1b [91m--2023-03-10 01:24:55-- https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz [0m[91mResolving dlcdn.apache.org (dlcdn.apache.org)... [0m[91m151.101.2.132, 2a04:4e42::644 Connecting to dlcdn.apache.org (dlcdn.apache.org)|151.101.2.132|:443... [0m[91mconnected. [0m[91mHTTP request sent, awaiting response... [0m[91m404 Not Found 2023-03-10 01:24:55 ERROR 404: Not Found. [0mThe command '/bin/sh -c wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz -P /tmp' returned a non-zero code: 8 [Container] 2023/03/10 01:24:55 Command failed with exit status 8 ``` **解決策:** 次のステップを使用して、ブループリントの Dockerfile を更新します。 1. 検索バーに `apache-maven-3.8.6` と入力し、 AWS Fargate ブループリントを使用して Java API で作成されたプロジェクト内の Dockerfile を見つけます。 1. Dockerfile (`/static-assets/app/Dockerfile`) を更新し、`maven:3.9.0-amazoncorretto-11` をベースイメージとして使用して、`apache-maven-3.8.6` パッケージへの依存関係を削除します。 1. (推奨) Maven ヒープサイズを 6 GB に更新することを推奨します。 以下は Dockerfile の例です。 ``` FROM maven:3.9.0-amazoncorretto-11 AS builder COPY ./pom.xml ./pom.xml COPY src ./src/ ENV MAVEN_OPTS='-Xmx6g' RUN mvn -Dmaven.test.skip=true clean package FROM amazoncorretto:11-alpine COPY —from=builder target/CustomerService-0.0.1.jar CustomerService-0.0.1.jar EXPOSE 80 CMD ["java","-jar","-Dspring.profiles.active=prod","/CustomerService-0.0.1.jar", "—server.port=80"] ``` # 3 層のモダンウェブアプリケーションのブループリントワークフローの **OnPullRequest** が Amazon CodeGuru のアクセス許可エラーで失敗する **問題:** プロジェクトのワークフローを実行しようとすると、ワークフローは実行に失敗し、次のメッセージが表示されます。 ``` Failed at codeguru_codereview: The action failed during runtime. View the action's logs for more details. ``` `` **解決策:** このアクションの失敗の考えられる原因の 1 つは、IAM ロールポリシーのアクセス許可がないことが原因である可能性があります。接続されている で CodeCatalyst が使用するサービスロールのバージョン AWS アカウント に、**codeguru\$1codereview** アクションが正常に実行されるために必要なアクセス許可がありません。この問題を修正するには、サービスロールを必要なアクセス許可で更新するか、ワークフローに使用されるサービスロールを Amazon CodeGuru および Amazon CodeGuru Reviewer に必要なアクセス許可を持つサービスロールに変更する必要があります。次のステップを使用して、ロールを検索し、ロールポリシーのアクセス許可を更新して、ワークフローが正常に実行されるようにします。 **注記** これらのステップは、CodeCatalyst の以下のワークフローに適用されます。 CodeCatalyst の 3 層モダンウェブアプリケーションのブループリントで作成されたプロジェクトの **OnPullRequest** ワークフロー。 Amazon CodeGuru または Amazon CodeGuru Reviewer にアクセスするアクションを使用して CodeCatalyst のプロジェクトに追加されたワークフロー。 各プロジェクトには、CodeCatalyst のプロジェクト AWS アカウント に接続された によって提供されるロールと環境を使用するアクションを含むワークフローが含まれています。アクションとその指定されたポリシーを含むワークフローは、/.codecatalyst/workflows ディレクトリのソースリポジトリに保存されます。既存のワークフローに新しいロール ID を追加しない限り、ワークフロー YAML の変更は必要ありません。YAML テンプレートの要素とフォーマットの詳細については、「[ワークフロー YAML 定義](workflow-reference.md)」を参照してください。 これらは、ロールポリシーを編集し、ワークフロー YAML を検証するためのステップの概要です。 **ワークフロー YAML でロール名を参照し、ポリシーを更新するには** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。 1. CodeCatalyst スペースに移動します。プロジェクトに移動します。 1. **[CI/CD]** を選択し、**[ワークフロー]** を選択します。 1. **[OnPullRequest]** というタイトルのワークフローを選択します。**[Definition]** (定義) タブを選択します。 1. ワークフロー YAML の **codeguru\$1codereview** アクションの `Role:` フィールドで、ロール名を書き留めます。これは、IAM で変更するポリシーのロールです。以下の例は、ロール名を示しています。 ![\[ワークフロー YAML で IAM ロール名を表示する\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/projects/ts-workflow-role.png) 1. 次のいずれかを行います。 + (推奨) Amazon CodeGuru および Amazon CodeGuru Reviewer に必要なアクセス許可を使用して、プロジェクトに接続されたサービスロールを更新します。ロールには、一意の識別子が付加された `CodeCatalystWorkflowDevelopmentRole-spaceName` という名前が付けられます。ロールとロールポリシーの詳細については、「[**CodeCatalystWorkflowDevelopmentRole-*spaceName*** サービスロールについて](ipa-iam-roles.md#ipa-iam-roles-service-role)」を参照してください。次のステップに進み、IAM でポリシーを更新します。 **注記** ロールとポリシー AWS アカウント を持つ への AWS 管理者アクセス権が必要です。 + ワークフローに使用されるサービスロールを、Amazon CodeGuru および Amazon CodeGuru Reviewer に必要なアクセス許可を持つサービスロールに変更するか、必要なアクセス許可を持つ新しいロールを作成します。 1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) で IAM コンソールを開きます。 IAM コンソールで、ステップ 5 のロール (`CodeCatalystPreviewDevelopmentRole` など) を見つけます。 1. ステップ 5 のロールで、アクセス許可ポリシーを変更して `codeguru-reviewer:*` および `codeguru:*` のアクセス許可を含めます。これらのアクセス許可を追加した後、アクセス許可ポリシーは次のようになります。 1. ポリシーを修正したら、CodeCatalyst に戻り、ワークフローの実行を再度開始します。 ## まだ問題を解決できていない場合 [Amazon CodeCatalyst](https://codecatalyst.aws/) にアクセスするか、[サポートフィードバックフォーム](https://support.aws.amazon.com/#/contacts/aws-account-support/)に入力できます。**[リクエスト情報]** セクションの **[お問い合わせ内容をご記入ください]**」に Amazon CodeCatalyst のユーザーであることを記入してください。問題に最大限効率的に対処できるように、できるだけ詳しく説明してください。 # 開発環境に関する問題のトラブルシューティング 開発環境に関連する問題のトラブルシューティングについては、以下のセクションを参照してください。環境タグ付けの詳細については、「[CodeCatalyst で開発環境を使用してコードを記述および変更する開発環境でコードを記述および変更する](devenvironment.md)」を参照してください。 **Topics** + [クォータに問題があるため、開発環境の作成が成功しなかった](#troubleshooting-devenvironments-create) + [開発環境からリポジトリ内の特定のブランチに変更をプッシュできない](#troubleshooting-devenvironments-branchrules) + [開発環境が再開されなかった](#troubleshooting-devenvironments-resume) + [開発環境が切断された](#troubleshooting-devenvironments-connection) + [VPC に接続された開発環境が失敗した](#troubleshooting-devenvironments-vpc) + [プロジェクトがどのディレクトリにあるかわからない](#troubleshooting-devenvironments-projects) + [SSH 経由で開発環境に接続できない](#troubleshooting-devenvironments-connect-ssh) + [ローカル SSH 設定がないため、SSH 経由で開発環境に接続できない](#troubleshooting-devenvironments-projects-ssh-config) + [`codecatalyst` プロファイル AWS Config の に問題があるため、SSH 経由で開発環境に接続できません](#troubleshooting-devenvironments-config-profile) + [単一のサインオンアカウントを使用して CodeCatalyst にサインインすると、開発環境を作成できない](#troubleshoot-create-dev-env-idprovider) + [IDE に関する問題のトラブルシューティング](devenvironments-troubleshooting-ides.md) + [devfiles に関する問題のトラブルシューティング](devenvironments-devenvironments-devfile.md) ## クォータに問題があるため、開発環境の作成が成功しなかった **問題:** CodeCatalyst で開発環境を作成したいが、エラーが表示される。コンソールで、開発環境ページに、スペースのストレージ制限に達したことを示すメッセージが表示されます。 **解決方法:** プロジェクトまたはスペース内のロールに応じて、1 つ以上の独自の開発環境を削除するか、スペース管理者ロールがある場合は、他のユーザーが作成した未使用の開発環境を削除できます。請求階層を、より多くのストレージが含まれる請求階層に変更することもできます。 + ストレージ制限を表示するには、Amazon CodeCatalyst スペースの **[請求]** タブを表示して、**[使用量]** クォータが最大許容数に達したかどうかを確認します。クォータが上限に達した場合は、スペース管理者ロールを持つユーザーに連絡して、不要な開発環境を削除するか、請求階層の変更を検討してください。 + 不要になった開発環境を削除するには、「[開発環境の削除](devenvironment-delete.md)」を参照してください。 問題が継続し、IDE でエラーが発生した場合は、開発環境を作成できる CodeCatalyst ロールがあることを確認してください。**[スペース管理者]** ロール、**[プロジェクト管理者]** ロール、および **[コントリビューター]** ロールにはすべて、開発環境を作成するアクセス許可があります。詳細については、「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」を参照してください。 ## 開発環境からリポジトリ内の特定のブランチに変更をプッシュできない **問題:** 開発環境のコード変更をコミットしてソースリポジトリのブランチにプッシュしたいが、エラーが表示される。 **解決方法:** プロジェクトまたはスペース内のロールによっては、プロジェクト内のソースリポジトリにコードをプッシュするアクセス許可がない場合があります。**[スペース管理者]** ロール、**[プロジェクト管理者]** ロール、および **[コントリビューター]** ロールはすべて、プロジェクト内のリポジトリにコードをプッシュするアクセス許可を持っています。 **[コントリビューター]** ロールを持っているが、特定のブランチにコードをプッシュできない場合、そのロールを持つユーザーがそのブランチにコードをプッシュできないように、特定のブランチにブランチルールが設定されている場合があります。変更を別のブランチにプッシュするか、ブランチを作成してから、コードをそのブランチにプッシュしてみてください。詳細については、「[ブランチルールを使用してブランチで許可されたアクションを管理する](source-branches-branch-rules.md)」を参照してください。 ## 開発環境が再開されなかった **問題:** 開発環境を停止した後、再開できない。 **解決方法:** 問題を解決するには、Amazon CodeCatalyst スペースの **[請求]** タブを表示して、**[使用量]** クォータが上限に達したかどうかを確認します。クォータが上限に達した場合は、スペース管理者に連絡して請求階層を引き上げてください。 ## 開発環境が切断された **問題:** 使用中に開発環境が切断されました。 **解決方法:** 問題を解決するには、インターネット接続を確認してください。インターネットに接続していない場合は、開発環境に接続して作業を再開します。 ## VPC に接続された開発環境が失敗した **問題:** VPC 接続を開発環境に関連付けると、エラーが発生しています。 **解決方法:** Docker は、同じブリッジネットワークに接続されているコンテナが通信できるようにするブリッジネットワークと呼ばれるリンクレイヤーデバイスを使用します。デフォルトのブリッジは、コンテナのネットワークに通常 `172.17.0.0/16` サブネットを使用します。環境のインスタンスの VPC サブネットが、Docker で既に使用しているのと同じアドレス範囲を使用している場合、IP アドレスの競合が発生する可能性があります。Amazon VPC および同じ IPv4 CIDR アドレスブロックを使用した Docker の IP アドレスの競合を解決するには、`172.17.0.0/16` とは異なる CIDR ブロックを設定します。 **注記** 既存の VPC またはサブネットの IP アドレスの範囲を変更することはできません。 ## プロジェクトがどのディレクトリにあるかわからない **問題:** プロジェクトがどのディレクトリにあるかわからない。 **解決方法:** プロジェクトを見つけるには、ディレクトリを `/projects` に変更します。これは、プロジェクトを検索できるディレクトリです。 ## SSH 経由で開発環境に接続できない SSH を使用して開発環境への接続をトラブルシューティングするには、`-vvv` オプションを使用して `ssh` コマンドを実行して、問題の解決方法の詳細を表示できます。 ``` ssh -vvv codecatalyst-dev-env=== ``` ## ローカル SSH 設定がないため、SSH 経由で開発環境に接続できない ローカル SSH 設定 (`~/.ssh/config`) が欠落している場合、または `Host codecatalyst-dev-env*` セクションの内容が古い場合、SSH 経由で開発環境に接続することはできません。これをトラブルシューティングするには、`Host codecatalyst-dev-env*` セクションを削除し、**[SSH Access]** モーダルから最初のコマンドを再度実行します。詳細については、「[SSH を使用した開発環境への接続](devenvironment-connect-ssh.md)」を参照してください。 ## `codecatalyst` プロファイル AWS Config の に問題があるため、SSH 経由で開発環境に接続できません `codecatalyst` プロファイルの your AWS Config (`~/.aws/config`) が、「」で説明されているものと一致していることを確認します[CodeCatalyst AWS CLI で を使用するための のセットアップ](set-up-cli.md)。そうでない場合は、`codecatalyst` のプロファイルを削除し、**[SSH Access]** モーダルから最初のコマンドを再度実行します。詳細については、「[SSH を使用した開発環境への接続](devenvironment-connect-ssh.md)」を参照してください。 ## 単一のサインオンアカウントを使用して CodeCatalyst にサインインすると、開発環境を作成できない **問題:** CodeCatalyst コンソールに SSO ユーザーとしてサインインすると、スペースに開発環境を作成すると、不明な例外エラーが表示されます。開発環境を作成し、アクセスする IDE を選択すると AWS Cloud9、次のような問題が発生します。 + CodeCatalyst コンソールの **[開発環境]** ページには、一覧内の開発環境が `FAILED` 状態で表示されます。 + 次のようなエラーメッセージが表示されます。 **`An unknown exception happened`** `We encountered an unknown exception when launching your Dev Environment. Mention your Dev Environment id error_message_ID if you want to report or need any help.` **解決方法:** 開発環境は、Active Directory が ID プロバイダーとして使用されているスペースのユーザーは利用できません。スペース管理者は、IAM アイデンティティセンターなどの開発環境にアクセスするために、代替 ID プロバイダーを使用できます。ID フェデレーションをサポートするスペースの計画の詳細については、「*CodeCatalyst 管理者ガイド*」の「[ID フェデレーションをサポートするスペースの計画](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation)」を参照してください。 # IDE に関する問題のトラブルシューティング CodeCatalyst の IDE に関連する問題のトラブルシューティングについては、次のセクションを参照してください。IDE の詳細については、「[IDE で開発環境を作成する](devenvironment-create.md#devenvironment-using-ide)」を参照してください。 **Topics** + [AWS Cloud9 でランタイムイメージのバージョンが一致しません](#troubleshooting-devenvironments-c9-runtime) + [AWS Cloud9 の `/projects/projects` でファイルにアクセスできない](#troubleshooting-devenvironments-c9-filesystem) + [カスタム devfile を使用して AWS Cloud9 で開発環境を起動できない](#troubleshooting-devenvironments-c9-image) + [AWS Cloud9 で問題が発生する](#troubleshooting-c9) + [JetBrains で CodeCatalyst を使用して開発環境に接続できない](#troubleshooting-jetbrains-connect) + [IDE に AWS Toolkit をインストールできない](#troubleshooting-ide-toolkit) + [IDE で開発環境を起動できない](#troubleshooting-ide-launch) ## AWS Cloud9 でランタイムイメージのバージョンが一致しません AWS Cloud9 は、フロントエンドアセットとバックエンドランタイムイメージの異なるバージョンを使用しています。異なるバージョンを使用すると、Git 拡張機能と AWS Toolkit が正しく動作しない可能性があります。問題を解決するには、開発環境ダッシュボードに移動し、開発環境を停止してから、再度起動します。API 使用して問題を修正し、`UpdateDevEnvironment` API を使用してランタイムを更新します。詳細については、「*Amazon CodeCatalyst API リファレンス*」の「[UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html)」を参照してください。 ## AWS Cloud9 の `/projects/projects` でファイルにアクセスできない AWS Cloud9 エディタは、ディレクトリ「`/projects/projects`」内のファイルにアクセスできません。問題を解決するには、AWS Cloud9 ターミナルを使用してファイルにアクセスするか、別のディレクトリに移動します。 ## カスタム devfile を使用して AWS Cloud9 で開発環境を起動できない devfile イメージが AWS Cloud9 と互換性がない可能性があります。問題を解決するには、リポジトリと、対応する開発環境から devfile を確認し、新しい devfile を作成して続行します。 ## AWS Cloud9 で問題が発生する その他の問題については、「[AWS Cloud9 ユーザーガイド](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html)」のトラブルシューティングセクションを参照してください。 ## JetBrains で CodeCatalyst を使用して開発環境に接続できない 問題を解決するには、最新バージョンの JetBrains のみがインストールされていることを確認します。複数のバージョンがある場合は、古いバージョンをアンインストールし、IDE とブラウザを閉じてプロトコルハンドラーを再登録します。次に JetBrains を開き、プロトコルハンドラーを再登録します。 ## IDE に AWS Toolkit をインストールできない VS Code のこの問題を修正するには、[[GitHub]](https://github.com/aws/aws-toolkit-vscode/releases) から手動で AWS Toolkit for Visual Studio Code をインストールします。 JetBrains のこの問題を修正するには、[[GitHub]](https://github.com/aws/aws-toolkit-jetbrains/releases) から手動で AWS Toolkit for JetBrains をインストールします。 ## IDE で開発環境を起動できない VS Code のこの問題を修正するには、最新バージョンの VS Code と AWS Toolkit for Visual Studio Code がインストールされていることを確認します。最新バージョンがない場合は、開発環境を更新して起動します。詳細については、「[VS Code 用の Amazon CodeCatalyst](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html)」ユーザーガイドを参照してください。 JetBrains のこの問題を修正するには、最新バージョンの JetBrains と AWS Toolkit for JetBrains がインストールされていることを確認します。最新バージョンがない場合は、開発環境を更新して起動します。詳細については、「[JetBrains 用の Amazon CodeCatalyst](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html)」ユーザーガイドを参照してください。 # devfiles に関する問題のトラブルシューティング CodeCatalyst の devfiles に関連する問題のトラブルシューティングについては、次のセクションを参照してください。devfiles の詳細については、「[開発環境に devfile を設定](devenvironment-devfile.md)」を参照してください。 **Topics** + [カスタム devfile にカスタムイメージを実装したにもかかわらず、開発環境はデフォルトのユニバーサル devfile を使用しています](#troubleshooting-devenvironments-custom-image) + [プロジェクトがデフォルトのユニバーサル devfile を使用して開発環境にビルドされていない](#troubleshooting-devenvironments-default-image) + [開発環境のリポジトリ devfile を移動したい](#troubleshooting-devenvironments-devfile-moving) + [devfile の開始時に問題が発生しています](#troubleshooting-devenvironments-devfile-recovery) + [devfile のステータスを確認する方法がわからない](#troubleshooting-devenvironments-devfile-status) + [devfile が最新のイメージで提供されているツールと互換性がない](#troubleshooting-devenvironments-devfile-version) ## カスタム devfile にカスタムイメージを実装したにもかかわらず、開発環境はデフォルトのユニバーサル devfile を使用しています カスタム devfile を使用している開発環境の起動中に CodeCatalyst でエラーが発生した場合、開発環境はデフォルトでデフォルトのユニバーサル devfile になります。問題を解決するには、`/aws/mde/logs/devfile.log` のログで正確なエラーを確認できます。ログ「`/aws/mde/logs/devfileCommand.log`」で `postStart` 実行が成功したかどうかを確認することもできます。 ## プロジェクトがデフォルトのユニバーサル devfile を使用して開発環境にビルドされていない 問題を解決するには、カスタム devfile を使用していないことを確認します。カスタム devfile を使用していない場合は、プロジェクトのソースリポジトリにある `devfile.yaml` ファイルを表示して、エラーを見つけて修正します。 ## 開発環境のリポジトリ devfile を移動したい `/projects/devfile.yaml` のデフォルトの devfile をソースコードリポジトリに移動できます。devfile の場所を更新するには、コマンド「`/aws/mde/mde start --location repository-name/devfile.yaml`」を使用します。 ## devfile の開始時に問題が発生しています devfile の開始に問題がある場合、復旧モードになり、環境に接続して devfile を修正できます。リカバリモードの間、`/aws/mde/mde status` の実行には devfile の場所は含まれません。 ``` { "status": "STABLE" } ``` `/aws/mde/logs` のログでエラーを確認し、devfile を修正して、もう一度 `/aws/mde/mde start` を実行してみてください。 ## devfile のステータスを確認する方法がわからない devfile のステータスを確認するには、`/aws/mde/mde status` を実行します。このコマンドを実行すると、次のいずれかが表示されます。 + `{"status": "STABLE", "location": "devfile.yaml" }` これは、devfile が正しいことを示します。 + `{"status": "STABLE" }` これは、devfile が起動できず、復旧モードになったことを示します。 `/aws/mde/logs/devfile.log` のログで正確なエラーを確認できます。 ログ「`/aws/mde/logs/devfileCommand.log`」で `postStart` 実行が成功したかどうかを確認することもできます。 詳細については、「[開発環境のユニバーサル devfile イメージの指定](devenvironment-universal-image.md)」を参照してください。 ## devfile が最新のイメージで提供されているツールと互換性がない 開発環境では、特定のプロジェクトに必要なツーリングが `latest` ツーリングにない場合、`devfile` または `devfile postStart` が失敗する可能性があります。問題を解決するには、以下を実行します。 1. devfile に移動します。 1. devfile で、`latest` ではなく粒度の細かいイメージバージョンに更新します。具体的には、次のようになります。 ``` components: - container: image: public.ecr.aws/amazonlinux/universal-image:1.0 ``` 1. 更新された devfile を使用して新しい開発環境を作成します。 # ワークフローの問題のトラブルシューティング Amazon CodeCatalyst でのワークフローに関連する問題のトラブルシューティングについては、次のセクションを参照してください。ワークフローの詳細については、「[ワークフローを使用して構築、テスト、デプロイするワークフローを使用して構築、テスト、デプロイする](workflow.md)」を参照してください。 **Topics** + [「ワークフローが非アクティブです」というメッセージを解決するにはどうすればよいですか?](#troubleshooting-workflows-inactive) + [「ワークフロー定義に *n* 個のエラーがあります」というエラーを解決修正するにはどうすればよいですか?](#troubleshooting-workflows-asterisks) + [「認証情報が見つかりません」および「ExpiredToken」というエラーを解決するにはどうすればよいですか?](#troubleshooting-workflows-auth-errors-eks) + [「サーバーに接続できません」というエラーを解決するにはどうすればよいですか?](#troubleshooting-workflows-unable-connect-eks) + [ビジュアルエディタに CodeDeploy フィールドがないのはなぜですか?](#troubleshooting-workflows-codedeploy) + [IAM 機能エラーを解決するにはどうすればよいですか?](#troubleshooting-workflows-capabilities) + [「npm install」エラーを解決するにはどうすればよいですか?](#troubleshooting-workflows-npm) + [複数のワークフローに同じ名前が付いているのはなぜですか?](#troubleshooting-workflows-name) + [ワークフロー定義ファイルを別のフォルダに保存できますか?](#troubleshooting-workflows-folder) + [ワークフローにアクションを順番に追加するにはどうすればよいですか?](#troubleshooting-workflows-visual) + [ワークフローは正常に検証されるのに、ランタイム時に失敗するのはなぜですか?](#troubleshooting-workflows-validation) + [自動検出でアクションのレポートが検出されなません](#troubleshooting-reports-auto-discovery) + [成功基準を設定した後、自動検出レポートでアクションが失敗します](#troubleshooting-success-auto-discovery) + [自動検出で不要なレポートが生成されます](#troubleshooting-unwanted-auto-discovery) + [自動検出で、1 つのテストフレームワークに多数の小さなレポートが生成されます](#troubleshooting-reports-combined) + [CI/CD に一覧表示されるワークフローがソースリポジトリのワークフローと一致しません](#troubleshooting-workflow-source) + [ワークフローを作成したり更新したりできません](#troubleshooting-workflows-branchrules) ## 「ワークフローが非アクティブです」というメッセージを解決するにはどうすればよいですか? **問題**: CodeCatalyst コンソールの **CI/CD **の**ワークフロー**で、ワークフローに次のメッセージが表示されます。 `Workflow is inactive.` このメッセージは、ワークフロー定義ファイルに、現在使用しているブランチに適用されないトリガーが含まれていることを示します。例えば、ワークフロー定義ファイルには `main` ブランチを参照する `PUSH` トリガーが含まれている場合がありますが、ユーザーが機能ブランチを使用しているとします。機能ブランチで行った変更は `main` に適用されないため、`main` でワークフローの実行が開始されないことから、CodeCatalyst はブランチのワークフローを廃止し、`Inactive` としてマークします。 **解決方法:** 機能ブランチでワークフローを開始する場合は、次を実行します。 + 機能ブランチのワークフロー定義ファイルで、`Triggers` セクションから `Branches` プロパティを削除します。すると、次のようになります。 ``` Triggers: - Type: PUSH ``` この設定により、機能ブランチを含む任意のブランチへのプッシュ時にトリガーがアクティブ化されます。トリガーがアクティブ化されると、CodeCatalyst は、プッシュ先のブランチのワークフロー定義ファイルとソースファイルを使用してワークフローの実行を開始します。 + 機能ブランチのワークフロー定義ファイルで、`Triggers` セクションを削除し、ワークフローを手動で実行します。 + 機能ブランチのワークフロー定義ファイルで、`PUSH` セクションを変更して、別のブランチ (`main` など) ではなく機能ブランチを参照するようにします。 **重要** `main` ブランチにマージするつもりがない場合は、これらの変更をコミットしないように注意してください。 ワークフロー定義ファイルの編集の詳細については、「[ワークフローの作成](workflows-create-workflow.md)」を参照してください。 トリガーについての詳細は、「[トリガーを使用したワークフロー実行の自動的な開始](workflows-add-trigger.md)」を参照してください。 ## 「ワークフロー定義に *n* 個のエラーがあります」というエラーを解決修正するにはどうすればよいですか? **問題:** 次のいずれかのエラーメッセージが表示されます。 **エラー 1:** **CI/CD** の **[ワークフロー]** ページには、ワークフローの名前の下に次が表示されます。 `Workflow definition has n errors` **エラー 2:** ワークフローの編集中に、**[検証]** ボタンを選択すると、CodeCatalyst コンソールの上部に次のメッセージが表示されます。 `The workflow definition has errors. Fix the errors and choose Validate to verify your changes.` **エラー 3:** ワークフローの詳細ページに移動すると、**[ワークフロー定義]** フィールドに次のエラーが表示されます。 `n errors` **解決方法:** + **[CI/CD]**、**[ワークフロー]**、エラーのあるワークフローの名前の順に選択します。上部の **[ワークフロー定義]** フィールドで、エラーへのリンクを選択します。エラーに関する詳細は、ページの下部に表示されます。エラーのトラブルシューティングのヒントに従って問題を解決します。 + ワークフロー定義ファイルが YAML ファイルであることを確認します。 + ワークフロー定義ファイルの YAML プロパティが適切なレベルでネストされていることを確認します。ワークフロー定義ファイルでプロパティをネストする方法を確認するには、「[ワークフロー YAML 定義](workflow-reference.md)」を参照するか、アクションのドキュメント (「[ワークフローへのアクションの追加](workflows-add-action.md)」からリンクされている) を参照してください。 + アスタリスク (`*`) やその他の特殊文字が適切にエスケープされていることを確認してください。エスケープするには、一重引用符または二重引用符を追加します。例えば、次のようになります。 ``` Outputs: Artifacts: - Name: myartifact Files: - "**/*" ``` ワークフロー定義ファイルの特殊文字の詳細については、「[構文ガイドラインと規則](workflow-reference.md#workflow.terms.syntax.conv)」を参照してください。 + ワークフロー定義ファイルの YAML プロパティで正しい大文字化が使用されていることを確認します。大文字と小文字の区別のルールの詳細については、「[構文ガイドラインと規則](workflow-reference.md#workflow.terms.syntax.conv)」を参照してください。各プロパティの正しい大文字と小文字の区別を確認するには、「[ワークフロー YAML 定義](workflow-reference.md)」を参照するか、アクションのドキュメント (「[ワークフローへのアクションの追加](workflows-add-action.md)」からリンクされている) を参照してください。 + `SchemaVersion` プロパティが存在し、ワークフロー定義ファイルの正しいバージョンに設定されていることを確認します。詳細については、「[SchemaVersion](workflow-reference.md#workflow.schemaversion)」を参照してください。 + ワークフロー定義ファイルの `Triggers` セクションに、すべての必須のプロパティが含まれていることを確認します。必須のプロパティを確認するには、[ビジュアルエディタ](workflow.md#workflow.editors)でトリガーを選択し、情報が不足しているフィールドを探すか、「[Triggers](workflow-reference.md#triggers-reference)」でトリガーリファレンスドキュメントを参照してください。 + ワークフロー定義ファイルの `DependsOn` プロパティが正しく設定されており、循環的な依存関係が導入されていないことを確認します。詳細については、「[アクションの順序付け](workflows-depends-on.md)」を参照してください。 + ワークフロー定義ファイルの `Actions` セクションに少なくとも 1 つのアクションが含まれていることを確認します。詳細については、「[アクション](workflow-reference.md#actions-reference)」を参照してください。 + 各アクションにすべての必須のプロパティが含まれていることを確認します。必須のプロパティを確認するには、[ビジュアルエディタ](workflow.md#workflow.editors)でアクションを選択し、情報が不足しているフィールドを探すか、アクションのドキュメント (「[ワークフローへのアクションの追加](workflows-add-action.md)」からリンクされている) を参照してください。 + すべての入力アーティファクトに、対応する出力アーティファクトがあることを確認します。詳細については、「[出力アーティファクトの定義](workflows-working-artifacts-output.md)」を参照してください。 + 1 つのアクションに定義された変数をエクスポートして、他のアクションで使用できるようにします。詳細については、「[他のアクションで使用できるように変数をエクスポートする](workflows-working-with-variables-export-input.md)」を参照してください。 ## 「認証情報が見つかりません」および「ExpiredToken」というエラーを解決するにはどうすればよいですか? **問題:** 「[チュートリアル: Amazon EKS にアプリケーションをデプロイする](deploy-tut-eks.md)」に取り組んでいる際に、開発マシンのターミナルウィンドウに次のエラーメッセージのいずれかまたは両方が表示されます。 `Unable to locate credentials. You can configure credentials by running "aws configure".` `ExpiredToken: The security token included in the request is expired` **解決方法:** これらのエラーは、 AWS サービスへのアクセスに使用している認証情報の有効期限が切れていることを示します。この場合、`aws configure` コマンドは実行しないでください。代わりに、次の手順を使用して AWS アクセスキーとセッショントークンを更新します。 **AWS アクセスキーとセッショントークンを更新するには** 1. Amazon EKS チュートリアル全体 () を使用しているユーザーの AWS アクセスポータル URL、ユーザー名、パスワードがあることを確認します`codecatalyst-eks-user`。これらの項目は、チュートリアルの「[ステップ 1: 開発マシンをセットアップする](deploy-tut-eks.md#deploy-tut-eks-dev-env-create)」を完了したときに設定しているはずです。 **注記** この情報がない場合は、IAM アイデンティティセンターの `codecatalyst-eks-user` 詳細ページに移動し、**[パスワードをリセット]**、**[ワンタイムパスワードを生成 [...]]** を選択して、もう一度 **[パスワードをリセット]** を選択すると、画面に情報が表示されます。 1. 次のいずれかを行います。 + AWS アクセスポータル URL をブラウザのアドレスバーに貼り付けます。 または + アクセス AWS ポータルページが既にロードされている場合は更新します。 1. まだサインインしていない場合は、`codecatalyst-eks-user` のユーザー名とパスワードでサインインします。 1. **[AWS アカウント]** を選択し、`codecatalyst-eks-user` ユーザーと許可セットを割り当てた AWS アカウント の名前を選択します。 1. 許可セット名 (`codecatalyst-eks-permission-set`) の横にある **[コマンドラインまたはプログラムからのアクセス]** を選択します。 1. ページの中央にあるコマンドをコピーします。次のような内容です。 ``` export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" export AWS_SESSION_TOKEN="session-token" ``` ...ここでは *[session-token]* は長いランダムな文字列です。 1. コマンドを開発マシンのターミナルプロンプトに貼り付けて、Enter キーを押します。 新しいキーとセッショントークンがロードされます。 これで認証情報が更新されました。これで AWS CLI、、`eksctl`、および `kubectl` コマンドが機能します。 ## 「サーバーに接続できません」というエラーを解決するにはどうすればよいですか? **問題**: 「[チュートリアル: Amazon EKS にアプリケーションをデプロイする](deploy-tut-eks.md)」で説明されているチュートリアルに取り組んでいる際に、開発マシンのターミナルウィンドウに次のようなエラーメッセージが表示されます。 `Unable to connect to the server: dial tcp: lookup long-string.gr7.us-west-2.eks.amazonaws.com on 1.2.3.4:5: no such host` **解決方法:** このエラーは通常、Amazon EKS クラスターに接続するために `kubectl` ユーティリティで使用している認証情報の有効期限が切れていることを示します。問題を解決するには、ターミナルプロンプトで次のコマンドを入力して認証情報を更新します。 ``` aws eks update-kubeconfig --name codecatalyst-eks-cluster --region us-west-2 ``` コードの説明は以下のとおりです。 + *codecatalyst-eks-cluster* は Amazon EKS クラスターの名前に置き換えられます。 + *us-west-2* は、クラスターがデプロイされている AWS リージョンに置き換えられます。 ## ビジュアルエディタに CodeDeploy フィールドがないのはなぜですか? **問題**: 「[Amazon ECS へのデプロイ](deploy-action-ecs.md)」アクションを使用しているのに、ワークフローのビジュアルエディタに **CodeDeploy AppSpec** などの CodeDeploy フィールドが表示されていません。この問題は、**[サービス]** フィールドで指定した Amazon ECS サービスがブルー/グリーンデプロイを実行するように設定されていないことが原因で発生する場合があります。 **解決方法:** + 「**Amazon ECS へのデプロイ**」アクションの **[設定]** タブで、別の Amazon ECS サービスを選択します。詳細については、「[ワークフローを使用した Amazon ECS へのデプロイ](deploy-action-ecs.md)」を参照してください。 + 選択した Amazon ECS サービスを、ブルー/グリーンデプロイを実行するように設定します。詳細については、「Amazon Elastic Container Service 開発者ガイド」の「[CodeDeploy を使用したブルー/グリーンデプロイ](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-bluegreen.html)」参照してください。 ## IAM 機能エラーを解決するにはどうすればよいですか? **問題**: [CloudFormation スタックのデプロイ](deploy-action-cfn.md)アクションを使用していて、**スタックのデプロイ CloudFormation **アクションのログ`##[error] requires capabilities: [capability-name]`に が表示されます。 **解決方法:** この機能をワークフロー定義ファイルに追加するには、次の手順を実行します。IAM 機能の詳細については、[「IAM ユーザーガイド」の CloudFormation 「 テンプレートでの IAM リソースの承認](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities)」を参照してください。 ** ------ #### [ Visual ] **ビジュアルエディタを使用して IAM 機能を追加するには** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。 1. プロジェクトを選択します。 1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。 1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。 1. **[編集]** を選択します。 1. **[ビジュアル]** を選択します。 1. ワークフロー図で、「** CloudFormation スタックのデプロイ**」アクションを選択します。 1. **[設定]** タブを選択します。 1. 下部で、**[詳細 - オプション]** を選択します。 1. **[機能]** ドロップダウンリストで、エラーメッセージに記載されている機能の横にあるチェックボックスをオンにします。機能がリストに表示されない場合は、YAML エディタを使用して追加します。 1. (省略可) **[検証]** を選択して、ワークフローの YAML コードをコミットする前に検証します。 1. **[コミット]** を選択し、コミットメッセージを入力し、再度 **[コミット]** を選択します。 1. 新しいワークフローの実行が自動的に開始されない場合は、ワークフローを手動で実行し、変更によってエラーが解決したかどうかを確認します。ワークフローの手動での実行の詳細については、「[手動でのワークフロー実行の開始](workflows-manually-start.md)」を参照してください。 ------ #### [ YAML ] **YAML エディタを使用して IAM 機能を追加するには** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。 1. プロジェクトを選択します。 1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。 1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。 1. **[編集]** を選択します。 1. **[YAML]** を選択します。 1. ** CloudFormation スタックをデプロイ**アクションで、次のような`capabilities`プロパティを追加します。 ``` DeployCloudFormationStack: Configuration: capabilities: capability-name ``` *capability-name* を、エラーメッセージに表示される IAM 機能の名前に置き換えます。複数の機能を一覧表示するには、カンマを使用します。スペースは使用しません。詳細については、「[CloudFormation 「スタックをデプロイ」アクション YAML](deploy-action-ref-cfn.md)」で `capabilities` プロパティの説明を参照してください。 1. (省略可) **[検証]** を選択して、ワークフローの YAML コードをコミットする前に検証します。 1. **[コミット]** を選択し、コミットメッセージを入力し、再度 **[コミット]** を選択します。 1. 新しいワークフローの実行が自動的に開始されない場合は、ワークフローを手動で実行し、変更によってエラーが解決したかどうかを確認します。ワークフローの手動での実行の詳細については、「[手動でのワークフロー実行の開始](workflows-manually-start.md)」を参照してください。 ------ ## 「npm install」エラーを解決するにはどうすればよいですか? **問題**: [AWS CDK のデプロイのアクション](cdk-dep-action.md)または [AWS CDK のブートストラップのアクション](cdk-boot-action.md)が `npm install` エラーで失敗します。このエラーは、 アクションではアクセスできないプライベートノードパッケージマネージャー (npm) レジストリに AWS CDK アプリの依存関係を保存していることが原因で発生する可能性があります。 **解決方法**: 次の手順に従って、追加のレジストリと認証情報で AWS CDK アプリケーションの `cdk.json` ファイルを更新します。 **[開始する前に]** 1. 認証情報のシークレットを作成します。クリアテキストに相当するものを提供する代わりに、`cdk.json` ファイルでこれらのシークレットを参照します。シークレットを作成するには: 1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。 1. プロジェクトを選択します。 1. ナビゲーションペインで **[CI/CD]**、**[シークレット]** の順に選択します。 1. 次のプロパティで 2 個のシークレットを作成します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/troubleshooting-workflows.html) シークレットの詳細については、「[シークレットを使用したデータのマスキング](workflows-secrets.md)」を参照してください。 1. シークレットを環境変数として AWS CDK アクションに追加します。このアクションは実行時に変数を実際の値に置き換えます。シークレットを追加するには: 1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。 1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。 1. **[編集]** を選択します。 1. **[ビジュアル]** を選択します。 1. ワークフロー図で、 AWS CDK アクションを選択します。 1. **[入力]** タブを選択します。 1. 次のプロパティを持つ 2 つの変数を追加します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/troubleshooting-workflows.html) これで、シークレットへの参照を含む 2 つの変数が追加されました。 ワークフロー定義ファイルの YAML コードは、次のようになっているはずです。 **注記** 次のコードサンプルは「**AWS CDK のブートストラップ**」アクションからのものです。「**AWS CDK のデプロイ**」アクションは似たようなものになります。 ``` Name: CDK_Bootstrap_Action SchemaVersion: 1.0 Actions: CDKBootstrapAction: Identifier: aws/cdk-bootstrap@v2 Inputs: Variables: - Name: NPMUSER Value: ${Secrets.npmUsername} - Name: NPMTOKEN Value: ${Secrets.npmAuthToken} Sources: - WorkflowSource Environment: Name: Dev2 Connections: - Name: account-connection Role: codecatalystAdmin Configuration: Parameters: Region: "us-east-2" ``` これで、`cdk.json` ファイル内の `NPMUSER` 変数と `NPMTOKEN` 変数を使用する準備が整いました。次の手順に進みます。 **cdk.json ファイルを更新するには** 1. を AWS CDK プロジェクトのルートディレクトリに変更し、 `cdk.json` ファイルを開きます。 1. `"app":` プロパティを検索し、*赤色の斜体*で示されているコードを含めるように変更します。 **注記** 次のサンプルコードは TypeScript プロジェクトからのものです。JavaScript プロジェクトを使用している場合、コードは似ていますが、同一ではありません。 ``` { "app": "npm set registry=https://your-registry/folder/CDK-package/ --userconfig .npmrc && npm set //your-registry/folder/CDK-package/:always-auth=true --userconfig .npmrc && npm set //your-registry/folder/CDK-package/:_authToken=\"${NPMUSER}\":\"${NPMTOKEN}\" && npm install && npx ts-node --prefer-ts-exts bin/hello-cdk.ts|js", "watch": { "include": [ "**" ], "exclude": [ "README.md", "cdk*.json", "**/*.d.ts", "**/*.js", "tsconfig.json", "package*.json", ... ``` 1. *赤色の斜体*で強調表示されているコードについて、次のように置き換えます。 + *your-registry/folder/CDK-package/* と、プライベートレジストリ内の AWS CDK プロジェクトの依存関係へのパス。 + *hello-cdk.ts\$1.js* をエントリポイントファイルの名前に置き換える。使用している言語に応じて `.ts` (TypeScript) ファイルまたは `.js` (JavaScript) ファイルになります。 **注記** このアクションにより、*NPMUSER* 変数と *NPMTOKEN* 変数が、**[シークレット]** で指定した npm ユーザー名とアクセストークンに置き換えられます。 1. `cdk.json` ファイルを保存します。 1. アクションを手動で再実行して、変更によってエラーが解決したかどうかを確認します。手動でのアクションの実行の詳細については、「[手動でのワークフロー実行の開始](workflows-manually-start.md)」を参照してください。 ## 複数のワークフローに同じ名前が付いているのはなぜですか? ワークフローは、リポジトリごとにブランチ単位で保存されます。2 つの異なるワークフローは、異なるブランチに存在する場合、同じ名前になることがあります。[ワークフロー] ページで、ブランチ名を見ると、同じ名前のワークフローを区別できます。詳細については、「[Amazon CodeCatalyst でブランチを使用してソースコードを整理する](source-branches.md)」を参照してください。 ![\[ワークフローブランチ\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/images/flows/workflow-branch.png) ## ワークフロー定義ファイルを別のフォルダに保存できますか? できません。すべてのワークフロー定義ファイルは `.codecatalyst/workflows` フォルダかそのフォルダのサブフォルダに保存する必要があります。複数の論理プロジェクトを含むモノリポジトリを使用している場合は、すべてのワークフロー定義ファイルを `.codecatalyst/workflows` フォルダかそのサブフォルダの 1 つに配置してから、トリガー内の **[変更済みファイル]** フィールド (ビジュアルエディタ) または `FilesChanged` プロパティ (YAML エディタ) を使用して、指定したプロジェクトパスでワークフローを自動的にトリガーします。詳細については、「[ワークフローへのトリガーの追加](workflows-add-trigger-add.md)」および「[例: プッシュ、ブランチ、ファイルを含むトリガー](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-multi)」を参照してください。 ## ワークフローにアクションを順番に追加するにはどうすればよいですか? デフォルトでは、ワークフローにアクションを追加すると、そのアクションは依存関係を持たず、他のアクションと並行して実行されます。 アクションを順番に配列する場合は、`DependsOn` フィールドを設定すると別のアクションへの依存関係を設定できます。また、他のアクションの出力であるアーティファクトまたは変数を消費するようにアクションを設定することもできます。詳細については、「[アクションの順序付け](workflows-depends-on.md)」を参照してください。 ## ワークフローは正常に検証されるのに、ランタイム時に失敗するのはなぜですか? `Validate` ボタンを使用してワークフローを検証したのにワークフローが失敗する場合は、検証ツールの制限が原因の可能性があります。 ワークフロー設定のシークレット、環境、フリートなどの CodeCatalyst リソースを参照する際のエラーは、コミット中に登録されません。有効でない参照が使用されている場合、ワークフローの実行時にのみ、このエラーが識別されます。同様に、アクション属性に必須フィールドがない場合やタイプミスがあるなど、アクション設定にエラーがある場合、そうしたエラーはワークフローの実行時にのみ識別されます。詳細については、「[ワークフローの作成](workflows-create-workflow.md)」を参照してください。 ## 自動検出でアクションのレポートが検出されなません **問題:** テストを実行するアクションに対して自動検出を設定しましたが、CodeCatalyst でレポートが検出されません。 **解決方法:** いくつかの問題が原因の可能性があります。次のソリューションのうち 1 つまたは複数を試してください。 + テストの実行に使用するツールが、CodeCatalyst が理解できる形式のいずれかで出力を生成することを確認します。例えば、`pytest` を使用して CodeCatalyst がテストおよびコードカバレッジレポートを検出できるようにする場合は、次の引数を含めます。 ``` --junitxml=test_results.xml --cov-report xml:test_coverage.xml ``` 詳細については、「[品質レポートのタイプ](test-workflow-actions.md#test-reporting)」を参照してください。 + 出力のファイル拡張子が選択した形式と一致していることを確認します。例えば、`JUnitXML` 形式で結果を生成するように `pytest` を構成する場合は、ファイル拡張子が `.xml` であることを確認します。詳細については、「[品質レポートのタイプ](test-workflow-actions.md#test-reporting)」を参照してください。 + 特定のフォルダを意図的に除外していない限り、ファイル システム全体 (`**/*`) を含むように `IncludePaths` が設定されていることを確認します。同様に、レポートの配置場所に想定しているディレクトリを `ExcludePaths` で除外しないようにします。 + 特定の出力ファイルを使用するようにレポートを手動で設定した場合、そのレポートは自動検出から除外されます。詳細については、「[品質レポートの YAML 例](test-config-action.md#test.success-criteria-example)」を参照してください。 + 出力が生成される前にアクションが失敗したことが原因で、自動検出でレポートが見つからない場合があります。例えば、ユニットテストが実行される前にビルドが失敗した可能性があります。 ## 成功基準を設定した後、自動検出レポートでアクションが失敗します **問題:** 自動検出を有効にして成功基準を設定すると、一部のレポートが成功基準を満たさず、結果としてアクションが失敗します。 **解決方法:** 解決するには、次の解決策を 1 つ以上試してください。 + `IncludePaths` または `ExcludePaths` を変更して、関心のないレポートを除外します。 + 成功基準を更新して、すべてのレポートが合格できるようにします。例えば、1 つのレポートが 50% のラインカバレッジで、もう 1 つのレポートが 70% のラインカバレッジで検出された、最小ラインカバレッジを 50% に調整します。詳細については、[成功基準](test-best-practices.md#test.best-success-criteria)を参照してください。 + 失敗したレポートを手動で設定されたレポートに変換します。こうすることで、その特定のレポートに対して異なる成功基準を設定できます。詳細については、「[レポートの成功基準の設定](test-config-action.md#test.success-criteria)」を参照してください。 ## 自動検出で不要なレポートが生成されます **問題:** 自動検出を有効にすると、不要なレポートが生成されます。例えば、CodeCatalyst は、`node_modules` に保存されているアプリケーションの依存関係に含まれるファイルのコードカバレッジレポートを生成します。 **解決方法:** `ExcludePaths` 設定を調整すると不要なファイルを除外できます。例えば、`node_modules` を除外するには、`node_modules/**/*` を追加します。詳細については、「[パスの包含/除外](test-best-practices.md#test.best-include-exclude)」を参照してください。 ## 自動検出で、1 つのテストフレームワークに多数の小さなレポートが生成されます **問題:** 特定のテストフレームワークとコードカバレッジレポートフレームワークを使用すると、自動検出で多数のレポートが生成されることに気付きました。例えば、[Maven Surefire プラグイン](https://maven.apache.org/surefire/maven-surefire-plugin/)を使用する場合、自動検出はテストクラスごとに異なるレポートを生成します。 **解決方法:** フレームワークは、出力を 1 つのファイルに集約できる場合があります。例えば、Maven Surefire プラグインを使用している場合、`npx junit-merge` を使用してファイルを手動で集約できます。式全体は次のようになります。 ``` mvn test; cd test-package-path/surefire-reports && npx junit-merge -d ./ && rm *Test.xml ``` ## CI/CD に一覧表示されるワークフローがソースリポジトリのワークフローと一致しません **問題:** **CI/CD** の [ワークフロー] ページに表示されるワークフローが、[ソースリポジトリ](source.md)の `~/.codecatalyst/workflows/` フォルダにある**ワークフロー**と一致しません。次の不一致が確認される場合があります。 + **[ワークフロー]** ページにワークフローは表示されるが、対応するワークフロー定義ファイルがソースリポジトリに存在していない。 + ワークフロー定義ファイルはソースリポジトリに存在しているが、対応するワークフローが **[ワークフロー]** ページに表示されない。 + ワークフローはソースリポジトリと **[ワークフロー]** ページの両方にあるが、2 つは異なっている。 この問題は、**[ワークフロー]** ページを更新する時間がなかった場合、またはワークフローのクォータを超えた場合に発生する可能性があります。 **解決方法:** + 待ちます。通常、ソースへのコミット後、**[ワークフロー]** ページに変更が表示されるまで 2～3 秒待つ必要があります。 + ワークフロークォータを超えた場合は、次のいずれかを実行します。 **注記** ワークフロークォータを超えたかどうかを判断するには、「[CodeCatalyst のワークフローのクォータ](workflows-quotas.md)」を確認し、ソースリポジトリまたは **[ワークフロー]** ページのワークフローと文書化されたクォータを照合します。クォータを超えたことを示すエラーメッセージは表示されないため、自分で調査する必要があります。 + **「スペースあたりのワークフローの最大数」**クォータを超えた場合は、一部のワークフローを削除してから、ワークフロー定義ファイルに対してテストコミットを実行します。テストコミットの例としては、ファイルにスペースを追加することが挙げられます。 + **「最大ワークフロー定義ファイルサイズ**」クォータを超えた場合は、ワークフロー定義ファイルを変更して長さを短くします。 + **「1 つのソースイベントで処理されるワークフローファイルの最大数」**クォータを超えた場合は、テストコミットをいくつか実行します。各コミットのワークフローの最大数よりも少なくなるように変更します。 ## ワークフローを作成したり更新したりできません **問題:** ワークフローの作成や更新をしたいのに、変更をコミットしようとするとエラーが表示されます。 **解決方法:** プロジェクトまたはスペース内のロールによっては、プロジェクト内のソースリポジトリにコードをプッシュするアクセス許可がない場合があります。ワークフローの YAML ファイルはリポジトリに保存されます。詳細については、「[ワークフロー定義ファイル](workflows-concepts.md#workflows-concepts-workflows-def)」を参照してください。**スペース管理者**ロール、**プロジェクト管理者**ロール、**コントリビューター**ロールはすべて、プロジェクト内のリポジトリにコードをコミットおよびプッシュするアクセス許可を持っています。 **コントリビューター**ロールを持っているのに、特定のブランチでワークフロー YAML を作成したり、その変更をコミットしたりできない場合、そのロールを持つユーザーがその特定のブランチにコードをプッシュできないようにブランチルールが設定されている可能性があります。別のブランチでワークフローを作成するか、変更を別のブランチにコミットしてみてください。詳細については、「[ブランチルールを使用してブランチで許可されたアクションを管理する](source-branches-branch-rules.md)」を参照してください。 # 問題のトラブルシューティング 次の情報は、CodeCatalyst での一般的な問題のトラブルシューティングに役立ちます。 **Topics** + [問題の担当者を選択できません](#troubleshooting-issues-assignees) ## 問題の担当者を選択できません **問題:** 問題を作成すると、担当者のリストが空になります。 **解決方法:** 担当者のリストは、プロジェクトのメンバーとして一覧表示されている CodeCatalyst ユーザーに直接リンクされます。ユーザープロファイルアクセスが正しく機能していることを確認するには、プロファイルアイコンを選択し、**[ユーザープロファイル]** を選択します。ユーザープロファイル情報が入力されていない場合は、ヘルスレポートでインシデントがないかを確認します。入力されている場合は、サービスチケットを提出します。 # CodeCatalyst での検索に関する問題のトラブルシューティング CodeCatalyst での検索に関連する問題のトラブルシューティングについては、次のセクションを参照してください。ワークフローの詳細については、「[CodeCatalyst でコード、問題、プロジェクト、ユーザーを検索するコード、問題、プロジェクト、ユーザーを検索する](search.md)」を参照してください。 **Topics** + [プロジェクトでユーザーを見つけられません](#troubleshooting-search-users) + [プロジェクトやスペースで探しているものが見つかりません](#troubleshooting-missing-results) + [ページを移動すると検索結果の数が常に変わります](#troubleshooting-search-results) + [検索クエリが完了しません](#troubleshooting-requests-limits) ## プロジェクトでユーザーを見つけられません **問題:** ユーザーの詳細を表示しようとすると、プロジェクトにその情報が表示されません。 **解決方法:** 検索では現在、プロジェクト内のユーザーの検索がサポートされていません。自分のスペースにアクセスできるユーザーを検索するには、QuickSearch で **[このスペース]** に切り替えるか、高度なクエリ言語を使用して指定したプロジェクトフィルターを削除します。 ## プロジェクトやスペースで探しているものが見つかりません **問題:** 特定の情報を検索しようとすると、結果が表示されません。 **解決方法:** コンテンツの更新が検索結果に反映されるまでには数秒かかる可能性があります。大規模な更新には数分かかる場合があります。 最近更新されていないリソースについては、検索の絞り込みが必要な場合があります。絞り込むにはキーワードを追加するか、高度なクエリ言語を使用します。クエリの絞り込みに関する詳細については、「[検索クエリを絞り込む](search.md#search-query-language-examples)」を参照してください。 ## ページを移動すると検索結果の数が常に変わります **問題:** 次のページに移動すると検索結果の数が変更されるように思われるため、結果の合計がいくつなのかはっきりしません。 **解決方法:** 検索結果のページを移動すると、クエリに一致する検索結果の数が変わることがあります。結果の数は、ページを移動するときに検出された、より正確な一致数を反映するように更新される場合があります。 結果間を移動していると、「**『テスト』の結果はありません**」というメッセージが表示されることがあります。残りの結果にアクセスできない場合はメッセージが表示されます。 ## 検索クエリが完了しません **問題:** 検索クエリの結果が表示されず、時間がかかりすぎているようです。 **解決方法:** スペース内で多くの検索が同時に行われている場合 (プログラムによる検索の場合やチームアクティビティが活発な場合)、検索が完了しないことがあります。プログラムによる検索を実行している場合は、一時停止するか検索数を減らしてください。それ以外の場合は、数秒後にもう一度試してください。 # 拡張機能に関する問題のトラブルシューティング CodeCatalyst の拡張機能に関連する問題のトラブルシューティングについては、次のセクションを参照してください。拡張機能の詳細については、「[CodeCatalyst で拡張機能を持つプロジェクトに機能を追加する拡張機能を使用してプロジェクトに機能を追加する](extensions.md)」を参照してください。 **Topics** + [リンクされたサードパーティーリポジトリの変更を表示したり、それらの変更の結果を検索したりできません](#troubleshooting-detect-3p-changes) ## リンクされたサードパーティーリポジトリの変更を表示したり、それらの変更の結果を検索したりできません **問題:** サードパーティーリポジトリの変更が CodeCatalyst に表示されません。 **解決方法:** CodeCatalyst は現在、リンクされたリポジトリのデフォルトブランチの変更の検出をサポートしていません。リンクされたリポジトリのデフォルトブランチを変更するには、まず CodeCatalyst からリンクを解除し、デフォルトブランチを変更してから再度リンクする必要があります。詳細については、「[CodeCatalyst での GitHub リポジトリ、Bitbucket リポジトリ、GitLab プロジェクトリポジトリ、および Jira プロジェクトのリンク](extensions-link.md)」を参照してください。 # スペースに関連付けられたアカウントに関する問題のトラブルシューティング CodeCatalyst では、 AWS アカウント をスペースに追加して、リソースにアクセス許可を付与し、請求の目的で使用できます。次の情報は、CodeCatalyst での関連付けられたアカウントに関する一般的な問題のトラブルシューティングに役立ちます。 **Topics** + [AWS アカウント 接続リクエストに無効なトークンエラーが表示される](#troubleshooting-connection-token) + [Amazon CodeCatalyst プロジェクトワークフローが失敗し、設定されたアカウント、環境、または IAM ロールのエラーが表示されます](#connections-troubleshoot-workflow) + [プロジェクトを作成するために、関連付けられたアカウント、ロール、環境が必要です](#connections-troubleshoot-environment) + [の Amazon CodeCatalyst Spaces ページにアクセスできない AWS マネジメントコンソール](#connections-troubleshoot-console) + [請求アカウントとは異なるアカウントが必要です](#connections-troubleshoot-billing) + [接続名エラーでプロジェクトワークフローが失敗します](#connections-troubleshoot-restriction) ## AWS アカウント 接続リクエストに無効なトークンエラーが表示される **問題:** 接続トークンを使用して接続リクエストを作成すると、ページがトークンを承諾せず、トークンが無効であるというエラーが表示されます。 **解決方法:** スペースに追加するアカウント ID を必ず指定してください。の管理者権限を持っている AWS アカウント か、管理者と協力してアカウントを追加できる必要があります。 アカウントを検証すると、 AWS マネジメントコンソールで新しいブラウザウィンドウが開きます。コンソール側でログインするには、同じアカウントが必要です。次を確認してから再試行してください。 + スペース AWS アカウント に追加するのと同じ AWS マネジメントコンソール を使用して にログインします。 + リージョンをスペースの正しいリージョンに設定 AWS マネジメントコンソール して、 にログインします。 + 請求ページから到着し、スペースの指定された請求アカウントとして AWS アカウント を追加する場合は、そのアカウントが別のスペースの請求アカウントとしてクォータに達していないことを確認する。 ## Amazon CodeCatalyst プロジェクトワークフローが失敗し、設定されたアカウント、環境、または IAM ロールのエラーが表示されます **問題:** ワークフローが実行され、スペースに関連付けられた設定されたアカウントも IAM ロールも見つからない場合は、ワークフロー YAML のロール、接続、環境の各フィールドに手動で入力する必要があります。失敗したワークフローアクションを表示し、エラーメッセージが次のようになっているかどうかを確認します。 + このロールは、環境に関連付けられた接続では使用できません。 + アクションは成功しませんでした。ステータス: FAILED。アカウント接続または環境に指定された値が無効です。接続がスペースに関連付けられていること、および環境がプロジェクトに関連付けられていることを確認してください。 + アクションは成功しませんでした。ステータス: FAILED。IAM ロールに指定された値が無効です。名前が存在していること、IAM ロールがアカウント接続に追加されていること、および接続が Amazon CodeCatalyst スペースに既に関連付けられていることを確認してください。 **解決方法:** ワークフロー YAML フィールドの [[環境]](build-action-ref.md#build.environment)、[[接続]](build-action-ref.md#build.environment.connections)、[[ロール]](build-action-ref.md#build.environment.connections.role) の値が正確であることを確認します。環境を必要とする CodeCatalyst ワークフローアクションは、 AWS リソースを実行するアクション、または AWS リソーススタックを生成するアクションを構築またはデプロイします。 失敗したワークフローアクションブロックを選択し、**[ビジュアル]** を選択します。**[設定]** タブを選択します。**[環境]**、**[接続名]**、**[ロール名]** の各フィールドが入力されていない場合は、ワークフローを手動で更新する必要があります。ワークフロー YAML を編集するには、次のステップを実行します。 + `/.codecatalyst` ディレクトリを展開し、`/workflows` ディレクトリを展開します。ワークフロー YAML ファイルを開きます。ワークフロー用に設定した YAML で IAM ロールとアカウント情報が指定されていることを確認します。例: ``` Actions: cdk_bootstrap: Identifier: action-@v1 Inputs: Sources: - WorkflowSource Environment: Name: Staging Connections: - Name: account-connection Role: build-role ``` **[環境]、[接続]、[ロール]** のプロパティは、 AWS リソースを使用して CodeCatalyst ワークフローのビルドアクションとデプロイアクションを実行するために必要です。例については、「CodeCatalyst ビルドアクションリファレンス」の[環境](build-action-ref.md#build.environment)、[接続](build-action-ref.md#build.environment.connections)、[ロール](build-action-ref.md#build.environment.connections.role)の YAML パラメータを参照してください。 + スペースにアカウントが追加されていることを確認し、アカウントに適切な IAM ロールが追加されていることを確認します。**スペース管理者**ロールがある場合は、アカウントを調整または追加できます。詳細については、「[接続された AWS リソースへのアクセスを許可する AWS アカウント](ipa-connect-account.md)」を参照してください。 ## プロジェクトを作成するために、関連付けられたアカウント、ロール、環境が必要です **問題:** プロジェクト作成オプションには、プロジェクトに自分のスペースで使用できる追加アカウントがないか、プロジェクトで使用するために自分のスペースに別のアカウントを追加する必要があります。 **解決方法:** スペースにスペース**管理者**ロールがある場合は、プロジェクト AWS アカウント に追加する権限を に追加できます。また、管理者権限を持っているか、 AWS 管理者と連携できる AWS アカウント も必要です。 プロジェクト作成画面でアカウントとロールを使用可能にするには、まずアカウントとロールを追加する必要があります。詳細については、「[接続された AWS リソースへのアクセスを許可する AWS アカウント](ipa-connect-account.md)」を参照してください。 **CodeCatalystWorkflowDevelopmentRole-*spaceName*** ロールポリシーと呼ばれるロールポリシーを使用してサービスロールを作成することもできます。ロールには、一意の識別子が付加された `CodeCatalystWorkflowDevelopmentRole-spaceName` という名前が付けられます。ロールとロールポリシーの詳細については、「[**CodeCatalystWorkflowDevelopmentRole-*spaceName*** サービスロールについて](ipa-iam-roles.md#ipa-iam-roles-service-role)」を参照してください。ロールを作成する手順については、「[アカウントとスペース用の **CodeCatalystWorkflowDevelopmentRole-*spaceName*** ロールを作成する](ipa-iam-roles.md#ipa-iam-roles-service-create)」を参照してください。ロールはアカウントに追加され、CodeCatalyst のプロジェクト作成ページで使用できます。 ## の Amazon CodeCatalyst Spaces ページにアクセスできない AWS マネジメントコンソール **問題:** の AWS マネジメントコンソール Amazon CodeCatalyst ページにアクセスして CodeCatalyst スペースにアカウントを追加したり、 のアカウントにロールを追加しようとすると AWS、アクセス許可エラーが発生します。 **解決方法:** スペース管理者ロールがある場合は、**スペース**にプロジェクト AWS アカウント への追加が許可されている を追加できます。また、管理者権限を持っているか、 AWS 管理者と連携できる AWS アカウント も必要です。まず、管理するのと同じアカウント AWS マネジメントコンソール で にサインインしていることを確認する必要があります。にサインインしたら AWS マネジメントコンソール、コンソールを開いてもう一度試すことができます。 \$1/ の で Amazon CodeCatalyst AWS マネジメントコンソール ページを開きます。 [https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/) ## 請求アカウントとは異なるアカウントが必要です **問題:** CodeCatalyst ログインを設定するときに、いくつかのステップを実行してスペースの設定と承認済みの AWS アカウントの関連付けを行いました。それなのに、請求用に別のアカウントを承認する必要があります。 解決方法: お使いのスペースについては、**スペース管理者**ロールがある場合は、請求アカウントを承認できます。また、管理者権限 AWS アカウント を持っているか、 AWS 管理者と連携できる も必要です。 詳細については、「Amazon CodeCatalyst Administrator Guide」の「[請求管理](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html)」を参照してください。 ## 接続名エラーでプロジェクトワークフローが失敗します **問題:** プロジェクトを作成してからプロジェクトワークフローを実行すると、ワークフローは失敗し、次のように接続名が無効であるというエラーが表示されます。 で失敗: 接続名が無効です。 **解決方法:** スペースに追加するアカウント ID を指定し、そのアカウントがプロジェクト制限アカウント接続に対して有効になっていないことを確認します。アカウントでプロジェクト制限アカウント接続が有効になっている場合は、新しいプロジェクトへのアクセスを有効にしてアカウント接続を更新する必要がある場合があります。詳細については、[「プロジェクト制限アカウント接続の設定](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction)」を参照してください。 # Amazon CodeCatalyst と AWS SDK または AWS CLI の間で生じた問題のトラブルシューティング 以下の情報は、CodeCatalyst および AWS CLI または AWS SDK を使用する際の一般的な問題のトラブルシューティングに役立ちます。 **Topics** + [コマンドラインまたはターミナルで **aws codecatalyst** を入力すると、選択が無効であるというエラーが表示されます](#cli-sdk-troubleshoot-no-commands) + [**aws codecatalyst** コマンドを実行すると認証情報エラーが表示されます](#cli-sdk-troubleshoot-profile) ## コマンドラインまたはターミナルで **aws codecatalyst** を入力すると、選択が無効であるというエラーが表示されます **問題:** CodeCatalyst で AWS CLI を使用しようとすると、1 つ以上の **aws codecatalyst** コマンドが有効として認識されません。 **解決策:** この問題の最も一般的な原因は、最新のサービスとコマンドの最新の更新が含まれていないバージョンの AWS CLI を使用していることです。AWS CLI のインストールを更新してから、もう一度試してください。詳細については、「[CodeCatalyst AWS CLI で を使用するための のセットアップ](set-up-cli.md)」を参照してください。 ## **aws codecatalyst** コマンドを実行すると認証情報エラーが表示されます **問題:** CodeCatalyst で AWS CLI を使用しようとすると、「`You can configure credentials by running "aws configure".`」または「`Unable to locate authorization token`」というメッセージが表示されます。 **解決策:** CodeCatalyst コマンドを使用するようにAWS CLI プロファイルを設定する必要があります。詳細については、「[CodeCatalyst AWS CLI で を使用するための のセットアップ](set-up-cli.md)」を参照してください。