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

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

# 開発環境に関する問題のトラブルシューティング
<a name="devenvironments-troubleshooting"></a>

開発環境に関連する問題のトラブルシューティングについては、以下のセクションを参照してください。環境タグ付けの詳細については、「[CodeCatalyst で開発環境を使用してコードを記述および変更する開発環境でコードを記述および変更する](devenvironment.md)」を参照してください。

**Topics**
+ [クォータに問題があるため、開発環境の作成が成功しなかった](#troubleshooting-devenvironments-create)
+ [開発環境からリポジトリ内の特定のブランチに変更をプッシュできない](#troubleshooting-devenvironments-branchrules)
+ [開発環境が再開されなかった](#troubleshooting-devenvironments-resume)
+ [開発環境が切断された](#troubleshooting-devenvironments-connection)
+ [VPC に接続された開発環境が失敗した](#troubleshooting-devenvironments-vpc)
+ [プロジェクトがどのディレクトリにあるかわからない](#troubleshooting-devenvironments-projects)
+ [SSH 経由で開発環境に接続できない](#troubleshooting-devenvironments-connect-ssh)
+ [ローカル SSH 設定がないため、SSH 経由で開発環境に接続できない](#troubleshooting-devenvironments-projects-ssh-config)
+ [`codecatalyst` プロファイル AWS Config の に問題があるため、SSH 経由で開発環境に接続できません](#troubleshooting-devenvironments-config-profile)
+ [単一のサインオンアカウントを使用して CodeCatalyst にサインインすると、開発環境を作成できない](#troubleshoot-create-dev-env-idprovider)
+ [IDE に関する問題のトラブルシューティング](devenvironments-troubleshooting-ides.md)
+ [devfiles に関する問題のトラブルシューティング](devenvironments-devenvironments-devfile.md)

## クォータに問題があるため、開発環境の作成が成功しなかった
<a name="troubleshooting-devenvironments-create"></a>

**問題:** CodeCatalyst で開発環境を作成したいが、エラーが表示される。コンソールで、開発環境ページに、スペースのストレージ制限に達したことを示すメッセージが表示されます。

**解決方法:** プロジェクトまたはスペース内のロールに応じて、1 つ以上の独自の開発環境を削除するか、スペース管理者ロールがある場合は、他のユーザーが作成した未使用の開発環境を削除できます。請求階層を、より多くのストレージが含まれる請求階層に変更することもできます。
+ ストレージ制限を表示するには、Amazon CodeCatalyst スペースの **[請求]** タブを表示して、**[使用量]** クォータが最大許容数に達したかどうかを確認します。クォータが上限に達した場合は、スペース管理者ロールを持つユーザーに連絡して、不要な開発環境を削除するか、請求階層の変更を検討してください。
+ 不要になった開発環境を削除するには、「[開発環境の削除](devenvironment-delete.md)」を参照してください。

問題が継続し、IDE でエラーが発生した場合は、開発環境を作成できる CodeCatalyst ロールがあることを確認してください。**[スペース管理者]** ロール、**[プロジェクト管理者]** ロール、および **[コントリビューター]** ロールにはすべて、開発環境を作成するアクセス許可があります。詳細については、「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」を参照してください。

## 開発環境からリポジトリ内の特定のブランチに変更をプッシュできない
<a name="troubleshooting-devenvironments-branchrules"></a>

**問題:** 開発環境のコード変更をコミットしてソースリポジトリのブランチにプッシュしたいが、エラーが表示される。

**解決方法:** プロジェクトまたはスペース内のロールによっては、プロジェクト内のソースリポジトリにコードをプッシュするアクセス許可がない場合があります。**[スペース管理者]** ロール、**[プロジェクト管理者]** ロール、および **[コントリビューター]** ロールはすべて、プロジェクト内のリポジトリにコードをプッシュするアクセス許可を持っています。

**[コントリビューター]** ロールを持っているが、特定のブランチにコードをプッシュできない場合、そのロールを持つユーザーがそのブランチにコードをプッシュできないように、特定のブランチにブランチルールが設定されている場合があります。変更を別のブランチにプッシュするか、ブランチを作成してから、コードをそのブランチにプッシュしてみてください。詳細については、「[ブランチルールを使用してブランチで許可されたアクションを管理する](source-branches-branch-rules.md)」を参照してください。

## 開発環境が再開されなかった
<a name="troubleshooting-devenvironments-resume"></a>

**問題:** 開発環境を停止した後、再開できない。

**解決方法:** 問題を解決するには、Amazon CodeCatalyst スペースの **[請求]** タブを表示して、**[使用量]** クォータが上限に達したかどうかを確認します。クォータが上限に達した場合は、スペース管理者に連絡して請求階層を引き上げてください。

## 開発環境が切断された
<a name="troubleshooting-devenvironments-connection"></a>

**問題:** 使用中に開発環境が切断されました。

**解決方法:** 問題を解決するには、インターネット接続を確認してください。インターネットに接続していない場合は、開発環境に接続して作業を再開します。

## VPC に接続された開発環境が失敗した
<a name="troubleshooting-devenvironments-vpc"></a>

**問題:** VPC 接続を開発環境に関連付けると、エラーが発生しています。

**解決方法:** Docker は、同じブリッジネットワークに接続されているコンテナが通信できるようにするブリッジネットワークと呼ばれるリンクレイヤーデバイスを使用します。デフォルトのブリッジは、コンテナのネットワークに通常 `172.17.0.0/16` サブネットを使用します。環境のインスタンスの VPC サブネットが、Docker で既に使用しているのと同じアドレス範囲を使用している場合、IP アドレスの競合が発生する可能性があります。Amazon VPC および同じ IPv4 CIDR アドレスブロックを使用した Docker の IP アドレスの競合を解決するには、`172.17.0.0/16` とは異なる CIDR ブロックを設定します。

**注記**  
既存の VPC またはサブネットの IP アドレスの範囲を変更することはできません。

## プロジェクトがどのディレクトリにあるかわからない
<a name="troubleshooting-devenvironments-projects"></a>

**問題:** プロジェクトがどのディレクトリにあるかわからない。

**解決方法:** プロジェクトを見つけるには、ディレクトリを `/projects` に変更します。これは、プロジェクトを検索できるディレクトリです。

## SSH 経由で開発環境に接続できない
<a name="troubleshooting-devenvironments-connect-ssh"></a>

SSH を使用して開発環境への接続をトラブルシューティングするには、`-vvv` オプションを使用して `ssh` コマンドを実行して、問題の解決方法の詳細を表示できます。

```
ssh -vvv codecatalyst-dev-env=<space-name>=<project-name>=<dev-environment-id>
```

## ローカル SSH 設定がないため、SSH 経由で開発環境に接続できない
<a name="troubleshooting-devenvironments-projects-ssh-config"></a>

ローカル SSH 設定 (`~/.ssh/config`) が欠落している場合、または `Host codecatalyst-dev-env*` セクションの内容が古い場合、SSH 経由で開発環境に接続することはできません。これをトラブルシューティングするには、`Host codecatalyst-dev-env*` セクションを削除し、**[SSH Access]** モーダルから最初のコマンドを再度実行します。詳細については、「[SSH を使用した開発環境への接続](devenvironment-connect-ssh.md)」を参照してください。

## `codecatalyst` プロファイル AWS Config の に問題があるため、SSH 経由で開発環境に接続できません
<a name="troubleshooting-devenvironments-config-profile"></a>

`codecatalyst` プロファイルの your AWS Config (`~/.aws/config`) が、「」で説明されているものと一致していることを確認します[CodeCatalyst AWS CLI で を使用するための のセットアップ](set-up-cli.md)。そうでない場合は、`codecatalyst` のプロファイルを削除し、**[SSH Access]** モーダルから最初のコマンドを再度実行します。詳細については、「[SSH を使用した開発環境への接続](devenvironment-connect-ssh.md)」を参照してください。

## 単一のサインオンアカウントを使用して CodeCatalyst にサインインすると、開発環境を作成できない
<a name="troubleshoot-create-dev-env-idprovider"></a>

**問題:** CodeCatalyst コンソールに SSO ユーザーとしてサインインすると、スペースに開発環境を作成すると、不明な例外エラーが表示されます。開発環境を作成し、アクセスする IDE を選択すると AWS Cloud9、次のような問題が発生します。
+ CodeCatalyst コンソールの **[開発環境]** ページには、一覧内の開発環境が `FAILED` 状態で表示されます。
+ 次のようなエラーメッセージが表示されます。

  **`An unknown exception happened`**

  `We encountered an unknown exception when launching your Dev Environment. Mention your Dev Environment id error_message_ID if you want to report or need any help.`

**解決方法:** 

開発環境は、Active Directory が ID プロバイダーとして使用されているスペースのユーザーは利用できません。スペース管理者は、IAM アイデンティティセンターなどの開発環境にアクセスするために、代替 ID プロバイダーを使用できます。ID フェデレーションをサポートするスペースの計画の詳細については、「*CodeCatalyst 管理者ガイド*」の「[ID フェデレーションをサポートするスペースの計画](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation)」を参照してください。