---
title: "SourceBuild のトラブルシューティング"
slug: "sourcebuild-troubleshoot"
updated: 2026-09-17T09:23:35Z
published: 2026-09-17T09:23:35Z
canonical: "guide.ncloud-docs.com/sourcebuild-troubleshoot"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

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

#### 原因

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

#### 解決方法

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

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

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

#### 原因

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

#### 解決方法

Docker Hubの Rate Limitなしにビルドを実行するには、使用するイメージを [Container Registry](https://www.ncloud.com/product/containers/containerRegistry)に直接アップロードした後にそのイメージをビルド環境イメージとして使用することをお勧めします。

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

1. NAVERクラウドプラットフォームコンソールで、 **Menu** > **All Services** > **Container** > **Container Registry** メニューを順にクリックします。
2. [Container Registry情報確認と管理](/docs/ja/container-ncr-1-3)を参照して使用するイメージを Container Registryレジストリにアップロードします。
3. NAVERクラウドプラットフォームコンソールで、 **Menu** > **All 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](https://docs.docker.com/docker-hub/usage/pulls)を参照)。

#### 解決方法

Docker Hubの Rate Limitなしにビルドを実行するには、使用するイメージを [Container Registry](https://www.ncloud.com/product/containers/containerRegistry)に直接アップロードした後にそのイメージを Dockerfileのベースイメージとして使用することをお勧めします。

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

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

参考

イメージダウンロード(Pull)時に別途の認証なしに誰でもダウンロードできるように設定するには、[Public Registryの有効化](/docs/ja/container-ncr-1-3#%ED%8D%BC%EB%B8%94%EB%A6%AD%EB%A0%88%EC%A7%80%EC%8A%A4%ED%8A%B8%EB%A6%AC%ED%99%9C%EC%84%B1%EB%B9%84%ED%99%9C%EC%84%B1%ED%99%94)をご参照ください。

## コンテンツ一覧

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

- よくある質問: [SourceBuildに関するよくあるご質問](https://www.ncloud.com/support/faq/prod?categoryCode2=DEVTL&categoryCode3=SV_0107&page=1)
- NAVERクラウドプラットフォームブログ: [SourceDeploy & SourceBuild - Github Enterprise Server連携機能を提供](https://blog.naver.com/n_cloudplatform/223272473873?trackingCode=blog_bloghome_searchlist)
- NAVERクラウドプラットフォームブログ: [Kubernetesクラスタにアプリケーションをリリースする-NAVERクラウドプラットフォーム Developer Tools(デベロッパーツール)活用実践編](https://blog.naver.com/n_cloudplatform/223209131446?trackingCode=blog_bloghome_searchlist)
- APIガイド: [SourceBuild APIガイド](https://api.ncloud-docs.com/docs/ja/devtools-sourcebuild)

参考

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