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)
+ [Single Sign-On 계정을 사용하여 CodeCatalyst에 로그인할 때는 개발 환경을 생성할 수 없습니다.](#troubleshoot-create-dev-env-idprovider)
+ [IDE 문제 해결](devenvironments-troubleshooting-ides.md)
+ [devfile 문제 해결](devenvironments-devenvironments-devfile.md)
## 할당량 문제로 인해 내 개발 환경 생성에 실패했습니다.
**문제:** CodeCatalyst에서 개발 환경을 생성하려고 하지만 오류가 발생했습니다. 콘솔의 개발 환경 페이지에 스페이스의 스토리지 한도에 도달했다는 메시지가 표시됩니다.
**가능한 수정 사항:** 프로젝트 또는 스페이스에서의 역할에 따라 하나 이상의 자체 개발 환경을 삭제하거나, 스페이스 관리자 역할이 있는 경우 다른 사용자가 생성한 미사용 개발 환경을 삭제할 수 있습니다. 또한 청구 계층을 더 많은 스토리지가 포함된 계층으로 변경할 수도 있습니다.
+ 스토리지 한도를 보려면 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 액세스** 모달에서 첫 번째 명령을 다시 실행합니다. 자세한 내용은 [SSH를 사용하여 개발 환경에 연결](devenvironment-connect-ssh.md) 단원을 참조하십시오.
## `codecatalyst` 프로파일에 AWS Config 대한에 문제가 있어 SSH를 통해 개발 환경에 연결할 수 없습니다.
`codecatalyst` 프로필의 AWS Config (`~/.aws/config`)가에 설명된 것과 일치하는지 확인합니다[CodeCatalyst AWS CLI 에서를 사용하도록 설정](set-up-cli.md). 그렇지 않은 경우 `codecatalyst`의 프로파일을 삭제하고 **SSH 액세스** 모달에서 첫 번째 명령을 다시 실행합니다. 자세한 내용은 [SSH를 사용하여 개발 환경에 연결](devenvironment-connect-ssh.md) 섹션을 참조하세요.
## Single Sign-On 계정을 사용하여 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 제공업체로 사용되는 스페이스의 사용자는 개발 환경을 사용할 수 없습니다. 스페이스 관리자는 대체 ID 제공업체를 사용하여 IAM Identity Center와 같은 개발 환경에 액세스할 수 있습니다. ID 페더레이션을 지원하는 스페이스 계획에 대한 자세한 내용은 *CodeCatalyst 관리자 안내서*의 [ID 페더레이션을 지원하는 스페이스 계획](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation)을 참조하세요.