Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# devfile 문제 해결
<a name="devenvironments-devenvironments-devfile"></a>

CodeCatalyst의 devfile과 관련된 문제를 해결하려면 다음 섹션을 참조하세요. devfile에 대한 자세한 내용은 [개발 환경용 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>

`/aws/mde/mde status`를 실행하여 devfile 상태를 확인할 수 있습니다. 이 명령을 실행한 후 다음 중 하나가 표시될 수 있습니다.
+ `{"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>

개발 환경에서 `devfile` 또는 `devfile postStart`는 `latest` 도구에 특정 프로젝트에 필요한 도구가 없는 경우 실패할 수 있습니다. 문제를 해결하려면 다음을 수행합니다.<a name="devenvironment-devfile-version"></a>

1. devfile로 이동합니다.

1. devfile에서 `latest` 대신 세분화된 이미지 버전으로 업데이트합니다. 내용은 다음처럼 보일 것입니다.

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

1. 업데이트된 devfile을 사용하여 새 개발 환경을 생성합니다.