

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

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

# 소스 리포지토리 연결
<a name="source-repositories-link"></a>

소스 리포지토리를 프로젝트에 연결할 때 리포지토리를 호스팅하는 서비스에 대해 CodeCatalyst 확장 프로그램이 설치되어 있는 경우 해당 확장 프로그램이 있는 리포지토리를 포함할 수 있습니다(해당 스페이스에 대해 해당 확장 프로그램이 설치되어 있는 경우). 스페이스 관리자 역할을 가진 사용자만 확장 프로그램을 설치할 수 있습니다. 확장 프로그램이 설치되면 해당 확장 프로그램에서 액세스하도록 구성된 리포지토리에 연결할 수 있습니다. 자세한 내용은 [스페이스에 확장 프로그램 설치](install-extension.md) 섹션을 참조하거나 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결](extensions-link.md)를 따르세요.

**중요**  
리포지토리 확장 프로그램을 설치한 후 CodeCatalyst에 연결하는 모든 리포지토리의 코드가 CodeCatalyst에 인덱싱 및 저장됩니다. 이렇게 하면 CodeCatalyst에서 코드를 검색할 수 있습니다. CodeCatalyst에서 연결된 리포지토리를 사용할 때 코드에 대한 데이터 보호를 더 잘 이해하려면 *Amazon CodeCatalyst 사용 설명서*의 [데이터 보호](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)를 참조하세요.

리포지토리를 한 스페이스에 있는 하나의 프로젝트에만 연결할 수 있습니다. 아카이브된 리포지토리는 연결할 수 없습니다. 빈 리포지토리를 연결할 수는 있지만 기본 브랜치를 만드는 초기 커밋으로 초기화하기 전까지는 CodeCatalyst에서 리포지토리를 사용할 수 없습니다. 뿐만 아니라 
+ GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리는 한 스페이스에서 하나의 CodeCatalyst 프로젝트에만 연결할 수 있습니다.
+ 비어있거나 보관된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 CodeCatalyst 프로젝트와 함께 사용할 수 없습니다.
+ CodeCatalyst 프로젝트의 리포지토리와 이름이 동일한 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 연결할 수 없습니다.
+ **GitHub 리포지토리** 확장 프로그램은 GitHub Enterprise Server 리포지토리와 호환되지 않습니다.
+ **Bitbucket 리포지토리** 확장 프로그램은 Bitbucket Data Center 리포지토리와 호환되지 않습니다.
+ **GitLab 리포지토리** 확장 프로그램은 GitLab 자체 관리형 프로젝트 리포지토리와 호환되지 않습니다.
+ 연결된 리포지토리에서는 **설명 쓰기** 또는 **설명 요약** 기능을 사용할 수 없습니다. 이러한 기능은 CodeCatalyst의 풀 요청에서만 사용할 수 있습니다.

GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 **기고자**로 연결할 수 있지만 타사 리포지토리를 **스페이스 관리자** 또는 **프로젝트 관리자**로서만 연결 해제할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결 해제](extensions-unlink.md) 섹션을 참조하세요.

**중요**  
CodeCatalyst는 연결된 리포지토리에 대한 기본 브랜치의 변경 사항 감지를 지원하지 않습니다. 연결된 리포지토리의 기본 브랜치를 변경하려면 먼저 CodeCatalyst에서 연결을 해제하고 기본 브랜치를 변경한 다음 다시 연결해야 합니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결](extensions-link.md) 섹션을 참조하세요.  
리포지토리를 연결하기 전에 항상 최신 버전의 확장 프로그램을 사용하는 것이 좋습니다.

**소스 리포지토리 연결**

1. 리포지토리를 연결하려는 프로젝트로 이동합니다.
**참고**  
리포지토리를 연결하려면 먼저 스페이스 관리자 역할이 있는 사용자가 리포지토리를 호스팅하는 제공업체의 확장 프로그램을 설치해야 합니다. 자세한 내용은 [스페이스에 확장 프로그램 설치](install-extension.md) 섹션을 참조하세요.

1. 탐색 창에서 **코드**를 선택한 다음 **소스 리포지토리**를 선택합니다.

1. **리포지토리 추가**를 선택하고 **리포지토리 연결**을 선택합니다.

1. **리포지토리 공급자** 드롭다운 메뉴에서 다음 타사 리포지토리 공급자 중 하나를 선택합니다. **GitHub** 또는 **Bitbucket**

1. 연결하도록 선택한 타사 리포지토리 공급자에 따라 다음 중 하나를 수행합니다.
   + **GitHub 리포지토리**: GitHub 리포지토리를 연결합니다.

     1. **GitHub 계정** 드롭다운 메뉴에서 연결할 리포지토리가 포함된 GitHub 계정을 선택합니다.

     1. **GitHub 리포지토리** 드롭다운 메뉴에서 CodeCatalyst 프로젝트를 연결할 GitHub 계정을 선택합니다.

     1. (선택 사항) 리포지토리 목록에 GitHub 리포지토리가 표시되지 않는 경우 GitHub의 Amazon CodeCatalyst 애플리케이션에서 리포지토리 액세스에 대해 구성되지 않았을 수 있습니다. 연결된 계정의 CodeCatalyst에서 사용할 수 있는 GitHub 리포지토리를 구성할 수 있습니다.

        1. [GitHub](https://github.com/) 계정으로 이동하여 **설정**을 선택한 다음 **애플리케이션**을 선택합니다.

        1. **설치된 GitHub 앱** 탭에서 Amazon CodeCatalyst 애플리케이션에 대해 **구성**을 선택합니다.

        1. 다음 중 하나를 수행하여 CodeCatalyst에서 연결하려는 GitHub 리포지토리의 액세스를 구성합니다.
           + 모든 현재 및 향후 리포지토리에 대한 액세스를 제공하려면 **모든 리포지토리**를 선택합니다.
           + 특정 리포지토리에 대한 액세스 권한을 제공하려면 **선택된 리포지토리만**을 선택하고 **리포지토리 선택** 드롭다운을 선택한 다음 CodeCatalyst에서 연결할 수 있도록 허용할 리포지토리를 선택합니다.
   + **Bitbucket 리포지토리:** Bitbucket 리포지토리를 연결합니다.

     1. **Bitbucket 작업 영역** 드롭다운 메뉴에서 연결하려는 리포지토리가 포함된 Bitbucket 작업 영역을 선택합니다.

     1. **Bitbucket 리포지토리** 드롭다운 메뉴에서 CodeCatalyst 프로젝트를 연결할 Bitbucket 리포지토리를 선택합니다.
**작은 정보**  
리포지토리 이름이 회색으로 표시된 경우 Amazon CodeCatalyst 의 다른 프로젝트에 이미 연결되어 있으므로 해당 리포지토리를 연결할 수 없습니다.

1. **연결**을 선택합니다.

CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 더 이상 사용하지 않으려면 CodeCatalyst 프로젝트에서 연결을 해제할 수 있습니다. 리포지토리가 연결 해제되면 해당 리포지토리의 이벤트는 워크플로를 시작하지 않으며 CodeCatalyst 개발 환경에서 해당 리포지토리를 사용할 수 없습니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결 해제](extensions-unlink.md) 섹션을 참조하세요.