SourceBuild のトラブルシューティング

Prev Next

Classic/VPC環境で利用できます。

SourceBuildサービスの利用中に次のような問題が発生することがあります。問題ごとの原因と解決方法を確認し、適切に対処してください。

ビルド結果のアップロード時のエラー

ビルドは成功しましたが、ビルド結果のアップロード時にエラーが発生します。

原因

ビルド結果のパスが間違って設定された場合、エラーが発生することがあります。

解決方法

  • ビルド結果が保存されるディレクトリパスまたはファイルパスが正しいか確認します。
  • ビルド後のコマンド 機能を使用して /build ディレクトリが正常に作成されているかご確認ください。

ビルド環境イメージパブリックレジストリの使用時の Docker Rate Limitエラー

ビルド環境イメージパブリックレジストリの使用時、「Docker Rate Limit」エラーが発生します。

原因

パブリックレジストリの使用時に Docker Hubを通じてイメージをインポートしますが、多数のユーザーが利用するサービスであるため Rate Limitが発生することがあります。Docker Hubでは過度なイメージ pull使用を制限するため、一定時間の間に一定回数だけイメージを pullできるよう制限しており、(Docker Hub pull usage and limitsを参照)、関連ポリシーに従って Dockerで制限を設けるため、具体的な制限基準や解除条件はご案内できません。

解決方法

Docker Hubの Rate Limitなしにビルドを実行するには、使用するイメージを Container Registryに直接アップロードした後にそのイメージをビルド環境イメージとして使用することをお勧めします。

解決方法は次の通りです。

  1. NAVERクラウドプラットフォームコンソールで、 i_menu > Services > Container > Container Registry メニューを順にクリックします。
  2. Container Registry情報確認と管理を参照して使用するイメージを Container Registryレジストリにアップロードします。
  3. NAVERクラウドプラットフォームコンソールで、 Services > Developer Tools > SourceBuild メニューを順にクリックします。
  4. 設定を変更するプロジェクトを選択した後、 [設定変更] ボタンをクリックします。
  5. ビルドプロジェクト設定 画面が表示されたら、ビルド環境イメージ の Container Registryのイメージ を選択します。
  6. レジストリにアップロードしたイメージに変更した後、 [適用] ボタンをクリックします。

Dockerビルドの使用時の Docker Rate Limitエラー

Dockerビルドの使用時に、「Docker Rate Limit」エラーが発生します。

原因

Dockerfile FROM節に使用されるベースイメージを Docker Hubを介してインポートしますが、多数のユーザーが利用するサービスであるため Rate Limitが発生することがあります。Docker Hubでは過度なイメージ pull使用を制限するため、一定時間の間に一定回数だけイメージを pullできるよう制限しています(Docker Hub pull usage and limitsを参照)。

解決方法

Docker Hubの Rate Limitなしにビルドを実行するには、使用するイメージを Container Registryに直接アップロードした後にそのイメージを Dockerfileのベースイメージとして使用することをお勧めします。

解決方法は次の通りです。

  1. NAVERクラウドプラットフォームコンソールで、 Services > Container > Container Registry メニューを順にクリックします。
  2. Container Registry情報の確認と管理を参照して Dockerfileに使用するベースイメージを Container Registryレジストリにアップロードします。
  3. Dockerfileのベースイメージが Container Registryにアップロードしたイメージを使用するように FROM節を変更して反映します。
参考

イメージダウンロード(Pull)時に別途の認証なしに誰でもダウンロードできるように設定するには、Public Registryの有効化をご参照ください。

コンテンツ一覧

NAVERクラウドプラットフォームでは顧客を支援するために様々な方法で情報を提供します。SourceBuildサービスの利用時に活用できる有用なコンテンツをご案内します。

参考

本ガイドで必要な情報が見つからない場合やさらに必要な情報がある場合は、いつでも以下のフィードバックアイコンをクリックして、ご意見をお寄せください。いただいたご意見を参照して、より有益な情報を提供できるよう努力してまいります。