---
title: "SourceDeploy のトラブルシューティング"
slug: "sourcedeploy-troubleshoot"
updated: 2026-09-17T09:23:35Z
published: 2026-09-17T09:23:35Z
canonical: "guide.ncloud-docs.com/sourcedeploy-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.
# SourceDeploy のトラブルシューティング
Classic/VPC環境で利用できます。
SourceDeployサービスの利用中に次のような問題が発生することがあります。問題ごとの原因と解決方法を確認し、適切に対処してください。
## エージェントアクセスエラー
SourceDeploy用エージェントをインストールしたにもかかわらず、リリースを実行すると「agent connect fail」というログが発生します。 「failed to connect agent」というエラーメッセージが表示されます。
#### 原因
- NCP_AUTH_KEYファイルが存在しない場合、エラーが発生することがあります。
- サポートする Pythonバージョンでない場合、エラーが発生することがあります。
- エージェントバージョンが間違っている場合、エラーが発生することがあります。
- 環境に合わないエージェントをインストール、エラーが発生することがあります。
#### 解決方法
- **NCP_AUTH_KEYファイルが存在しない場合**
- エージェントが正常に動作するには、サーバ内の/opt下位に NCP_AUTH_KEYファイルが存在する必要があります。
- 当該キーファイルの存在有無をご確認ください。
- キーファイルの内容が正常に作成されたかご確認ください。
- NCP_AUTH_KEYファイルを作成する方法は、[エージェントのインストールと管理](/docs/ja/devtools-devtools-4-4)をご参照ください。
- **サポートする Pythonバージョンではない場合**
- エージェントは韓国リージョン基準に Python 3.6バージョン以上3.12.7バージョン以下で動作します。サーバにインストールされた Pythonバージョンをご確認ください。
- **環境に合わないエージェントをインストールした場合**
- [エージェントのインストールと管理](/docs/ja/devtools-devtools-4-4)を参照してサポート環境を確認し、使用リージョンと環境に該当するエージェントダウンロードアドレスを入力してください。
- **エージェントが前のバージョンである場合**
- エージェントのステータス確認コマンドを入力してエージェントが正常にインストールされたかどうか確認します。
```
service sourcedeploy status
```
- インストールされたエージェントのバージョンを確認します。
```
cat /opt/sdagent/Agent.ver
```
例) 2021/05/27基準
```
[VERSION]
ver=2021/05/18/01
```
- インストールされたエージェントのバージョンが古いバージョンである場合、エージェントを削除してから再インストールします。
- エージェントの削除は、[エージェント削除](/docs/ja/devtools-devtools-4-4#%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EC%82%AD%EC%A0%9C)をご参照ください。
- サーバのステータスが**運用中**になっているか確認します。
- 上記の実行後もエージェントエラーが発生する場合、エージェント動作ログを[サポート](https://www.ncloud.com/support/question/service)までご送付ください。
エージェント動作ログを照会する方法は次の通りです。
```
$ grep gateway /opt/sdagent/resource.py;
$ service sourcedeploy status;
$ cat /opt/sdagent/Agent.ver;
$ cat /var/sourcedeploy/log/sourcedeploy-0-system.log
```
## エージェントプロセス実行エラー
エージェントプロセスが正常に実行されません。
#### 原因
エージェントが正常にインストールされていません。
#### 解決方法
- 再起動コマンドを入力してエージェントを再起動してください。
```
service sourcedeploy restart
```
- 再起動しても正常に動作しない場合は、下記の Linuxパッケージをインストールした後、エージェントを再インストールしてください。
```
# CentOS, Rocky
sudo yum install -y epel-release ca-certificates openssl-devel zlib-devel
# Ubuntu
sudo apt-get install -y build-essential ca-certificates libssl-dev zlib1g-dev
```
- エージェントのプロセスを確認してエージェントが正常に実行されるか確認できます。
```
ps -ef | grep main.py
```
参考
エージェントプロセスの正常実行基準は次の通りです。
- プロセス1個実行
## エージェントインストールエラー
エージェントが正常にインストールされません。
#### 原因
- 認証キー値が正しくありません。
- スクリプトパスの指定が正しくありません。
- エージェントインストール URLが正しくありません。
#### 解決方法
- 認証キー値が正常に入力されたか確認します。
```
cat /opt/NCP_AUTH_KEY
```
- Init Script最初の行に `#!/usr/bin/env python`、`#!/bin/perl`、`#!/bin/bash` などの形式で、実行したいスクリプトパスを指定したかご確認ください。
- Init Scriptにエージェントのインストール URLが以下のように入力されたか確認します。 `Shell wget {エージェントのダウンロードアドレス}`
| 環境 | リージョン | エージェントダウンロードアドレス | ヘッダ名 | ヘッダ値 |
| --- | --- | --- | --- | --- |
| VPC | 韓国(KR) | https://sourcedeploy-agent.apigw.ntruss.com/agent/vpc-v2/download/install | x-ncp-region_code | KR |
| シンガポール(SGN) | SGN |
| 日本(JPN) | JPN |
| Classic | 韓国(KR) | https://sourcedeploy-agent.apigw.ntruss.com/agent/v3/download/install | - | - |
- 使用環境とリージョンに応じたエージェントのダウンロードアドレスは、次の通りです。
参考
`x-ncp-region_code` ヘッダが設定されていない場合、デフォルトとして「KR」が適用されます。
## Install Python失敗
Install Pythonステップで失敗します。
#### 原因
SourceDeployのエージェントは、Python 3.6以上3.12.7以下バージョンを使用しています。Agent Installスクリプトで自動的に Pythonインストールが実行されない場合、問題が発生することがあります。
#### 解決方法
以下のコマンドを入力して Python3をインストールします。
```
$ apt-get install -y python3.11
```
## ロールバック失敗
ロールバックに失敗しました。
#### 原因
- 以前リリースしたファイルが Object Storageにありません。
- 最後の成功リリース記録がありません。
- ファイルが変更されました。
#### 解決方法
SourceDeployのロールバック機能は、最後に成功したリリースを再実行する方式で動作します。最後に成功したリリース記録があるか確認した後、リリースファイルが Object Storageに存在することをご確認ください。
## コンテンツ一覧
NAVERクラウドプラットフォームでは顧客を支援するために様々な方法で情報を提供します。SourceDeployサービスの利用時に活用できる有用なコンテンツをご案内します。
- よくある質問: [SourceDeployに関するよくあるご質問](https://www.ncloud.com/support/faq/prod?categoryCode2=DEVTL&categoryCode3=SV_0106&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ガイド: [SourceDeploy APIガイド](https://api.ncloud-docs.com/docs/ja/devtools-sourcedeploy)