スペースに関連付けられたアカウントに関する問題のトラブルシューティング - Amazon CodeCatalyst
AWS アカウント 接続リクエストをすると無効なトークンエラーが表示されますAmazon CodeCatalyst プロジェクトワークフローが失敗し、設定されたアカウント、環境、または IAM ロールのエラーが表示されますプロジェクトを作成するために、関連付けられたアカウント、ロール、環境が必要ですAWS マネジメントコンソールで Amazon CodeCatalyst スペースページにアクセスできません請求アカウントとは異なるアカウントが必要です接続名エラーでプロジェクトワークフローが失敗します

Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「CodeCatalyst から移行する方法」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

スペースに関連付けられたアカウントに関する問題のトラブルシューティング

CodeCatalyst では、リソースへのアクセス許可を付与するため、および請求のために AWS アカウント をスペースに追加できます。次の情報は、CodeCatalyst での関連付けられたアカウントに関する一般的な問題のトラブルシューティングに役立ちます。

AWS アカウント 接続リクエストをすると無効なトークンエラーが表示されます

問題: 接続トークンを使用して接続リクエストを作成すると、ページがトークンを承諾せず、トークンが無効であるというエラーが表示されます。

解決方法: スペースに追加するアカウント ID を必ず指定してください。AWS アカウントの管理者権限を持っているか、管理者と協力してアカウントを追加できる必要があります。

アカウントを検証すると、AWS マネジメントコンソール で新しいブラウザウィンドウが開きます。コンソール側でログインするには、同じアカウントが必要です。次を確認してから再試行してください。

  • スペースに追加するものと同じ AWS アカウント を使用して AWS マネジメントコンソール にログインしている。

  • スペースの適切なリージョンにリージョンが設定された状態で、AWS マネジメントコンソールにログインしている。

  • 請求ページから到着し、スペースの指定された請求アカウントとして AWS アカウントを追加する場合は、そのアカウントが別のスペースの請求アカウントとしてクォータに達していないことを確認する。

Amazon CodeCatalyst プロジェクトワークフローが失敗し、設定されたアカウント、環境、または IAM ロールのエラーが表示されます

問題: ワークフローが実行され、スペースに関連付けられた設定されたアカウントも IAM ロールも見つからない場合は、ワークフロー YAML のロール、接続、環境の各フィールドに手動で入力する必要があります。失敗したワークフローアクションを表示し、エラーメッセージが次のようになっているかどうかを確認します。

  • このロールは、環境に関連付けられた接続では使用できません。

  • アクションは成功しませんでした。ステータス: FAILED。アカウント接続または環境に指定された値が無効です。接続がスペースに関連付けられていること、および環境がプロジェクトに関連付けられていることを確認してください。

  • アクションは成功しませんでした。ステータス: FAILED。IAM ロールに指定された値が無効です。名前が存在していること、IAM ロールがアカウント接続に追加されていること、および接続が Amazon CodeCatalyst スペースに既に関連付けられていることを確認してください。

解決方法: ワークフロー YAML フィールドの [環境]、[接続]、[ロール] の値が正確であることを確認します。環境を必要とする 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 ビルドアクションリファレンス」の環境、接続、ロールの YAML パラメータを参照してください。

  • スペースにアカウントが追加されていることを確認し、アカウントに適切な IAM ロールが追加されていることを確認します。スペース管理者ロールがある場合は、アカウントを調整または追加できます。詳細については、「接続された AWS リソースへのアクセスを許可する AWS アカウント」を参照してください。

プロジェクトを作成するために、関連付けられたアカウント、ロール、環境が必要です

問題: プロジェクト作成オプションには、プロジェクトに自分のスペースで使用できる追加アカウントがないか、プロジェクトで使用するために自分のスペースに別のアカウントを追加する必要があります。

解決方法: お使いのスペースについては、スペース管理者ロールがある場合は、承認済みの AWS アカウントを追加してそれらをプロジェクトに追加できます。また、管理者権限を持っているか、AWS 管理者と連携できる AWS アカウントも必要です。

プロジェクト作成画面でアカウントとロールを使用可能にするには、まずアカウントとロールを追加する必要があります。詳細については、「接続された AWS リソースへのアクセスを許可する AWS アカウント」を参照してください。

CodeCatalystWorkflowDevelopmentRole-spaceName ロールポリシーと呼ばれるロールポリシーを使用してサービスロールを作成することもできます。ロールには、一意の識別子が付加された CodeCatalystWorkflowDevelopmentRole-spaceName という名前が付けられます。ロールとロールポリシーの詳細については、「CodeCatalystWorkflowDevelopmentRole-spaceName サービスロールについて」を参照してください。ロールを作成する手順については、「アカウントとスペース用の CodeCatalystWorkflowDevelopmentRole-spaceName ロールを作成する」を参照してください。ロールはアカウントに追加され、CodeCatalyst のプロジェクト作成ページで使用できます。

AWS マネジメントコンソールで Amazon CodeCatalyst スペースページにアクセスできません

問題: AWS マネジメントコンソールの Amazon CodeCatalyst ページにアクセスして、CodeCatalyst スペースにアカウントを追加したり、AWS のアカウントにロールを追加したりしようとすると、アクセス許可エラーが表示されます。

解決方法:

お使いのスペースについては、スペース管理者ロールがある場合は、承認済みの AWS アカウント を追加してそれらをプロジェクトに追加できます。また、管理者権限を持っているか、AWS 管理者と連携できる AWS アカウントも必要です。まずは管理するアカウントものと同じアカウントで AWS マネジメントコンソールにサインインしていることを確認する必要があります。AWS マネジメントコンソールにサインインしたら、コンソールを開いてもう一度試してください。

https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/ で AWS マネジメントコンソールの Amazon CodeCatalyst ページを開きます。

請求アカウントとは異なるアカウントが必要です

問題: CodeCatalyst ログインを設定するときに、いくつかのステップを実行してスペースの設定と承認済みの AWS アカウントの関連付けを行いました。それなのに、請求用に別のアカウントを承認する必要があります。

解決方法: お使いのスペースについては、スペース管理者ロールがある場合は、請求アカウントを承認できます。また、管理者権限を持っているか、AWS 管理者と連携できる AWS アカウントも必要です。

詳細については、「Amazon CodeCatalyst Administrator Guide」の「請求管理」を参照してください。

接続名エラーでプロジェクトワークフローが失敗します

問題: プロジェクトを作成してからプロジェクトワークフローを実行すると、ワークフローは失敗し、次のように接続名が無効であるというエラーが表示されます。

<action_name> で失敗: 接続名が無効です。

解決方法: スペースに追加するアカウント ID を指定し、そのアカウントがプロジェクト制限アカウント接続に対して有効になっていないことを確認します。アカウントでプロジェクト制限アカウント接続が有効になっている場合は、新しいプロジェクトへのアクセスを有効にしてアカウント接続を更新する必要がある場合があります。詳細については、「プロジェクト制限アカウント接続の設定」を参照してください。