トラブルシューティング AWS CodeBuild

このトピックの情報を使用して、問題を特定、診断、対処します。 CodeBuild ビルドをログに記録してモニタリングして問題をトラブルシューティングする方法については、「」を参照してくださいログ記録とモニタリング。

Apache Maven が間違ったリポジトリのアーティファクトを参照している

問題： Maven を AWS CodeBuildが提供する Java ビルド環境で使用する場合、Maven は https://repo1.maven.org/maven2 の安全な中央 Maven リポジトリからビルドとプラグインの依存関係を取得します。これは、ビルドプロジェクトの pom.xml ファイルが別の場所を使用すると明示的に宣言した場合でも発生します。

考えられる原因： CodeBuild が提供する Java ビルド環境には、ビルド環境の /root/.m2 ディレクトリにプリインストールされている settings.xml という名前のファイルが含まれます。この settings.xml には次の宣言が含まれています。これにより、Maven が常に https://repo1.maven.org/maven2 で、セキュアな中央 Maven リポジトリからビルドおよびプラグインの依存関係を引き出すように指示されます。

<settings>
  <activeProfiles>
    <activeProfile>securecentral</activeProfile>
  </activeProfiles>
  <profiles>
    <profile>
      <id>securecentral</id>
      <repositories>
        <repository>
          <id>central</id>
          <url>https://repo1.maven.org/maven2</url>
          <releases>
            <enabled>true</enabled>
          </releases>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
          <id>central</id>
          <url>https://repo1.maven.org/maven2</url>
          <releases>
            <enabled>true</enabled>
          </releases>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>
</settings>

推奨される解決策: 以下を実行してください。

ビルドコマンドがデフォルトでルートとして実行される

問題： AWS CodeBuild ビルドコマンドをルートユーザーとして実行します。これは、関連するビルドイメージの Dockerfile によって USER インストラクションが別のユーザーに設定された場合でも発生します。

原因： デフォルトでは、 はすべてのビルドコマンドをルートユーザーとして CodeBuild 実行します。

推奨される解決策: なし。

ファイル名に英語以外の文字が含まれているとビルドが失敗する場合があります

問題: 英語以外の文字 (漢字など) を含むファイル名のファイルを使用するビルドを実行すると、ビルドが失敗します。

考えられる原因： が提供するビルド環境 AWS CodeBuild のデフォルトのロケールは に設定されていますPOSIX。POSIXローカリゼーション設定は、米国以外の CodeBuild および を含むファイル名との互換性が低くなります。 および は、関連するビルドが失敗する可能性があります。

推奨される解決策: buildspec ファイルの pre_build セクションに次のコマンドを追加します。これらのコマンドにより、ビルド環境はローカリゼーション設定に U.S. English UTF-8 を使用します。これは、米国以外の CodeBuild および を含むファイル名と互換性があります。 英語の文字。

Ubuntu ベースのビルド環境の場合:

pre_build:
  commands:
    - export LC_ALL="en_US.UTF-8"
    - locale-gen en_US en_US.UTF-8
    - dpkg-reconfigure locales

Amazon Linux ベースのビルド環境の場合:

pre_build:
  commands:
    - export LC_ALL="en_US.utf8"

Amazon Parameter Store EC2 からパラメータを取得すると、ビルドが失敗する可能性があります

問題： ビルドが Amazon Parameter Store に保存されている 1 EC2 つ以上のパラメータの値を取得しようとすると、ビルドは DOWNLOAD_SOURCE フェーズでエラー で失敗しますParameter does not exist。

考えられる原因： ビルドプロジェクトが依存するサービスロールには、 ssm:GetParametersアクションを呼び出すアクセス許可がないか、ビルドプロジェクトが によって生成されたサービスロールを使用してssm:GetParametersアクションの呼び出し AWS CodeBuild を許可しますが、パラメータには で始まらない名前があります/CodeBuild/。

推奨される解決策:

CodeBuild コンソールでブランチフィルターにアクセスできない

問題： ブランチフィルターオプションは、 AWS CodeBuild プロジェクトを作成または更新するときにコンソールでは使用できません。

