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

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

# 소스 리포지토리 문제 해결
<a name="troubleshooting-source"></a>

다음 정보는 CodeCatalyst의 소스 리포지토리와 관련된 일반적인 문제 해결에 도움이 될 수 있습니다.

**Topics**
+ [내 스페이스의 스토리지가 최대 용량에 도달하여 경고 또는 오류가 표시됩니다](#source-troubleshoot-storage)
+ [Amazon CodeCatalyst 소스 리포지토리를 복제하거나 푸시하려고 할 때 오류가 발생합니다.](#source-troubleshoot-clone)
+ [Amazon CodeCatalyst 소스 리포지토리를 커밋하거나 푸시하려고 할 때 오류가 발생합니다.](#source-troubleshoot-commit-code)
+ [프로젝트를 위한 소스 리포지토리가 필요합니다.](#source-troubleshoot-need-repository)
+ [소스 리포지토리가 완전히 새 것이지만 커밋이 포함되어 있습니다.](#source-troubleshoot-initial-commit)
+ [다른 브랜치를 기본 브랜치로 사용하겠습니다.](#source-troubleshoot-default-branch)
+ [풀 요청의 활동에 대한 이메일을 받고 있습니다.](#source-troubleshoot-repository-emails)
+ [개인 액세스 토큰(PAT)을 잊어버렸습니다.](#source-troubleshoot-forgot-pat)
+ [풀 요청에는 예상 변경 사항이 표시되지 않습니다.](#source-troubleshoot-pull-request-diff)
+ [풀 요청은 병합할 수 없음 상태를 표시합니다.](#source-troubleshoot-pull-request-not-mergeable)

## 내 스페이스의 스토리지가 최대 용량에 도달하여 경고 또는 오류가 표시됩니다
<a name="source-troubleshoot-storage"></a>

**문제:** CodeCatalyst에서 하나 이상의 소스 리포지토리에 코드를 커밋하려고 하지만 오류가 표시됩니다. 콘솔의 소스 리포지토리 페이지에 스페이스의 스토리지 한도에 도달했다는 메시지가 표시됩니다.

**가능한 해결 방법:** 프로젝트 또는 스페이스의 역할에 따라 소스 리포지토리 중 하나 이상의 크기를 줄이거나, 사용하지 않는 소스 리포지토리를 삭제하거나, 청구 계층을 스토리지가 더 많은 계층으로 변경할 수 있습니다.
+ 프로젝트의 소스 리포지토리 크기를 줄이려면 사용하지 않는 브랜치를 삭제할 수 있습니다. 자세한 내용은 [브랜치 삭제](source-branches-delete.md) 및 [기고자 역할](ipa-role-types.md#ipa-role-contributor) 섹션을 참조하세요.
+ 스페이스의 전체 스토리지를 줄이려면 미사용 소스 리포지토리를 삭제할 수 있습니다. 자세한 내용은 [소스 리포지토리 삭제](source-repositories-delete.md) 및 [프로젝트 관리자 역할](ipa-role-types.md#ipa-role-project-admin) 섹션을 참조하세요.
+ 스페이스에 사용할 수 있는 스토리지 양을 늘리려면 청구 계층을 스토리지가 더 많은 계층으로 변경할 수 있습니다. 자세한 내용은 Amazon CodeCatalyst 관리자 안내서의 [Changing your CodeCatalyst billing tier](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-change-plan.html)를 참조하세요.

## Amazon CodeCatalyst 소스 리포지토리를 복제하거나 푸시하려고 할 때 오류가 발생합니다.
<a name="source-troubleshoot-clone"></a>

**문제:** 로컬 컴퓨터 또는 통합 개발 환경(IDE)에 소스 리포지토리를 복제하려고 하면 권한 오류가 발생합니다.

**수정 방법:** AWS Builder ID에 대한 개인 액세스 토큰(PAT)이 없거나, 자격 증명 관리 시스템을 PAT로 구성하지 않았거나, PAT가 만료되었을 수 있습니다. 다음 해결 방법 중 하나 이상을 시도해 보세요.
+ 개인용 액세스 토큰(PAT)을 생성합니다. 자세한 내용은 [개인 액세스 토큰을 사용하여 사용자 리포지토리 액세스 권한 부여](ipa-tokens-keys.md) 섹션을 참조하세요.
+ 소스 리포지토리가 포함된 프로젝트에 초대를 수락했는지, 그리고 그 프로젝트의 멤버인지 확인합니다. 해당 프로젝트의 활성 멤버가 아닌 경우 소스 리포지토리를 복제할 수 없습니다. 콘솔에 로그인하여 소스 리포지토리를 복제하려는 스페이스과 프로젝트로 이동합니다. 스페이스의 프로젝트 목록에서 프로젝트를 볼 수 없는 경우 해당 프로젝트의 멤버가 아니거나 해당 프로젝트에 대한 초대를 수락하지 않은 것입니다. 자세한 내용은 [초대 수락 및 AWS Builder ID 생성](sign-up-sign-in.md) 단원을 참조하십시오.
+ 복제 명령의 형식이 올바르고 AWS Builder ID가 포함되어 있는지 확인합니다. 예제:

  ```
  https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo
  ```
+  AWS CLI 를 사용하여 AWS Builder ID와 연결된 PAT가 있고 만료되지 않았는지 확인합니다. PAT가 없거나 PAT가 만료된 경우 PAT를 생성합니다. 자세한 내용은 [개인 액세스 토큰을 사용하여 사용자 리포지토리 액세스 권한 부여](ipa-tokens-keys.md) 섹션을 참조하세요.
+ 소스 리포지토리의 코드를 로컬 리포지토리나 IDE에 복제하는 대신 개발 환경을 만들어서 작업해 봅니다. 자세한 내용은 [개발 환경 생성](devenvironment-create.md) 섹션을 참조하세요.

## Amazon CodeCatalyst 소스 리포지토리를 커밋하거나 푸시하려고 할 때 오류가 발생합니다.
<a name="source-troubleshoot-commit-code"></a>

**문제:** 소스 리포지토리로 푸시하려고 하면 권한 오류가 발생합니다.

**가능한 해결 방법:** 프로젝트에 코드 변경을 커밋하고 푸시할 수 있는 역할이 없을 수 있습니다. 소스 리포지토리에 변경 사항을 푸시하려는 프로젝트에서 역할을 봅니다. 자세한 내용은 [멤버 및 해당 프로젝트 역할 목록 가져오기](projects-members.md#projects-members-view) 및 [사용자 역할로 액세스 권한 부여](ipa-roles.md) 섹션을 참조하세요.

변경 사항을 커밋하고 푸시할 수 있는 역할을 가지고 있다면, 변경 사항을 커밋하려는 브랜치에 코드 변경 사항을 푸시하지 못하도록 하는 브랜치 규칙이 설정되어 있을 수 있습니다. 대신 브랜치를 생성하고 코드를 해당 브랜치로 푸시해 봅니다. 자세한 내용은 [브랜치 규칙을 사용하여 브랜치에 대한 작업 관리](source-branches-branch-rules.md) 섹션을 참조하세요.

## 프로젝트를 위한 소스 리포지토리가 필요합니다.
<a name="source-troubleshoot-need-repository"></a>

**문제:** 프로젝트에 소스 리포지토리가 없거나 프로젝트에 다른 소스 리포지토리가 필요합니다.

**가능한 해결 방법:** 일부 프로젝트는 리소스 없이 생성됩니다. 프로젝트의 멤버인 경우 CodeCatalyst에서 해당 프로젝트에 대한 소스 리포지토리를 생성할 수 있습니다. **스페이스 관리자** 역할을 가진 사람이 **GitHub 리포지토리**를 설치하고 GitHub 계정에 연결하는 경우**프로젝트 관리자** 역할이 있는 경우 사용 가능한 GitHub 리포지토리에 연결하여 프로젝트에 추가할 수 있습니다. 자세한 내용은 [Creating a source repository](source-repositories-create.md) 및 [Linking a source repository](source-repositories-link.md)를 참조하세요.

## 소스 리포지토리가 완전히 새 것이지만 커밋이 포함되어 있습니다.
<a name="source-troubleshoot-initial-commit"></a>

**문제:** 소스 리포지토리를 방금 생성했습니다. 비어 있어야 하지만 커밋, 브랜치 및 `README.md` 파일이 있어야 합니다.

**가능한 해결 방법:** 정상적인 동작입니다. CodeCatalyst의 모든 소스 리포지토리에는 기본 브랜치를 `main`으로 설정하는 초기 커밋이 포함되어 있으며, 샘플 코드(해당 리포지토리가 샘플 코드를 포함하는 블루프린트를 사용하는 프로젝트를 위해 생성된 경우) 또는 리포지토리 README 파일에 대한 템플릿 마크다운 파일이 포함되어 있습니다. 콘솔 및 Git 클라이언트에서 추가 브랜치를 생성할 수 있습니다. 콘솔에서 파일을 생성 및 편집하고 개발 환경 및 Git 클라이언트에서 파일을 삭제할 수 있습니다.

## 다른 브랜치를 기본 브랜치로 사용하겠습니다.
<a name="source-troubleshoot-default-branch"></a>

**문제:** 소스 리포지토리에는 `main`이라는 기본 브랜치가 있지만 다른 브랜치를 기본 브랜치로 사용하려고 합니다.

**가능한 해결 방법:** CodeCatalyst의 소스 리포지토리에서 기본 브랜치를 변경하거나 삭제할 수 없습니다. 추가 브랜치를 생성하고 워크플로의 소스 작업에서 해당 브랜치를 사용할 수 있습니다. GitHub 리포지토리를 연결하여 프로젝트의 리포지토리로 사용하도록 선택할 수도 있습니다.

## 풀 요청의 활동에 대한 이메일을 받고 있습니다.
<a name="source-troubleshoot-repository-emails"></a>

**문제:** 풀 요청 활동에 대한 이메일 알림을 등록하거나 구성하지 않았지만 어쨌든 수신하고 있습니다.

**가능한 해결 방법:** 풀 요청 활동에 대한 이메일 알림이 자동으로 전송됩니다. 자세한 내용은 [Amazon CodeCatalyst에서 풀 요청을 사용하여 코드 검토](source-pull-requests.md) 섹션을 참조하세요.

## 개인 액세스 토큰(PAT)을 잊어버렸습니다.
<a name="source-troubleshoot-forgot-pat"></a>

**문제:** 소스 리포지토리의 코드를 복제, 푸시 및 가져오는 데 PAT를 사용했지만 토큰의 값을 잃어 CodeCatalyst 콘솔에서 찾을 수 없습니다.

**가능한 해결 방법:** 이 문제를 해결하는 가장 빠른 방법은 다른 PAT를 생성하고 이 새 PAT를 사용하도록 자격 증명 관리자 또는 IDE를 구성하는 것입니다. PAT는 생성할 때만 표시됩니다. 이 값을 잃으면 검색할 수 없습니다. 자세한 내용은 [개인 액세스 토큰을 사용하여 사용자 리포지토리 액세스 권한 부여](ipa-tokens-keys.md) 섹션을 참조하세요.

## 풀 요청에는 예상 변경 사항이 표시되지 않습니다.
<a name="source-troubleshoot-pull-request-diff"></a>

**문제:** 풀 요청을 생성했지만 소스 브랜치와 대상 브랜치 간에 예상되는 변경 사항이 보이지 않습니다.

**가능한 해결 방법:** 이는 여러 가지 문제로 인해 발생할 수 있습니다. 다음 해결 방법 중 하나 이상을 시도해 보세요.
+ 이전 개정 간의 변경 사항을 검토하거나 최신 변경 사항을 확인하지 못할 수 있습니다. 브라우저를 새로 고치고 보려는 개정 간의 비교를 선택했는지 확인합니다.
+ 콘솔에 풀 요청의 모든 변경 사항을 표시할 수 있는 것은 아닙니다. 예를 들어, 콘솔에서 Git 하위 모듈을 볼 수 없으므로 풀 요청에서 하위 모듈의 차이를 볼 수 없습니다. 일부 차이는 표시하기에 너무 클 수 있습니다. 자세한 내용은 [CodeCatalyst의 소스 리포지토리 할당량](source-quotas.md) 및 [파일 보기파일 변경 내역 보기](source-files-view.md) 섹션을 참조하세요.
+ 풀 요청은 병합 기반과 선택한 개정 간의 차이를 표시합니다. 풀 요청을 생성할 때 표시되는 차이는 소스 브랜치의 팁과 대상 브랜치의 팁 간의 차이입니다. 풀 요청이 생성되면 표시된 차이는 개정과 병합 기반 간에 발생합니다. 병합 기반은 개정이 생성될 때 대상 브랜치의 팁인 커밋입니다. 병합 기반은 개정 간에 변경될 수 있습니다. Git의 차이점 및 병합 기반에 대한 자세한 내용은 Git 설명서의 [git-merge-base](https://git-scm.com/docs/git-merge-base)를 참조하세요.

## 풀 요청은 병합할 수 없음 상태를 표시합니다.
<a name="source-troubleshoot-pull-request-not-mergeable"></a>

**문제:** 풀 요청을 병합하려고 하지만 상태가 **병합할 수 없음**으로 표시됩니다.

**가능한 해결 방법:** 하나 이상의 문제로 인해 발생할 수 있습니다.
+ 풀 요청에 필요한 모든 검토자는 풀 요청을 승인해야 병합할 수 있습니다. 이름 옆에 시계 아이콘이 있는 모든 검토자의 필수 검토자 목록을 검토합니다. 시계 아이콘은 검토자가 풀 요청을 승인하지 않았음을 나타냅니다.
**참고**  
풀 요청을 승인하기 전에 프로젝트에서 필수 검토자를 제거한 경우 풀 요청을 병합할 수 없습니다. 풀 요청을 닫고 새 풀 요청을 생성합니다.
+ 소스 브랜치와 대상 브랜치 간에 병합 충돌이 발생할 수 있습니다. CodeCatalyst는 가능한 모든 Git 병합 전략 및 옵션을 지원하지 않습니다. 개발 환경에서 병합 충돌에 대해 브랜치를 평가하거나 리포지토리를 복제하고 IDE 또는 Git 도구를 사용하여 병합 충돌을 찾아 해결할 수 있습니다. 자세한 내용은 [풀 요청 병합](pull-requests-merge.md) 섹션을 참조하세요.