Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 開発環境に関する問題のトラブルシューティング
開発環境に関連する問題のトラブルシューティングについては、以下のセクションを参照してください。環境タグ付けの詳細については、「[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)
## クォータに問題があるため、開発環境の作成が成功しなかった
**問題:** CodeCatalyst で開発環境を作成したいが、エラーが表示される。コンソールで、開発環境ページに、スペースのストレージ制限に達したことを示すメッセージが表示されます。
**解決方法:** プロジェクトまたはスペース内のロールに応じて、1 つ以上の独自の開発環境を削除するか、スペース管理者ロールがある場合は、他のユーザーが作成した未使用の開発環境を削除できます。請求階層を、より多くのストレージが含まれる請求階層に変更することもできます。
+ ストレージ制限を表示するには、Amazon CodeCatalyst スペースの **[請求]** タブを表示して、**[使用量]** クォータが最大許容数に達したかどうかを確認します。クォータが上限に達した場合は、スペース管理者ロールを持つユーザーに連絡して、不要な開発環境を削除するか、請求階層の変更を検討してください。
+ 不要になった開発環境を削除するには、「[開発環境の削除](devenvironment-delete.md)」を参照してください。
問題が継続し、IDE でエラーが発生した場合は、開発環境を作成できる CodeCatalyst ロールがあることを確認してください。**[スペース管理者]** ロール、**[プロジェクト管理者]** ロール、および **[コントリビューター]** ロールにはすべて、開発環境を作成するアクセス許可があります。詳細については、「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」を参照してください。
## 開発環境からリポジトリ内の特定のブランチに変更をプッシュできない
**問題:** 開発環境のコード変更をコミットしてソースリポジトリのブランチにプッシュしたいが、エラーが表示される。
**解決方法:** プロジェクトまたはスペース内のロールによっては、プロジェクト内のソースリポジトリにコードをプッシュするアクセス許可がない場合があります。**[スペース管理者]** ロール、**[プロジェクト管理者]** ロール、および **[コントリビューター]** ロールはすべて、プロジェクト内のリポジトリにコードをプッシュするアクセス許可を持っています。
**[コントリビューター]** ロールを持っているが、特定のブランチにコードをプッシュできない場合、そのロールを持つユーザーがそのブランチにコードをプッシュできないように、特定のブランチにブランチルールが設定されている場合があります。変更を別のブランチにプッシュするか、ブランチを作成してから、コードをそのブランチにプッシュしてみてください。詳細については、「[ブランチルールを使用してブランチで許可されたアクションを管理する](source-branches-branch-rules.md)」を参照してください。
## 開発環境が再開されなかった
**問題:** 開発環境を停止した後、再開できない。
**解決方法:** 問題を解決するには、Amazon CodeCatalyst スペースの **[請求]** タブを表示して、**[使用量]** クォータが上限に達したかどうかを確認します。クォータが上限に達した場合は、スペース管理者に連絡して請求階層を引き上げてください。
## 開発環境が切断された
**問題:** 使用中に開発環境が切断されました。
**解決方法:** 問題を解決するには、インターネット接続を確認してください。インターネットに接続していない場合は、開発環境に接続して作業を再開します。
## VPC に接続された開発環境が失敗した
**問題:** VPC 接続を開発環境に関連付けると、エラーが発生しています。
**解決方法:** Docker は、同じブリッジネットワークに接続されているコンテナが通信できるようにするブリッジネットワークと呼ばれるリンクレイヤーデバイスを使用します。デフォルトのブリッジは、コンテナのネットワークに通常 `172.17.0.0/16` サブネットを使用します。環境のインスタンスの VPC サブネットが、Docker で既に使用しているのと同じアドレス範囲を使用している場合、IP アドレスの競合が発生する可能性があります。Amazon VPC および同じ IPv4 CIDR アドレスブロックを使用した Docker の IP アドレスの競合を解決するには、`172.17.0.0/16` とは異なる CIDR ブロックを設定します。
**注記**
既存の VPC またはサブネットの IP アドレスの範囲を変更することはできません。
## プロジェクトがどのディレクトリにあるかわからない
**問題:** プロジェクトがどのディレクトリにあるかわからない。
**解決方法:** プロジェクトを見つけるには、ディレクトリを `/projects` に変更します。これは、プロジェクトを検索できるディレクトリです。
## SSH 経由で開発環境に接続できない
SSH を使用して開発環境への接続をトラブルシューティングするには、`-vvv` オプションを使用して `ssh` コマンドを実行して、問題の解決方法の詳細を表示できます。
```
ssh -vvv codecatalyst-dev-env===
```
## ローカル SSH 設定がないため、SSH 経由で開発環境に接続できない
ローカル SSH 設定 (`~/.ssh/config`) が欠落している場合、または `Host codecatalyst-dev-env*` セクションの内容が古い場合、SSH 経由で開発環境に接続することはできません。これをトラブルシューティングするには、`Host codecatalyst-dev-env*` セクションを削除し、**[SSH Access]** モーダルから最初のコマンドを再度実行します。詳細については、「[SSH を使用した開発環境への接続](devenvironment-connect-ssh.md)」を参照してください。
## `codecatalyst` プロファイル AWS Config の に問題があるため、SSH 経由で開発環境に接続できません
`codecatalyst` プロファイルの your AWS Config (`~/.aws/config`) が、「」で説明されているものと一致していることを確認します[CodeCatalyst AWS CLI で を使用するための のセットアップ](set-up-cli.md)。そうでない場合は、`codecatalyst` のプロファイルを削除し、**[SSH Access]** モーダルから最初のコマンドを再度実行します。詳細については、「[SSH を使用した開発環境への接続](devenvironment-connect-ssh.md)」を参照してください。
## 単一のサインオンアカウントを使用して CodeCatalyst にサインインすると、開発環境を作成できない
**問題:** 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)」を参照してください。
# IDE に関する問題のトラブルシューティング
CodeCatalyst の IDE に関連する問題のトラブルシューティングについては、次のセクションを参照してください。IDE の詳細については、「[IDE で開発環境を作成する](devenvironment-create.md#devenvironment-using-ide)」を参照してください。
**Topics**
+ [AWS Cloud9 でランタイムイメージのバージョンが一致しません](#troubleshooting-devenvironments-c9-runtime)
+ [AWS Cloud9 の `/projects/projects` でファイルにアクセスできない](#troubleshooting-devenvironments-c9-filesystem)
+ [カスタム devfile を使用して AWS Cloud9 で開発環境を起動できない](#troubleshooting-devenvironments-c9-image)
+ [AWS Cloud9 で問題が発生する](#troubleshooting-c9)
+ [JetBrains で CodeCatalyst を使用して開発環境に接続できない](#troubleshooting-jetbrains-connect)
+ [IDE に AWS Toolkit をインストールできない](#troubleshooting-ide-toolkit)
+ [IDE で開発環境を起動できない](#troubleshooting-ide-launch)
## AWS Cloud9 でランタイムイメージのバージョンが一致しません
AWS Cloud9 は、フロントエンドアセットとバックエンドランタイムイメージの異なるバージョンを使用しています。異なるバージョンを使用すると、Git 拡張機能と AWS Toolkit が正しく動作しない可能性があります。問題を解決するには、開発環境ダッシュボードに移動し、開発環境を停止してから、再度起動します。API 使用して問題を修正し、`UpdateDevEnvironment` API を使用してランタイムを更新します。詳細については、「*Amazon CodeCatalyst API リファレンス*」の「[UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html)」を参照してください。
## AWS Cloud9 の `/projects/projects` でファイルにアクセスできない
AWS Cloud9 エディタは、ディレクトリ「`/projects/projects`」内のファイルにアクセスできません。問題を解決するには、AWS Cloud9 ターミナルを使用してファイルにアクセスするか、別のディレクトリに移動します。
## カスタム devfile を使用して AWS Cloud9 で開発環境を起動できない
devfile イメージが AWS Cloud9 と互換性がない可能性があります。問題を解決するには、リポジトリと、対応する開発環境から devfile を確認し、新しい devfile を作成して続行します。
## AWS Cloud9 で問題が発生する
その他の問題については、「[AWS Cloud9 ユーザーガイド](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html)」のトラブルシューティングセクションを参照してください。
## JetBrains で CodeCatalyst を使用して開発環境に接続できない
問題を解決するには、最新バージョンの JetBrains のみがインストールされていることを確認します。複数のバージョンがある場合は、古いバージョンをアンインストールし、IDE とブラウザを閉じてプロトコルハンドラーを再登録します。次に JetBrains を開き、プロトコルハンドラーを再登録します。
## IDE に AWS Toolkit をインストールできない
VS Code のこの問題を修正するには、[[GitHub]](https://github.com/aws/aws-toolkit-vscode/releases) から手動で AWS Toolkit for Visual Studio Code をインストールします。
JetBrains のこの問題を修正するには、[[GitHub]](https://github.com/aws/aws-toolkit-jetbrains/releases) から手動で AWS Toolkit for JetBrains をインストールします。
## IDE で開発環境を起動できない
VS Code のこの問題を修正するには、最新バージョンの VS Code と AWS Toolkit for Visual Studio Code がインストールされていることを確認します。最新バージョンがない場合は、開発環境を更新して起動します。詳細については、「[VS Code 用の Amazon CodeCatalyst](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html)」ユーザーガイドを参照してください。
JetBrains のこの問題を修正するには、最新バージョンの JetBrains と AWS Toolkit for JetBrains がインストールされていることを確認します。最新バージョンがない場合は、開発環境を更新して起動します。詳細については、「[JetBrains 用の Amazon CodeCatalyst](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html)」ユーザーガイドを参照してください。
# devfiles に関する問題のトラブルシューティング
CodeCatalyst の devfiles に関連する問題のトラブルシューティングについては、次のセクションを参照してください。devfiles の詳細については、「[開発環境に devfile を設定](devenvironment-devfile.md)」を参照してください。
**Topics**
+ [カスタム devfile にカスタムイメージを実装したにもかかわらず、開発環境はデフォルトのユニバーサル devfile を使用しています](#troubleshooting-devenvironments-custom-image)
+ [プロジェクトがデフォルトのユニバーサル devfile を使用して開発環境にビルドされていない](#troubleshooting-devenvironments-default-image)
+ [開発環境のリポジトリ devfile を移動したい](#troubleshooting-devenvironments-devfile-moving)
+ [devfile の開始時に問題が発生しています](#troubleshooting-devenvironments-devfile-recovery)
+ [devfile のステータスを確認する方法がわからない](#troubleshooting-devenvironments-devfile-status)
+ [devfile が最新のイメージで提供されているツールと互換性がない](#troubleshooting-devenvironments-devfile-version)
## カスタム devfile にカスタムイメージを実装したにもかかわらず、開発環境はデフォルトのユニバーサル devfile を使用しています
カスタム devfile を使用している開発環境の起動中に CodeCatalyst でエラーが発生した場合、開発環境はデフォルトでデフォルトのユニバーサル devfile になります。問題を解決するには、`/aws/mde/logs/devfile.log` のログで正確なエラーを確認できます。ログ「`/aws/mde/logs/devfileCommand.log`」で `postStart` 実行が成功したかどうかを確認することもできます。
## プロジェクトがデフォルトのユニバーサル devfile を使用して開発環境にビルドされていない
問題を解決するには、カスタム devfile を使用していないことを確認します。カスタム devfile を使用していない場合は、プロジェクトのソースリポジトリにある `devfile.yaml` ファイルを表示して、エラーを見つけて修正します。
## 開発環境のリポジトリ devfile を移動したい
`/projects/devfile.yaml` のデフォルトの devfile をソースコードリポジトリに移動できます。devfile の場所を更新するには、コマンド「`/aws/mde/mde start --location repository-name/devfile.yaml`」を使用します。
## devfile の開始時に問題が発生しています
devfile の開始に問題がある場合、復旧モードになり、環境に接続して devfile を修正できます。リカバリモードの間、`/aws/mde/mde status` の実行には devfile の場所は含まれません。
```
{
"status": "STABLE"
}
```
`/aws/mde/logs` のログでエラーを確認し、devfile を修正して、もう一度 `/aws/mde/mde start` を実行してみてください。
## devfile のステータスを確認する方法がわからない
devfile のステータスを確認するには、`/aws/mde/mde status` を実行します。このコマンドを実行すると、次のいずれかが表示されます。
+ `{"status": "STABLE", "location": "devfile.yaml" }`
これは、devfile が正しいことを示します。
+ `{"status": "STABLE" }`
これは、devfile が起動できず、復旧モードになったことを示します。
`/aws/mde/logs/devfile.log` のログで正確なエラーを確認できます。
ログ「`/aws/mde/logs/devfileCommand.log`」で `postStart` 実行が成功したかどうかを確認することもできます。
詳細については、「[開発環境のユニバーサル devfile イメージの指定](devenvironment-universal-image.md)」を参照してください。
## devfile が最新のイメージで提供されているツールと互換性がない
開発環境では、特定のプロジェクトに必要なツーリングが `latest` ツーリングにない場合、`devfile` または `devfile postStart` が失敗する可能性があります。問題を解決するには、以下を実行します。
1. devfile に移動します。
1. devfile で、`latest` ではなく粒度の細かいイメージバージョンに更新します。具体的には、次のようになります。
```
components:
- container:
image: public.ecr.aws/amazonlinux/universal-image:1.0
```
1. 更新された devfile を使用して新しい開発環境を作成します。