考えられる原因: ブランチフィルタオプションは廃止されました。これは webhook フィルターグループに置き換えられ、 で新しいビルドをトリガーする webhook イベントをより細かく制御できるようになりました CodeBuild。

推奨される解決策: ウェブフックフィルタの導入前に作成したブランチフィルタを移行するには、正規表現 HEAD_REF で ^refs/heads/branchName$ フィルタを使用してウェブフックフィルタグループを作成します。たとえば、ブランチフィルタの正規表現が ^branchName$ の場合、HEAD_REF フィルタに入力する更新後の正規表現は ^refs/heads/branchName$ です。詳細については、「Bitbucket ウェブフックイベント」および「 GitHub Webhook イベントをフィルタリングする (コンソール）」を参照してください。

ビルドの成功または失敗を表示できない

問題: 再試行されたビルドの成功または失敗を確認できない。

考えられる原因: ビルドのステータスを報告するオプションが有効になっていません。

推奨される解決策： CodeBuild プロジェクトを作成または更新するときにレポートビルドステータスを有効にします。このオプションは、 CodeBuildビルドをトリガーするときに が ステータスをレポートするように指定します。詳細については、「 リファレンスreportBuildStatus」の「」を参照してください。 AWS CodeBuild API

ビルドステータスがソースプロバイダに報告されない

問題： GitHub や Bitbucket などのソースプロバイダーへのビルドステータスレポートを許可した後、ビルドステータスは更新されません。

考えられる原因: ソースプロバイダーに関連付けられたユーザーに、リポジトリへの書き込みアクセス許可がありません。

推奨される解決策: ソースプロバイダーにビルドステータスを報告できるようにするには、ソースプロバイダーに関連付けられたユーザーがリポジトリへの書き込みアクセス権を持っている必要があります。ユーザーが書き込みアクセス権を持っていない場合、ビルドのステータスは更新できません。詳細については、「ソースプロバイダーのアクセス」を参照してください。

Windows Server Core 2019 プラットフォームの基本イメージが見つからず、選択できない

問題: Windows Server Core 2019 プラットフォームの基本イメージを検索または選択できない。

考えられる原因： このイメージをサポートしていない AWS リージョンを使用しています。

推奨される解決策: Windows Server Core 2019 プラットフォームの基本イメージがサポートされている、次のいずれかの AWS リージョンを使用します。

buildspec ファイルの以前のコマンドが、以降のコマンドで認識されない

問題: buildspec ファイルの 1 つ以上のコマンドの結果が、同じ buildspec ファイルの以降のコマンドで認識されない。たとえば、コマンドによってローカル環境変数が設定される場合がありますが、後で実行されるコマンドがそのローカル環境変数の値を取得できない可能性があります。

考えられる原因: buildspec ファイルバージョン 0.1 では、 AWS CodeBuild はビルド環境のデフォルトシェルの各インスタンスで各コマンドを実行します。つまり、各コマンドは他のすべてのコマンドとは独立して実行されます。デフォルトでは、以前のコマンドの状態に依存する単一のコマンドを実行することはできません。

推奨される解決策: buildspec バージョン 0.2 を使用してください。これにより、問題が解決されます。何らかの理由で buildspec バージョン 0.1 を使用する必要がある場合は、シェルコマンド連鎖演算子 (Linux の && など) を使用して、複数のコマンドを 1 つのコマンドにまとめることをお勧めします。または、複数のコマンドを含むソースコードにシェルスクリプトを組み込み、そのシェルスクリプトを buildspec ファイルの 1 つのコマンドから呼び出します。詳細については、「ビルド環境のシェルとコマンド」および「ビルド環境の環境変数」を参照してください。

エラー: キャッシュのダウンロード時に「アクセスが拒否される」

問題: キャッシュが有効になっているビルドプロジェクトでキャッシュをダウンロードしようとすると、Access denied エラーが発生する。

考えられる原因:

推奨される解決策: キャッシュ設定を更新した直後に初めて使用する場合、このエラーが表示されるのは普通です。このエラーが解消されない場合は、キャッシュを保持する S3 バケットへの s3:GetObject アクセス許可と s3:PutObject アクセス許可が、サービスロールに付与されているかどうかを確認する必要があります。詳細については、「Amazon S3 デベロッパーガイド」の「S3 アクセス許可の指定」を参照してください。

エラー: カスタムビルドイメージを使用する場合のBUILDCONTAINER「_UNABLE_TOPULL__IMAGE」

問題: カスタムビルドイメージを使用するビルドを実行しようとすると、ビルドは BUILD_CONTAINER_UNABLE_TO_PULL_IMAGE というエラーで失敗する。

エラー：「ビルドコンテナはビルドの完了前にデッドを検出しました。ビルドコンテナはメモリ不足のため、または Docker イメージがサポートされていないため、デッドされました。 ErrorCode: 500」

問題： で Microsoft Windows または Linux コンテナを使用しようとすると AWS CodeBuild、このエラーはPROVISIONINGフェーズ中に発生します。

考えられる原因:

推奨される解決策:

Error: "Cannot connect to the Docker daemon" when running a build (ビルドの実行時に「Docker デーモンに接続できません」)

問題: ビルドが失敗し、「Cannot connect to the Docker daemon at unix:/var/run/docker.sock. Is the docker daemon running?」のようなエラーがビルドログに表示される。

考えられる原因: 特権モードでビルドを実行していません。

推奨される解決策: このエラーを修正するには、特権モードを有効にし、次の手順を使用して buildspec を更新する必要があります。

特権モードでビルドを実行するには、次の手順に従います。

また、コンテナ内で Docker デーモンを起動する必要があります。buildspec のinstallフェーズは、これに似ている場合があります。

phases:
  install:
    commands:
      - nohup /usr/local/bin/dockerd --host=unix:///var/run/docker.sock --host=tcp://127.0.0.1:2375 --storage-driver=overlay2 &
      - timeout 15 sh -c "until docker info; do echo .; sleep 1; done"

buildspec ファイルで参照される OverlayFS ストレージドライバーの詳細については、Docker ウェブサイトの「Use the OverlayFS storage driver」を参照してください。

- timeout -t 15 sh -c "until docker info; do echo .; sleep 1; done"

を使用して Docker イメージを構築および実行する方法については AWS CodeBuild、「」を参照してくださいのカスタムイメージサンプルの Docker CodeBuild。

エラー: ビルドプロジェクトを作成または更新するときに、「 の実行が許可されCodeBuild ていません: sts:AssumeRole」

問題: ビルドプロジェクトを作成または更新しようとすると、エラー「Code:InvalidInputException, Message:CodeBuild is not authorized to perform: sts:AssumeRole on arn:aws:iam::account-ID:role/service-role-name」が発生する。

考えられる原因:

推奨される解決策:

エラー：「 を呼び出すエラー GetBucketAcl: バケット所有者が変更されているか、サービスロールに s3:GetBucketAcl」を呼び出すアクセス許可がなくなりました

問題: ビルドを実行すると、S3 バケット所有者や GetBucketAcl アクセス許可の変更に関するエラーが発生する。

考えられる原因： IAMロールに s3:GetBucketAclおよび s3:GetBucketLocation アクセス許可を追加しました。これらのアクセス許可は、プロジェクトの S3 バケットを保護し、バケットにアクセスできるユーザーを自分に限定します。これらのアクセス許可を追加した後で、S3 バケットの所有者が変更されています。

推奨される解決策： S3 バケットの所有者であることを確認し、IAMロールに再度アクセス許可を追加します。詳細については、「S3 バケットへの安全なアクセス」を参照してください。

エラー: ビルドの実行時に「アーティファクトのアップロードに失敗しました: 無効な ARN」

問題: ビルドを実行すると、UPLOAD_ARTIFACTS ビルドフェーズが失敗し、「Failed to upload artifacts: Invalid arn」というエラーが表示される。

考えられる原因： S3 出力バケット (ビルドからの出力 AWS CodeBuild を保存するバケット) が CodeBuild 、ビルドプロジェクトとは異なる AWS リージョンにある。

推奨される解決策： ビルドプロジェクトの設定を更新して、ビルドプロジェクトと同じ AWS リージョンにある出力バケットをポイントします。

エラー：「Git クローンが失敗しました: アクセスできません'your-repository-URL': SSL証明書の問題: 自己署名証明書」

問題: ビルドプロジェクトを実行しようとすると、このエラーが発生してビルドが失敗する。

考えられる原因: ソースリポジトリには自己署名証明書がありますが、S3 バケットから証明書をビルドプロジェクトの一部としてインストールする選択をしていません。

推奨される解決策:

エラー: ビルドの実行時に「アクセスしようとしているバケットは、指定されたエンドポイントを使用してアドレス指定する必要があります」

問題: ビルドを実行すると、DOWNLOAD_SOURCE ビルドフェーズが失敗し、「The bucket you are attempting to access must be addressed using the specified endpoint. Please send all future requests to this endpoint」というエラーが表示される。

考えられる原因： 構築済みのソースコードは S3 バケットに保存され、そのバケットは構築プロジェクトとは異なる AWS AWS CodeBuild リージョンにあります。

推奨される解決策: 構築済みのソースコードが含まれているバケットを指すように、ビルドプロジェクトの設定を更新します。バケットがビルドプロジェクトと同じ AWS リージョンにあることを確認します。

エラー: "このビルドイメージではランタイムバージョンを少なくとも 1 つ選択する必要があります。"

問題: ビルドを実行すると、DOWNLOAD_SOURCE ビルドフェーズが失敗し、「YAML_FILE_ERROR: This build image requires selecting at least one runtime version」というエラーが表示される。

考えられる原因： ビルドでは、Amazon Linux 2 (AL2) 標準イメージのバージョン 1.0 以降、または Ubuntu 標準イメージのバージョン 2.0 以降が使用され、ランタイムは buildspec ファイルで指定されません。

推奨される解決策： aws/codebuild/standard:2.0 CodeBuild マネージドイメージを使用する場合は、buildspec ファイルruntime-versionsのセクションでランタイムバージョンを指定する必要があります。例えば、 を使用するプロジェクトには、次の buildspec ファイルを使用できますPHP。

version: 0.2

phases:
  install:
    runtime-versions:
        php: 7.3
  build:
    commands:
      - php --version
artifacts:
  files:
    -  README.md

詳細については、「Specify runtime versions in the buildspec file」を参照してください。

エラー: ビルドキュー内のビルドが失敗した場合のQUEUED「: INSUFFICIENT_SUBNET」

問題: ビルドキューのビルドが QUEUED: INSUFFICIENT_SUBNET のようなエラーで失敗する。

考えられる原因： に指定されたIPv4CIDRブロックは、予約された IP アドレスVPCを使用します。各サブネットCIDRブロック内の最初の 4 つの IP アドレスと最後の IP アドレスは、 を使用できず、インスタンスに割り当てることはできません。例えば、CIDRブロック を持つサブネットでは10.0.0.0/24、次の 5 つの IP アドレスが予約されています。

推奨される解決策： が予約済み IP アドレスVPCを使用しているかどうかを確認します。予約済みの IP アドレスを、予約されていないアドレスに置き換えます。詳細については、「Amazon VPCユーザーガイド」の「 VPCおよびサブネットのサイズ設定」を参照してください。

エラー: 「キャッシュをダウンロードできません: RequestError: リクエストの送信が失敗しました。原因: x509: システムルートのロードに失敗し、ルートが指定されていません」

問題: ビルドプロジェクトを実行しようとすると、このエラーが発生してビルドが失敗する。

考えられる原因: ビルドプロジェクトの一部としてキャッシュを設定し、有効期限が切れたルート証明書を含む古い Docker イメージを使用しています。

推奨される解決策： AWS CodeBuild プロジェクトで使用されている Docker イメージを更新します。詳細については、「が提供する Docker イメージ CodeBuild」を参照してください。

エラー:S3 から証明書をダウンロードできません。 AccessDenied」

問題: ビルドプロジェクトを実行しようとすると、このエラーが発生してビルドが失敗する。

考えられる原因:

推奨される解決策:

エラー: 「認証情報を見つけることができません」

問題： を実行したり AWS CLI、 を使用した AWS りSDK、ビルドの一部として別の同様のコンポーネントを呼び出そうとすると、 AWS CLI、 AWS SDK、または コンポーネントに直接関連するビルドエラーが発生します。たとえば、「Unable to locate credentials」などのビルドエラーが発生する場合があります。

考えられる原因:

推奨される解決策:

RequestError プロキシサーバー CodeBuild で を実行するときのタイムアウトエラー

問題: 次のいずれかのような RequestError エラーが表示される。

考えられる原因:

推奨される解決策:

ビルドイメージ内に Bourne シェル (sh) が必要

問題： によって提供されていないビルドイメージを使用しており AWS CodeBuild、ビルドがメッセージ で失敗しますBuild container found dead before completing the build。

考えられる原因： Bourne シェル (sh) はビルド image. CodeBuild needs sh に含まれていません。ビルドコマンドとスクリプトを実行します。

推奨される解決策: ビルドイメージに sh が含まれていない場合、イメージを使用するビルドを開始する前に必ずそれを含めてください  （ビルドイメージshに CodeBuild が既に含まれています）。

警告 (ビルドの実行時): 「ランタイムのインストールをスキップします。このビルドイメージではランタイムバージョンの選択はサポートされていません」

問題: ビルドを実行すると、この警告がビルドログに表示される。

考えられる原因： ビルドでは、Amazon Linux 2 (AL2) 標準イメージのバージョン 1.0 以降、または Ubuntu 標準イメージのバージョン 2.0 以降が使用されておらず、ランタイムは buildspec ファイルの runtime-versionsセクションで指定されています。

推奨される解決策: buildspec ファイルに runtime-versions セクションが含まれていないことを確認します。runtime-versions セクションは、Amazon Linux 2 (AL2) 標準イメージ以降、または Ubuntu 標準イメージバージョン 2.0 以降を使用する場合にのみ必要です。

エラー: CodeBuild コンソールを開くときに JobWorker 「アイデンティティを確認できません」

問題： CodeBuild コンソールを開くと、 JobWorker 「ID を検証できない」というエラーメッセージが表示されます。

考えられる原因： コンソールアクセスに使用されるIAMロールには、キーjobIdとして というタグがあります。このタグキーは 用に予約 CodeBuild されており、存在するとこのエラーが発生します。

推奨される解決策： キーを持つカスタムIAMロールタグを、 などの別のキーを持つjobIdように変更しますjobIdentifier。

ビルドの開始の失敗

問題: ビルドを開始すると、「ビルドを開始できませんでした」というエラーメッセージが表示される。

考えられる原因: 同時に実行できるビルド数の上限に達しています。

推奨される解決策: 他のビルドが完了するまで待つか、プロジェクトの同時実行のビルド制限を増やして、ビルドを再度開始します。詳細については、「プロジェクトの設定」を参照してください。

ローカルキャッシュされたビルドの GitHub メタデータへのアクセス

問題: 状況によっては、キャッシュされたビルドの .git ディレクトリは、ディレクトリではなく、テキストファイルである場合があります。

考えられる原因： ビルドでローカルソースキャッシュが有効になっている場合、 は .git ディレクトリの gitlink CodeBuild を作成します。つまり、.git ディレクトリは、単にディレクトリへのパスを含むテキストファイルです。

推奨される解決策: すべての場合において、次のコマンドを使用して Git メタデータディレクトリを取得します。このコマンドは、.git のフォーマットに関係なく機能します。

git rev-parse --git-dir

AccessDenied: レポートグループのバケット所有者が S3 バケットの所有者と一致しません...

問題： Amazon S3 バケットにテストデータをアップロードする場合、 CodeBuild はテストデータをバケットに書き込めません。

考えられる原因:

推奨される解決策: