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

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

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

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 を使用しています
<a name="troubleshooting-devenvironments-custom-image"></a>

カスタム devfile を使用している開発環境の起動中に CodeCatalyst でエラーが発生した場合、開発環境はデフォルトでデフォルトのユニバーサル devfile になります。問題を解決するには、`/aws/mde/logs/devfile.log` のログで正確なエラーを確認できます。ログ「`/aws/mde/logs/devfileCommand.log`」で `postStart` 実行が成功したかどうかを確認することもできます。

## プロジェクトがデフォルトのユニバーサル devfile を使用して開発環境にビルドされていない
<a name="troubleshooting-devenvironments-default-image"></a>

問題を解決するには、カスタム devfile を使用していないことを確認します。カスタム devfile を使用していない場合は、プロジェクトのソースリポジトリにある `devfile.yaml` ファイルを表示して、エラーを見つけて修正します。

## 開発環境のリポジトリ devfile を移動したい
<a name="troubleshooting-devenvironments-devfile-moving"></a>

`/projects/devfile.yaml` のデフォルトの devfile をソースコードリポジトリに移動できます。devfile の場所を更新するには、コマンド「`/aws/mde/mde start --location repository-name/devfile.yaml`」を使用します。

## devfile の開始時に問題が発生しています
<a name="troubleshooting-devenvironments-devfile-recovery"></a>

devfile の開始に問題がある場合、復旧モードになり、環境に接続して devfile を修正できます。リカバリモードの間、`/aws/mde/mde status` の実行には devfile の場所は含まれません。

```
{
    "status": "STABLE"
}
```

`/aws/mde/logs` のログでエラーを確認し、devfile を修正して、もう一度 `/aws/mde/mde start` を実行してみてください。

## devfile のステータスを確認する方法がわからない
<a name="troubleshooting-devenvironments-devfile-status"></a>

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 が最新のイメージで提供されているツールと互換性がない
<a name="troubleshooting-devenvironments-devfile-version"></a>

開発環境では、特定のプロジェクトに必要なツーリングが `latest` ツーリングにない場合、`devfile` または `devfile postStart` が失敗する可能性があります。問題を解決するには、以下を実行します。<a name="devenvironment-devfile-version"></a>

1. devfile に移動します。

1. devfile で、`latest` ではなく粒度の細かいイメージバージョンに更新します。具体的には、次のようになります。

   ```
   components:
     - container:
         image: public.ecr.aws/amazonlinux/universal-image:1.0
   ```

1. 更新された devfile を使用して新しい開発環境を作成します。