

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

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

# CodeCatalyst에서 확장 프로그램이 있는 프로젝트에 기능 추가
<a name="extensions"></a>

Amazon CodeCatalyst에는 기능을 추가하고 CodeCatalyst 외부의 제품과 통합하는 데 도움이 되는 확장 프로그램이 포함되어 있습니다. CodeCatalyst 카탈로그의 확장 프로그램을 통해 팀은 CodeCatalyst에서 경험을 사용자 지정할 수 있습니다.

**Topics**
+ [사용 가능한 타사 확장](#extensions-types)
+ [확장 프로그램 개념](extensions-concepts.md)
+ [빠른 시작: CodeCatalyst에서 확장 프로그램 설치, 공급자 연결 및 리소스 연결](extensions-quickstart.md)
+ [스페이스에 확장 프로그램 설치](install-extension.md)
+ [스페이스에 확장 프로그램 제거](uninstall-extension.md)
+ [GitHub 계정, Bitbucket 작업 영역, GitLab 사용자 및 Jira 사이트 CodeCatalyst 연결](extensions-connect.md)
+ [GitHub 계정, Bitbucket 작업 영역, GitLab 사용자 및 Jira 사이트 CodeCatalyst 연결 해제](extensions-disconnect.md)
+ [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결](extensions-link.md)
+ [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결 해제](extensions-unlink.md)
+ [CodeCatalyst에서 타사 리포지토리 보기 및 Jira 문제 검색](extensions-view-search.md)
+ [타사 리포지토리 이벤트 후 워크플로 실행 자동 시작](extensions-workflow-repositories.md)
+ [타사 리포지토리 공급자를 통한 IP 액세스 제한](extensions-restrict-ip-access.md)
+ [워크플로 실패 시 타사 병합 차단](extensions-block-merges.md)
+ [Jira 문제를 CodeCatalyst 풀 요청에 연결](link-jira-issues-pull-requests.md)
+ [Jira 문제에서 CodeCatalyst 이벤트 보기](view-codecatalyst-events-jira.md)

## 사용 가능한 타사 확장
<a name="extensions-types"></a>

리소스를 통합하도록 선택한 확장 프로그램에 따라 CodeCatalyst 프로젝트에 특정 기능을 추가할 수 있습니다.

### CodeCatalyst에 GitHub 리포지토리 통합
<a name="extensions-types-github"></a>

GitHub는 개발자가 코드를 저장하고 관리하는 데 도움이 되는 클라우드 기반 서비스입니다. **GitHub 리포지토리** 확장 프로그램을 사용하면 Amazon CodeCatalyst 프로젝트에서 연결된 GitHub 리포지토리를 사용할 수 있습니다. 새 CodeCatalyst 프로젝트를 생성할 때 GitHub 리포지토리를 연결할 수도 있습니다. 자세한 내용은 [연결된 타사 리포지토리를 사용하여 프로젝트 생성](projects-create.md#projects-create-3p-repo) 섹션을 참조하세요.

**참고**  
빈 GitHub 리포지토리 또는 아카이브된 GitHub 리포지토리를 CodeCatalyst 프로젝트와 함께 사용할 수 없습니다.
**GitHub 리포지토리** 확장 프로그램은 GitHub Enterprise Server 리포지토리와 호환되지 않습니다.

**GitHub 리포지토리** 확장 프로그램을 설치하고 구성하면 다음을 수행할 수 있습니다.
+ CodeCatalyst의 소스 리포지토리 목록에서 GitHub 리포지토리 보기
+ GitHub 리포지토리에 워크플로 정의 파일 저장 및 관리
+ CodeCatalyst 개발 환경에서 연결된 GitHub 리포지토리에 저장된 파일 생성, 읽기, 업데이트 및 삭제
+ CodeCatalyst에서 연결된 GitHub 리포지토리의 파일 저장 및 인덱싱
+ 연결된 GitHub 계정의 기존 리포지토리를 사용하여 CodeCatalyst 프로젝트 생성
+ 블루프린트로 프로젝트를 생성하거나 블루프린트를 추가할 때 블루프린트로 생성된 코드를 사용하여 GitHub 리포지토리 생성
+ 연결된 GitHub 리포지토리로 코드를 푸시하거나 연결된 GitHub 리포지토리에서 풀 요청이 생성, 수정 또는 종료될 때 CodeCatalyst 시작 워크플로가 자동으로 실행됩니다.
+ CodeCatalyst 워크플로에서 연결된 GitHub 리포지토리 소스 파일 사용
+ CodeCatalyst 워크플로에서 GitHub Actions 읽기 및 실행
+ CodeCatalyst 워크플로 실행 상태를 연결된 GitHub 리포지토리로 전송하고 커밋 상태에 따라 GitHub 풀 요청 병합 차단

### CodeCatalyst에 Bitbucket 리포지토리 통합
<a name="extensions-types-bitbucket"></a>

Bitbucket은 개발자가 코드를 저장하고 관리하는 데 도움이 되는 클라우드 기반 서비스입니다. **Bitbucket 리포지토리** 확장 프로그램을 사용하면 Amazon CodeCatalyst 프로젝트에서 연결된 Bitbucket 리포지토리를 사용할 수 있습니다. 새 CodeCatalyst 프로젝트를 생성할 때 Bitbucket 리포지토리를 연결할 수도 있습니다. 자세한 내용은 [연결된 타사 리포지토리를 사용하여 프로젝트 생성](projects-create.md#projects-create-3p-repo) 섹션을 참조하세요.

**참고**  
빈 또는 아카이브된 Bitbucket 리포지토리는 CodeCatalyst 프로젝트와 함께 사용할 수 없습니다.
**Bitbucket 리포지토리** 확장 프로그램은 Bitbucket Data Center 리포지토리와 호환되지 않습니다.

**Bitbucket 리포지토리** 확장 프로그램을 설치하고 구성하면 다음을 수행할 수 있습니다.
+ CodeCatalyst의 소스 리포지토리 목록에서 Bitbucket 리포지토리 보기
+ Bitbucket 리포지토리에 워크플로 정의 파일을 저장하고 관리합니다.
+ CodeCatalyst 개발 환경에서 연결된 Bitbucket 리포지토리에 저장된 파일 생성, 읽기, 업데이트 및 삭제
+ 연결된 Bitbucket 계정의 기존 리포지토리를 사용하여 CodeCatalyst 프로젝트 생성
+ CodeCatalyst의 연결된 Bitbucket 리포지토리에서 파일을 저장하고 인덱싱합니다.
+ 블루프린트로 프로젝트를 생성하거나 블루프린트를 추가할 때 블루프린트로 생성된 코드를 사용하여 Bitbucket 리포지토리 생성
+ 연결된 Bitbucket 리포지토리에 코드를 푸시하거나 연결된 Bitbucket 리포지토리에서 풀 요청이 생성, 수정 또는 종료될 때 CodeCatalyst 시작 워크플로가 자동으로 실행됩니다.
+ CodeCatalyst 워크플로에서 연결된 Bitbucket 리포지토리 소스 파일 사용
+ CodeCatalyst 워크플로 실행 상태를 연결된 Bitbucket 리포지토리로 전송하고 커밋 상태에 따라 Bitbucket 풀 요청 병합 차단

### CodeCatalyst에 GitLab 리포지토리 통합
<a name="extensions-types-gitlab"></a>

GitLab은 개발자가 코드를 저장하고 관리하는 데 도움이 되는 클라우드 기반 서비스입니다. **GitLab 리포지토리** 확장 프로그램을 사용하면 Amazon CodeCatalyst 프로젝트에서 연결된 GitLab 리포지토리를 사용할 수 있습니다. 새 CodeCatalyst 프로젝트를 생성할 때 GitLab 프로젝트 리포지토리를 연결할 수도 있습니다. 자세한 내용은 [연결된 타사 리포지토리를 사용하여 프로젝트 생성](projects-create.md#projects-create-3p-repo) 섹션을 참조하세요.

**참고**  
빈 GitLab 프로젝트 리포지토리는 CodeCatalyst 프로젝트와 함께 사용할 수 없습니다.
**GitLab 리포지토리** 확장 프로그램은 GitLab 자체 관리형 리포지토리와 호환되지 않습니다.

**GitLab 리포지토리** 확장 프로그램을 설치하고 구성하면 다음을 수행할 수 있습니다.
+ CodeCatalyst의 소스 리포지토리 목록에서 GitLab 프로젝트 리포지토리 보기
+ GitLab 프로젝트 리포지토리에 워크플로 정의 파일을 저장하고 관리합니다.
+ CodeCatalyst 개발 환경에서 연결된 GitLab 프로젝트 리포지토리에 저장된 파일 생성, 읽기, 업데이트 및 삭제
+ 연결된 GitLab 사용자의 기존 리포지토리를 사용하여 CodeCatalyst 프로젝트 생성
+ CodeCatalyst의 연결된 GitLab 프로젝트 리포지토리에서 파일을 저장하고 인덱싱합니다.
+ 블루프린트로 프로젝트를 생성하거나 블루프린트를 추가할 때 블루프린트로 생성된 코드를 사용하여 GitLab 프로젝트 리포지토리 생성
+ 연결된 GitLab 프로젝트 리포지토리에 코드를 푸시하거나 연결된 GitLab 프로젝트 리포지토리에서 풀 요청이 생성, 수정 또는 종료될 때 CodeCatalyst 시작 워크플로가 자동으로 실행됩니다.
+ CodeCatalyst 워크플로에서 연결된 GitLab 프로젝트 리포지토리 소스 파일 사용
+ CodeCatalyst 워크플로 실행 상태를 연결된 GitLab 프로젝트 리포지토리로 전송하고 커밋 상태에 따라 GitLab 병합 요청 차단

### CodeCatalyst에 Jira 문제 통합
<a name="extensions-types-jira"></a>

Jira는 애자일 개발 팀이 작업을 계획, 할당, 추적, 보고 및 관리할 수 있도록 지원하는 소프트웨어 애플리케이션입니다. **Jira 소프트웨어** 확장 프로그램을 사용하면 Amazon CodeCatalyst 프로젝트에서 Jira 프로젝트를 사용할 수 있습니다.

**참고**  
CodeCatalyst는 **Jira Software Cloud**와만 호환됩니다.

Amazon CodeCatalyst 프로젝트에 대한 **Jira 소프트웨어** 확장 프로그램을 설치하고 구성하면 다음을 수행할 수 있습니다.
+ CodeCatalyst 프로젝트와 연결하여 CodeCatalyst에서 Jira 프로젝트에 액세스
+ CodeCatalyst 풀 요청으로 Jira 문제 업데이트
+ Jira 문제에서 연결된 CodeCatalyst 풀 요청의 상태 및 워크플로 실행 보기

# 확장 프로그램 개념
<a name="extensions-concepts"></a>

다음은 CodeCatalyst에서 확장 프로그램 작업을 수행할 때 알아야 할 몇 가지 개념 및 용어입니다.

## 확장 프로그램
<a name="extensions-concepts-extensions"></a>

*확장 프로그램*은 CodeCatalyst 스페이스에 설치하여 프로젝트에 새 기능을 추가하고 CodeCatalyst 외부의 서비스와 통합할 수 있는 추가 기능입니다. 확장 프로그램은 CodeCatalyst 카탈로그에서 찾아보고 설치할 수 있습니다.

## CodeCatalyst 카탈로그
<a name="extensions-concepts-catalog"></a>

CodeCatalyst 카탈로그는 CodeCatalyst에서 사용할 수 있는 모든 확장 프로그램의 중앙 집중식 목록입니다. CodeCatalyst 카탈로그를 검색하여 소스, 워크플로 등과 같은 CodeCatalyst 영역에서 팀의 경험을 개선할 수 있는 확장 프로그램을 찾을 수 있습니다.

## 연결 및 링크
<a name="extensions-concepts-connect-link"></a>

사용하거나 관리하려는 타사 리소스에 따라 GitHub 계정, Bitbucket 작업 영역 또는 Jira 프로젝트를 연결해야 합니다. 그런 다음 GitHub 리포지토리, Bitbucket 리포지토리 또는 Jira 프로젝트를 CodeCatalyst 프로젝트에 링크해야 합니다.
+ **GitHub 리포지토리:** GitHub 계정을 연결한 다음 GitHub 리포지토리를 링크합니다.
+ **Bitbucket 리포지토리:** Bitbucket Work 스페이스를 연결한 다음 Bitbucket 리포지토리를 링크합니다.
+ **GitLab 리포지토리:** GitLab 사용자를 연결한 다음 GitLab 프로젝트 리포지토리를 링크합니다.
+ **Jira 소프트웨어**: Jira 사이트를 연결한 다음 Jira 프로젝트를 링크합니다.

# 빠른 시작: CodeCatalyst에서 확장 프로그램 설치, 공급자 연결 및 리소스 연결
<a name="extensions-quickstart"></a>

이 자습서에서는 다음 세 가지 작업에 대한 연습을 제공합니다.

1. **GitHub 리포지토리**, **Bitbucket 리포지토리**, **GitLab 리포지토리** 또는 **Jira 소프트웨어** 확장 프로그램을 설치합니다. 외부 사이트에서 CodeCatalyst에 연결하고 타사 리소스에 대한 액세스 권한을 제공하라는 메시지가 표시되며, 이는 다음 단계의 일부로 수행됩니다.
**중요**  
**GitHub 리포지토리**, **Bitbucket 리포지토리**, **GitLab 리포지토리** 또는 **Jira 소프트웨어** 확장 프로그램을 CodeCatalyst 스페이스에 설치하려면 해당 스페이스에 **스페이스 관리자** 역할이 있는 계정으로 로그인해야 합니다.

1. GitHub 계정, Bitbucket Work스페이스, GitLab 사용자 또는 Jira 사이트를 CodeCatalyst에 연결합니다.
**중요**  
GitHub 계정, Bitbucket Work 스페이스, GitLab 사용자 또는 Jira 사이트를 CodeCatalyst 스페이스에 연결하려면 타사 소스의 관리자와 CodeCatalyst **스페이스 관리자**여야 합니다.
**중요**  
리포지토리 확장 프로그램을 설치한 후 CodeCatalyst에 연결하는 모든 리포지토리의 코드가 CodeCatalyst에 인덱싱 및 저장됩니다. 이렇게 하면 CodeCatalyst에서 코드를 검색할 수 있습니다. CodeCatalyst에서 연결된 리포지토리를 사용할 때 코드에 대한 데이터 보호를 더 잘 이해하려면 *Amazon CodeCatalyst 사용 설명서*의 [데이터 보호](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)를 참조하세요.
**참고**  
GitHub 계정에 대한 연결을 사용하는 경우 개인 연결을 생성하여 CodeCatalyst ID와 GitHub ID 간에 ID 매핑을 설정해야 합니다. 자세한 내용은 [개인 연결](concepts.md#personal-connection-concept) 및 [개인 연결을 사용하여 GitHub 리소스에 액세스](ipa-settings-connections.md) 섹션을 참조하세요.

1. GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 또는 Jira 프로젝트를 CodeCatalyst 프로젝트에 연결합니다.
**중요**  
GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 **기고자**로 연결할 수 있지만 타사 리포지토리를 **스페이스 관리자** 또는 **프로젝트 관리자**로서만 연결 해제할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결 해제](extensions-unlink.md) 섹션을 참조하세요.
Jira 프로젝트를 CodeCatalyst 프로젝트에 연결하려면 CodeCatalyst **스페이스 관리자** 또는 CodeCatalyst **프로젝트 관리자**여야 합니다.
**중요**  
CodeCatalyst는 연결된 리포지토리에 대한 기본 브랜치의 변경 사항 감지를 지원하지 않습니다. 연결된 리포지토리의 기본 브랜치를 변경하려면 먼저 CodeCatalyst에서 연결을 해제하고 기본 브랜치를 변경한 다음 다시 연결해야 합니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결](extensions-link.md) 섹션을 참조하세요.  
리포지토리를 연결하기 전에 항상 최신 버전의 확장 프로그램을 사용하는 것이 좋습니다.
**참고**  
GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리는 한 스페이스에서 하나의 CodeCatalyst 프로젝트에만 연결할 수 있습니다.
비어있거나 보관된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 CodeCatalyst 프로젝트와 함께 사용할 수 없습니다.
CodeCatalyst 프로젝트의 리포지토리와 이름이 동일한 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 연결할 수 없습니다.
**GitHub 리포지토리** 확장 프로그램은 GitHub Enterprise Server 리포지토리와 호환되지 않습니다.
**Bitbucket 리포지토리** 확장 프로그램은 Bitbucket Data Center 리포지토리와 호환되지 않습니다.
**GitLab 리포지토리** 확장 프로그램은 GitLab 자체 관리형 프로젝트 리포지토리와 호환되지 않습니다.
연결된 리포지토리에서는 **설명 쓰기** 또는 **설명 요약** 기능을 사용할 수 없습니다. 이러한 기능은 CodeCatalyst의 풀 요청에서만 사용할 수 있습니다.
CodeCatalyst 프로젝트는 하나의 Jira 프로젝트에만 연결할 수 있습니다. Jira 프로젝트는 여러 CodeCatalyst 프로젝트에 연결할 수 있습니다.

또한 **GitHub 리포지토리**, **Bitbucket 리포지토리 **, **GitLab 리포지토리** 확장 프로그램을 설치하고, GitHub 계정, Bitbucket 작업 영역 또는 GitLab 사용자에 연결하고, 새 CodeCatalyst 프로젝트를 생성할 때 타사 리포지토리를 연결할 수 있습니다. 자세한 내용은 [연결된 타사 리포지토리를 사용하여 프로젝트 생성](projects-create.md#projects-create-3p-repo) 섹션을 참조하세요.

**Topics**
+ [1단계: CodeCatalyst 카탈로그에서 타사 확장 프로그램 설치](#extensions-quickstart-install)
+ [2단계: 타사 공급자를 CodeCatalyst 스페이스에 연결](#extensions-github-extension-get-started-connect)
+ [3단계: 타사 리소스를 CodeCatalyst 프로젝트에 연결](#extensions-quickstart-link)
+ [다음 단계](#extensions-quickstart-next-steps)

## 1단계: CodeCatalyst 카탈로그에서 타사 확장 프로그램 설치
<a name="extensions-quickstart-install"></a>

CodeCatalyst에서 타사 리소스를 사용하는 첫 번째 단계는 CodeCatalyst 카탈로그에서 **GitHub 리포지토리** 확장 프로그램을 설치하는 것입니다. 확장 프로그램을 설치하려면 다음 단계를 수행하여 사용하려는 타사 리소스의 확장 프로그램을 선택합니다. **GitHub 리포지토리**, **Bitbucket 리포지토리** 및 **GitLab 리포지토리**를 사용하면 CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 사용할 수 있습니다. **Jira 소프트웨어**를 사용하면 CodeCatalyst에서 Jira 문제를 관리할 수 있습니다.

**CodeCatalyst 카탈로그에서 확장 프로그램을 설치하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 스페이스로 이동합니다.

1. 상단 메뉴에서 **카탈로그** 아이콘 ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png)을 선택하여 CodeCatalyst 카탈로그로 이동합니다. **GitHub 리포지토리**, **Bitbucket 리포지토리**, **GitLab 리포지토리** 또는 **Jira 소프트웨어**를 검색할 수 있습니다. 범주를 기반으로 확장 프로그램을 필터링할 수도 있습니다.

1. (선택 사항) 확장 프로그램과 관련된 권한 등 확장 프로그램에 대한 자세한 내용을 보려면 확장 이름을 선택합니다.

1. **설치**를 선택합니다. 확장 프로그램에 필요한 권한을 검토하고 계속하려면 **설치**를 다시 선택합니다.

확장 프로그램을 설치하면 확장 프로그램 세부 정보 페이지로 이동합니다. 설치한 확장 프로그램에 따라 연결된 공급자와 연결된 리소스를 보고 관리할 수 있습니다.

## 2단계: 타사 공급자를 CodeCatalyst 스페이스에 연결
<a name="extensions-github-extension-get-started-connect"></a>

**GitHub 리포지토리**, **Bitbucket 리포지토리**, **GitLab 리포지토리** 또는 **Jira 소프트웨어** 확장 프로그램을 설치한 후 다음 단계는 GitHub 계정, Bitbucket 작업 영역, GitLab 프로젝트 리포지토리 또는 Jira 사이트를 CodeCatalyst 스페이스에 연결하는 것입니다.

**GitHub 계정, Bitbucket Work 스페이스, Jira 사이트를 CodeCatalyst에 연결하려면**
+ 설치한 타사 확장 프로그램에 따라 다음 중 하나를 수행합니다.
  + **GitHub 리포지토리**: GitHub 계정에 연결합니다.

    1. **연결된 GitHub 계정** 탭에서 **GitHub 계정 연결**을 선택하여 GitHub의 외부 사이트로 이동합니다.

    1. GitHub 자격 증명으로 GitHub 계정에 로그인한 다음 Amazon CodeCatalyst를 설치할 계정을 선택합니다.
**작은 정보**  
이전에 GitHub 계정을 스페이스에 연결한 경우 재인증하라는 메시지가 표시되지 않습니다. 대신 두 개 이상의 GitHub 조직의 멤버 또는 공동 작업자인 경우 확장 프로그램을 설치할 위치를 묻는 대화 상자가 표시되고, 하나의 GitHub 조직에만 속한 경우 Amazon CodeCatalyst 애플리케이션의 구성 페이지가 표시됩니다. 허용하려는 리포지토리 액세스에 대한 애플리케이션을 구성한 다음 **저장**을 선택합니다. **저장** 버튼이 활성화되지 않은 경우 구성을 변경한 다음 다시 시도하세요.

    1. CodeCatalyst가 현재 및 미래 리포지토리에 모두 액세스하도록 허용할지 여부를 선택하거나 CodeCatalyst에서 사용할 특정 GitHub 리포지토리를 선택합니다. 기본 옵션은 CodeCatalyst에서 액세스할 향후 리포지토리를 포함하여 GitHub 계정에 모든 GitHub 리포지토리를 포함하는 것입니다.

    1. CodeCatalyst에 부여된 권한을 검토한 다음 **설치**를 선택합니다.

    GitHub 계정을 CodeCatalyst에 연결하면 **GitHub 리포지토리** 확장 프로그램 세부 정보 페이지로 이동합니다. 여기서 연결된 GitHub 계정과 연결된 GitHub 리포지토리를 보고 관리할 수 있습니다.
  + **Bitbucket 리포지토리:** Bitbucket 작업 영역에 연결합니다.

    1. **연결된 Bitbucket 작업 영역** 탭에서 **Bitbucket 작업 영역 연결**을 선택하여 Bitbucket의 외부 사이트로 이동합니다.

    1. Bitbucket 자격 증명을 사용하여 Bitbucket 작업 영역에 로그인하고 CodeCatalyst에 부여된 권한을 검토합니다.

    1. **작업 영역에 대한 권한 부여** 드롭다운 메뉴에서 CodeCatalyst 액세스를 제공할 Bitbucket 작업 영역을 선택한 다음 **액세스 권한 부여**를 선택합니다.
**작은 정보**  
이전에 Bitbucket 작업 영역을 스페이스에 연결한 경우 재인증하라는 메시지가 표시되지 않습니다. 대신 하나 이상의 Bitbucket 작업 영역에서 멤버 또는 공동 작업자인 경우 확장 프로그램을 설치할 위치를 묻는 대화 상자가 표시되고, 하나의 Bitbucket 작업 영역에만 속한 경우 Amazon CodeCatalyst 애플리케이션의 구성 페이지가 표시됩니다. 작업 영역 액세스를 허용하려는 애플리케이션을 선택하고, **액세스 허용**을 선택합니다. **액세스 허용** 버튼이 활성화되지 않은 경우 구성을 변경한 다음 다시 시도하세요.

    Bitbucket 워크스페이스를 CodeCatalyst에 연결하면 연결된 Bitbucket 워크스페이스과 연결된 Bitbucket 리포지토리를 보고 관리할 수 있는 **Bitbucket 리포지토리** 확장 프로그램 세부 정보 페이지로 이동합니다.
  + **GitLab 리포지토리:** GitLab 사용자에게 연결합니다.

    1. **GitLab 사용자 연결**을 선택하여 GitLab 외부 사이트로 이동합니다.

    1. GitLab 자격 증명을 사용하여 GitLab 사용자에 로그인하고 CodeCatalyst에 부여된 권한을 검토합니다.
**작은 정보**  
이전에 GitLab 사용자를 스페이스에 연결한 경우 재인증하라는 메시지가 표시되지 않습니다. 대신 CodeCatalyst 콘솔로 다시 이동합니다.

    1. **GitLab용 AWS 커넥터 권한 부여**를 선택합니다.

    GitLab 사용자를 CodeCatalyst에 연결하면 **GitLab 리포지토리** 확장 프로그램 세부 정보 페이지로 이동하며, 여기서 연결된 GitLab 사용자 및 연결된 GitLab 프로젝트 리포지토리를 보고 관리할 수 있습니다.
  + **Jira 소프트웨어**: Jira 사이트를 연결합니다.

    1. **연결된 Jira 사이트** 탭에서 **Jira 사이트 연결**을 선택하여 Atlassian Marketplace의 외부 사이트로 이동합니다.

    1. **지금 받기**를 선택하여 Jira 사이트에 CodeCatalyst 설치를 시작합니다.
**참고**  
이전에 Jira 사이트에 CodeCatalyst를 설치한 경우 알림을 받게 됩니다. **시작하기**를 선택하여 최종 단계로 이동합니다.

    1. 역할에 따라 다음 중 하나를 수행합니다.

       1. Jira 사이트 관리자인 경우 사이트 드롭다운 메뉴에서 CodeCatalyst 애플리케이션을 설치할 Jira 사이트를 선택한 다음 **앱 설치**를 선택합니다.
**참고**  
Jira 사이트가 하나 있는 경우 이 단계는 표시되지 않으며 자동으로 다음 단계로 이동합니다.

       1. 

          1. Jira 관리자가 아닌 경우 사이트 드롭다운 메뉴에서 Jira 사이트를 선택하여 CodeCatalyst 애플리케이션을 설치한 다음 **앱 요청**을 선택합니다. Jira 앱 설치에 대한 자세한 내용은 [앱을 설치할 수 있는 사람은 누구입니까?](https://www.atlassian.com/licensing/marketplace#who-can-install-apps)를 참조하세요.

          1. CodeCatalyst를 설치해야 하는 이유를 입력 텍스트 필드에 입력하거나 기본 텍스트를 유지한 다음 **요청 제출**을 선택합니다.

    1. 애플리케이션이 설치될 때 CodeCatalyst에서 수행하는 작업을 검토한 다음 **지금 받기**를 선택합니다.

    1. 애플리케이션을 설치한 후 **CodeCatalyst로 돌아가기**를 선택하여 CodeCatalyst로 돌아갑니다.

    Jira 사이트를 CodeCatalyst 연결한 후 **Jira 소프트웨어** 확장 프로그램 세부 정보 페이지의 **연결된 Jira 사이트** 탭에서 연결된 사이트를 볼 수 있습니다.

## 3단계: 타사 리소스를 CodeCatalyst 프로젝트에 연결
<a name="extensions-quickstart-link"></a>

GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 사용하거나 CodeCatalyst에서 Jira 문제를 관리하는 세 번째이자 마지막 단계는 이를 사용하려는 CodeCatalyst 프로젝트에 연결하는 것입니다.

**확장 프로그램의 세부 정보 페이지에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 또는 Jira 프로젝트를 CodeCatalyst 프로젝트에 연결하려면**
+ 설치한 타사 확장 프로그램과 연결한 공급자에 따라 다음 중 하나를 수행합니다.
  + **GitHub 리포지토리**: GitHub 리포지토리를 연결합니다.

    1. **연결된 GitHub 리포지토리** 탭에서 **GitHub 리포지토리 연결**을 선택합니다.

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

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

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

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

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

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

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

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

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

    1. **연결된 Bitbucket 리포지토리** 탭에서 **Bitbucket 리포지토리 연결**을 선택합니다.

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

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

    1. **CodeCatalyst 프로젝트** 드롭다운 메뉴에서 Bitbucket 리포지토리에 연결하려는 CodeCatalyst 프로젝트를 선택합니다.

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

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

    1. **연결된 GitLab 프로젝트 리포지토리** 탭에서 **GitLab 프로젝트 리포지토리 연결을** 선택합니다.

    1. **GitLab 사용자** 드롭다운에서 연결하려는 리포지토리가 포함된 GitLab 사용자를 선택합니다.

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

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

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

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

    1. **연결된 Jira 프로젝트** 탭에서 **Jira 프로젝트 연결**을 선택합니다.

    1. **Jira 사이트** 드롭다운 메뉴에서 연결하려는 프로젝트가 포함된 Jira 사이트를 선택합니다.

    1. **Jira 프로젝트** 드롭다운 메뉴에서 CodeCatalyst 프로젝트에 연결할 프로젝트를 선택합니다.

    1. **CodeCatalyst 프로젝트** 드롭다운 메뉴에서 Jira 프로젝트에 연결하려는 CodeCatalyst 프로젝트를 선택합니다.

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

    Jira 프로젝트가 CodeCatalyst 프로젝트에 연결되면 CodeCatalyst 문제에 대한 액세스가 완전히 비활성화되고 CodeCatalyst 탐색 창의 **문제**가 Jira 프로젝트에 연결되는 **Jira 문제** 항목으로 대체됩니다.  
![\[CodeCatalyst 문제는 탐색 창에서 연결된 Jira 문제로 대체되었습니다.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/integrations/jira-issues-nav.png)

    CodeCatalyst에서 Jira 프로젝트를 더 이상 사용하지 않으려면 CodeCatalyst 프로젝트에서 연결을 해제할 수 있습니다. Jira 프로젝트가 연결 해제되면 CodeCatalyst 프로젝트에서 Jira 문제를 사용할 수 없으며 CodeCatalyst **문제**가 다시 문제 공급자가 됩니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결 해제](extensions-unlink.md) 섹션을 참조하세요.

GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 **코드**의 **소스 리포지토리**에서 프로젝트에 연결할 수도 있습니다. 자세한 내용은 [연결된 타사 공급자의 리소스 연결](extensions-link.md#extensions-link-resources) 섹션을 참조하세요.

## 다음 단계
<a name="extensions-quickstart-next-steps"></a>

**GitHub 리포지토리**, **Bitbucket 리포지토리** 또는 **GitLab 리포지토리** 확장 프로그램을 설치하고, 리소스 공급자를 연결하고, 타사 리포지토리를 CodeCatalyst 프로젝트에 연결한 후 CodeCatalyst 워크플로 및 개발 환경에서 사용할 수 있습니다. 블루프린트에서 생성된 코드를 사용하여 연결된 GitHub 계정, Bitbucket 작업 영역 또는 GitLab 사용자에서 타사 리포지토리를 생성할 수도 있습니다. 자세한 내용은 [타사 리포지토리 이벤트 후 워크플로 실행 자동 시작](extensions-workflow-repositories.md) 및 [개발 환경 생성](devenvironment-create.md) 섹션을 참조하세요.

**Jira 소프트웨어** 확장 프로그램을 설치하고, Jira 사이트를 연결하고, Jira 프로젝트를 CodeCatalyst 프로젝트에 연결하고, 풀 요청을 연결하면 CodeCatalyst의 업데이트가 Jira 프로젝트에 반영됩니다. 풀 요청을 Jira 문제에 연결하는 방법에 대한 자세한 내용은 [Jira 문제를 CodeCatalyst 풀 요청에 연결](link-jira-issues-pull-requests.md) 섹션을 참조하세요. Jira에서 CodeCatalyst 이벤트 보기에 대한 자세한 내용은 [Jira 문제에서 CodeCatalyst 이벤트 보기](view-codecatalyst-events-jira.md) 섹션을 참조하세요.

# 스페이스에 확장 프로그램 설치
<a name="install-extension"></a>

CodeCatalyst 스페이스의 확장 프로그램을 설치하여 해당 스페이스의 프로젝트에 기능을 추가할 수 있습니다. **카탈로그** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) 아이콘을 선택하여 CodeCatalyst 카탈로그를 볼 수 있습니다. 확장 프로그램 및 기능에 대한 자세한 내용은 [사용 가능한 타사 확장](extensions.md#extensions-types) 섹션을 참조하세요.

**중요**  
확장 프로그램을 설치하려면 스페이스에 **스페이스 관리자** 역할이 있는 계정으로 로그인해야 합니다.

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

**CodeCatalyst 카탈로그에서 확장 프로그램을 설치하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 스페이스로 이동합니다.

1. 상단 메뉴 바에서 **카탈로그** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) 아이콘을 선택하여 카탈로그로 이동합니다. **GitHub 리포지토리**, **Bitbucket 리포지토리**, **GitLab 리포지토리** 또는 **Jira 소프트웨어**를 검색할 수 있습니다. 범주를 기반으로 확장 프로그램을 필터링할 수도 있습니다.

1. (선택 사항) 확장 프로그램과 관련된 권한 등 확장 프로그램에 대한 자세한 내용을 보려면 확장 이름을 선택합니다.

1. **설치**를 선택합니다. 확장 프로그램에 필요한 권한을 검토하고 계속하려면 **설치**를 다시 선택합니다.

익스텐션을 설치하면 설치된 확장 프로그램의 세부 정보 페이지가 표시됩니다. 확장 프로그램에 대한 추가 정보는 탭을 참조하세요. 또한 세부 정보 페이지에서 필요한 경우 확장 프로그램을 추가로 구성할 수 있습니다.

# 스페이스에 확장 프로그램 제거
<a name="uninstall-extension"></a>

이전에 CodeCatalyst 스페이스에 설치한 확장 프로그램을 제거할 수 있습니다. 확장 프로그램을 제거하면 해당 확장 프로그램과 관련된 리소스가 CodeCatalyst 스페이스 또는 프로젝트에서 제거될 수 있습니다.

**중요**  
확장 프로그램을 제거하려면 스페이스에 **스페이스 관리자** 역할이 있는 계정으로 로그인해야 합니다.

**CodeCatalyst 스페이스에서 확장 프로그램 제거**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 스페이스로 이동합니다.

1. 다음 중 하나를 수행하여 스페이스에 설치된 확장 프로그램 목록을 봅니다.

   1. **설정**을 선택한 다음 **설치된 확장 프로그램**을 선택합니다.

   1. 상단 메뉴에서 **카탈로그** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) 아이콘을 선택합니다.

1. 제거하려는 확장 프로그램에서 **구성**을 선택합니다.

1. 확장 프로그램 세부 정보 페이지에서 **제거**를 선택합니다.

1. **확장 프로그램 제거** 대화 상자의 정보를 검토합니다. 지침에 따라 **제거**를 선택하여 확장 프로그램을 제거합니다.

# GitHub 계정, Bitbucket 작업 영역, GitLab 사용자 및 Jira 사이트 CodeCatalyst 연결
<a name="extensions-connect"></a>

GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 사용하거나 CodeCatalyst에서 Jira 프로젝트를 관리하려면 먼저 타사 소스를 CodeCatalyst 스페이스에 연결해야 합니다. 확장 프로그램 및 기능에 대한 자세한 내용은 [사용 가능한 타사 확장](extensions.md#extensions-types) 섹션을 참조하세요.

**중요**  
GitHub 계정, Bitbucket Work 스페이스, GitLab 사용자 또는 Jira 사이트를 CodeCatalyst 스페이스에 연결하려면 타사 소스의 관리자와 CodeCatalyst **스페이스 관리자**여야 합니다.

**참고**  
GitHub 계정에 대한 연결을 사용하는 경우 개인 연결을 생성하여 CodeCatalyst ID와 GitHub ID 간에 ID 매핑을 설정해야 합니다. 자세한 내용은 [개인 연결](concepts.md#personal-connection-concept) 및 [개인 연결을 사용하여 GitHub 리소스에 액세스](ipa-settings-connections.md) 섹션을 참조하세요.

**GitHub 계정, Bitbucket Work 스페이스, GitLab 사용자 또는 Jira 사이트를 CodeCatalyst에 연결하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 스페이스로 이동합니다.

1. 다음 중 하나를 수행하여 스페이스에 설치된 확장 프로그램 목록을 봅니다.

   1. **설정**을 선택한 다음 **설치된 확장 프로그램**을 선택합니다.

   1. 상단 메뉴에서 **카탈로그** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) 아이콘을 선택합니다.

1. **구성**하려는 **GitHub 리포지토리**, **Bitbucket 리포지토리**, **GitLab 리포지토리** 또는 **Jira 소프트웨어** 확장 프로그램 중 하나에 대해 구성을 선택합니다.

1. 구성하도록 선택한 타사 확장 프로그램에 따라 다음 중 하나를 수행합니다.
   + **GitHub 리포지토리**: GitHub 계정에 연결합니다.

     1. **연결된 GitHub 계정** 탭에서 **GitHub 계정 연결**을 선택하여 GitHub의 외부 사이트로 이동합니다.

     1. GitHub 자격 증명으로 GitHub 계정에 로그인한 다음 Amazon CodeCatalyst를 설치할 계정을 선택합니다.
**작은 정보**  
이전에 GitHub 계정을 스페이스에 연결한 경우 재인증하라는 메시지가 표시되지 않습니다. 대신 둘 이상의 GitHub 스페이스에 멤버 또는 공동 작업자인 경우 확장 프로그램을 설치할 위치를 묻는 대화 상자가 표시되고, GitHub 스페이스에만 속한 경우 Amazon CodeCatalyst 애플리케이션의 구성 페이지가 표시됩니다. 허용하려는 리포지토리 액세스에 대한 애플리케이션을 구성한 다음 **저장**을 선택합니다. **저장** 버튼이 활성화되지 않은 경우 구성을 변경한 다음 다시 시도하세요.

     1. CodeCatalyst가 현재 및 미래 리포지토리에 모두 액세스하도록 허용할지 여부를 선택하거나 CodeCatalyst에서 사용할 특정 GitHub 리포지토리를 선택합니다. 기본 옵션은 CodeCatalyst에서 액세스할 향후 리포지토리를 포함하여 GitHub 계정에 모든 GitHub 리포지토리를 포함하는 것입니다.

     1. CodeCatalyst에 부여된 권한을 검토한 다음 **설치**를 선택합니다.

     GitHub 계정을 CodeCatalyst에 연결하면 **GitHub 리포지토리** 확장 프로그램 세부 정보 페이지로 이동합니다. 여기서 연결된 GitHub 계정과 연결된 GitHub 리포지토리를 보고 관리할 수 있습니다.
   + **Bitbucket 리포지토리:** Bitbucket 작업 영역에 연결합니다.

     1. **연결된 Bitbucket 작업 영역** 탭에서 **Bitbucket 작업 영역 연결**을 선택하여 Bitbucket의 외부 사이트로 이동합니다.

     1. Bitbucket 자격 증명을 사용하여 Bitbucket 작업 영역에 로그인하고 CodeCatalyst에 부여된 권한을 검토합니다.

     1. **작업 영역에 대한 권한 부여** 드롭다운 메뉴에서 CodeCatalyst 액세스를 제공할 Bitbucket 작업 영역을 선택한 다음 **액세스 권한 부여**를 선택합니다.
**작은 정보**  
이전에 Bitbucket 작업 영역을 스페이스에 연결한 경우 재인증하라는 메시지가 표시되지 않습니다. 대신 하나 이상의 Bitbucket 작업 영역에서 멤버 또는 공동 작업자인 경우 확장 프로그램을 설치할 위치를 묻는 대화 상자가 표시되고, 하나의 Bitbucket 작업 영역에만 속한 경우 Amazon CodeCatalyst 애플리케이션의 구성 페이지가 표시됩니다. 작업 영역 액세스를 허용하려는 애플리케이션을 선택하고, **액세스 허용**을 선택합니다. **액세스 허용** 버튼이 활성화되지 않은 경우 구성을 변경한 다음 다시 시도하세요.

     Bitbucket 워크스페이스를 CodeCatalyst에 연결하면 연결된 Bitbucket 워크스페이스과 연결된 Bitbucket 리포지토리를 보고 관리할 수 있는 **Bitbucket 리포지토리** 확장 프로그램 세부 정보 페이지로 이동합니다.
   + **GitLab 리포지토리:** GitLab 사용자에게 연결합니다.

     1. **GitLab 사용자 연결**을 선택하여 GitLab 외부 사이트로 이동합니다.

     1. GitLab 자격 증명을 사용하여 GitLab 사용자에 로그인하고 CodeCatalyst에 부여된 권한을 검토합니다.
**작은 정보**  
이전에 GitLab 사용자를 스페이스에 연결한 경우 재인증하라는 메시지가 표시되지 않습니다. 대신 CodeCatalyst 콘솔로 다시 이동합니다.

     1. **GitLab용 AWS 커넥터 권한 부여**를 선택합니다.

     GitLab 사용자를 CodeCatalyst에 연결하면 **GitLab 리포지토리** 확장 프로그램 세부 정보 페이지로 이동하며, 여기서 연결된 GitLab 사용자 및 연결된 GitLab 프로젝트 리포지토리를 보고 관리할 수 있습니다.
   + **Jira 소프트웨어**: Jira 사이트를 연결합니다.

     1. **연결된 Jira 사이트** 탭에서 **Jira 사이트 연결**을 선택하여 Atlassian Marketplace의 외부 사이트로 이동합니다.

     1. **지금 받기**를 선택하여 Jira 사이트에 CodeCatalyst 설치를 시작합니다.
**참고**  
이전에 Jira 사이트에 CodeCatalyst를 설치한 경우 알림을 받게 됩니다. **시작하기**를 선택하여 최종 단계로 이동합니다.

     1. 역할에 따라 다음 중 하나를 수행합니다.

        1. Jira 사이트 관리자인 경우 사이트 드롭다운 메뉴에서 CodeCatalyst 애플리케이션을 설치할 Jira 사이트를 선택한 다음 **앱 설치**를 선택합니다.
**참고**  
Jira 사이트가 하나 있는 경우 이 단계는 표시되지 않으며 자동으로 다음 단계로 이동합니다.

        1. 

           1. Jira 관리자가 아닌 경우 사이트 드롭다운 메뉴에서 Jira 사이트를 선택하여 CodeCatalyst 애플리케이션을 설치한 다음 **앱 요청**을 선택합니다. Jira 앱 설치에 대한 자세한 내용은 [앱을 설치할 수 있는 사람은 누구입니까?](https://www.atlassian.com/licensing/marketplace#who-can-install-apps)를 참조하세요.

           1. CodeCatalyst를 설치해야 하는 이유를 입력 텍스트 필드에 입력하거나 기본 텍스트를 유지한 다음 **요청 제출**을 선택합니다.

     1. 애플리케이션이 설치될 때 CodeCatalyst에서 수행하는 작업을 검토한 다음 **지금 받기**를 선택합니다.

     1. 애플리케이션을 설치한 후 **CodeCatalyst로 돌아가기**를 선택하여 CodeCatalyst로 돌아갑니다.

     Jira 사이트를 CodeCatalyst 연결한 후 **Jira 소프트웨어** 확장 프로그램 세부 정보 페이지의 **연결된 Jira 사이트** 탭에서 연결된 사이트를 볼 수 있습니다.

GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 더 이상 사용하지 않거나 CodeCatalyst에서 Jira 문제를 관리하지 않으려면 타사 소스를 연결 해제할 수 있습니다. GitHub 계정, Bitbucket 작업 영역 또는 GitLab 사용자의 연결이 끊어지면 타사 리포지토리의 이벤트는 워크플로 실행을 시작하지 않으며 CodeCatalyst 개발 환경에서 이러한 리포지토리를 사용할 수 없습니다. Jira 사이트 연결이 끊어지면 사이트의 프로젝트에서 발생하는 Jira 문제는 CodeCatalyst 프로젝트에서 사용할 수 없으며 CodeCatalyst **문제**가 다시 문제 공급자가 됩니다. 자세한 내용은 [GitHub 계정, Bitbucket 작업 영역, GitLab 사용자 및 Jira 사이트 CodeCatalyst 연결 해제](extensions-disconnect.md) 섹션을 참조하세요.

# GitHub 계정, Bitbucket 작업 영역, GitLab 사용자 및 Jira 사이트 CodeCatalyst 연결 해제
<a name="extensions-disconnect"></a>

GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 더 이상 사용하지 않거나 CodeCatalyst에서 Jira 문제를 관리하지 않으려면 타사 소스를 연결 해제할 수 있습니다. GitHub 계정, Bitbucket 작업 영역 또는 GitLab 사용자의 연결이 끊어지면 리포지토리의 이벤트는 워크플로 실행을 시작하지 않으며 CodeCatalyst 개발 환경에서 이러한 리포지토리를 사용할 수 없습니다. Jira 사이트 연결이 끊어지면 사이트의 프로젝트에서 발생하는 Jira 문제는 CodeCatalyst 프로젝트에서 사용할 수 없으며 CodeCatalyst **문제**가 다시 문제 공급자가 됩니다.

**참고**  
GitHub 계정을 연결 해제하려면 먼저 해당 계정에서 링크된 모든 GitHub 리포지토리의 링크를 해제해야 합니다.
Bitbucket 작업 영역을 연결 해제하려면 먼저 링크된 모든 Bitbucket 리포지토리를 해당 작업 영역에서 링크 해제해야 합니다.
GitLab 사용자를 연결 해제하려면 먼저 링크된 모든 GitLab 프로젝트 리포지토리를 해당 작업 영역에서 링크 해제해야 합니다.
Jira 사이트를 연결 해제하려면 먼저 링크된 모든 Jira 프로젝트를 해당 계정에서 링크 해제해야 합니다.
자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결 해제](extensions-unlink.md) 섹션을 참조하세요.

**GitHub 프로젝트, Bitbucket Work 스페이스, GitLab 사용자 또는 Jira 사이트 연결을 해제하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 스페이스로 이동합니다.

1. 다음 중 하나를 수행하여 스페이스에 설치된 확장 프로그램 목록을 봅니다.

   1. **설정**을 선택한 다음 **설치된 확장 프로그램**을 선택합니다.

   1. 상단 메뉴에서 **카탈로그** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) 아이콘을 선택합니다.

1. **구성**하려는 **GitHub 리포지토리**, **Bitbucket 리포지토리**, **GitLab 리포지토리** 또는 **Jira 소프트웨어** 확장 프로그램 중 하나에 대해 구성을 선택합니다.

1. 구성하도록 선택한 타사 확장 프로그램에 따라 다음 중 하나를 수행합니다.
   + **GitHub 리포지토리**: GitHub 계정을 연결 해제합니다.

     **연결된 GitHub 계정** 탭에서 연결 해제하려는 GitHub 계정을 선택한 다음 **GitHub 계정 연결 해제**를 선택합니다.
   + **Bitbucket 리포지토리**: Bitbucket 작업 영역 연결을 해제합니다.

     **연결된 Bitbucket 작업 영역** 탭에서 연결 해제하려는 Bitbucket 작업 영역을 선택한 다음 **Bitbucket 작업 영역 연결 해제**를 선택합니다.
   + **GitLab 리포지토리**: GitLab 사용자를 연결 해제합니다.

     **연결된 GitLab 사용자** 탭에서 연결 해제하려는 GitLab 사용자를 선택한 다음 ** GitLab 사용자 연결 해제**를 선택합니다.
   + **Jira 소프트웨어**: Jira 사이트를 연결 해제합니다.

     **연결된 Jira 사이트** 탭에서 연결 해제하려는 Jira 사이트를 선택한 다음 **Jira 사이트 연결 해제**를 선택합니다.

1. **연결 해제** 대화 상자에서 계정 연결 해제의 영향을 검토합니다.

1. 텍스트 입력 필드에 **disconnect**를 입력한 다음 **연결 해제**를 선택합니다.

# CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결
<a name="extensions-link"></a>

GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 사용하거나 Jira 프로젝트를 관리하려면 먼저 리포지토리 또는 프로젝트가 속한 타사 소스를 CodeCatalyst 스페이스에 연결해야 합니다. 자세한 내용은 [GitHub 계정, Bitbucket 작업 영역, GitLab 사용자 및 Jira 사이트 CodeCatalyst 연결](extensions-connect.md) 섹션을 참조하세요.

워크플로에서 연결된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 사용할 수 있습니다. 여기서 연결된 리포지토리의 이벤트는 워크플로 구성에 따라 코드를 빌드, 테스트 또는 배포할 수 있는 워크플로를 시작합니다. 연결된 GitHub 또는 Bitbucket 리포지토리를 사용하는 워크플로의 워크플로 구성 파일은 연결된 리포지토리에 저장됩니다. 연결된 리포지토리를 개발 환경과 함께 사용하여 연결된 리포지토리에서 파일을 생성, 업데이트 및 삭제할 수도 있습니다. GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 **GitHub 리포지토리**, **Bitbucket 리포지토리** 또는 **GitLab 리포지토리** 확장 프로그램의 세부 정보 페이지 또는 프로젝트 자체의 **코드**에 있는 **소스 리포지토리** 보기에서 CodeCatalyst 프로젝트에 연결할 수 있습니다.

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

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

**중요**  
CodeCatalyst는 연결된 리포지토리에 대한 기본 브랜치의 변경 사항 감지를 지원하지 않습니다. 연결된 리포지토리의 기본 브랜치를 변경하려면 먼저 CodeCatalyst에서 연결을 해제하고 기본 브랜치를 변경한 다음 다시 연결해야 합니다.  
리포지토리를 연결하기 전에 항상 최신 버전의 확장 프로그램을 사용하는 것이 좋습니다.

연결된 Jira 프로젝트를 사용하여 문제를 관리하고 CodeCatalyst 풀 요청을 Jira 문제에 연결할 수 있습니다. 풀 요청의 요약 상태 및 연결된 CodeCatalyst 워크플로 이벤트의 상태는 Jira 문제에 반영됩니다.

**중요**  
Jira 프로젝트를 CodeCatalyst 프로젝트에 연결하려면 CodeCatalyst **스페이스 관리자** 또는 CodeCatalyst **프로젝트 관리자**여야 합니다.

**참고**  
GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리는 한 스페이스에서 하나의 CodeCatalyst 프로젝트에만 연결할 수 있습니다.
비어있거나 보관된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 CodeCatalyst 프로젝트와 함께 사용할 수 없습니다.
CodeCatalyst 프로젝트의 리포지토리와 이름이 동일한 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 리포지토리를 연결할 수 없습니다.
**GitHub 리포지토리** 확장 프로그램은 GitHub Enterprise Server 리포지토리와 호환되지 않습니다.
**Bitbucket 리포지토리** 확장 프로그램은 Bitbucket Data Center 리포지토리와 호환되지 않습니다.
**GitLab 리포지토리** 확장 프로그램은 GitLab 자체 관리형 프로젝트 리포지토리와 호환되지 않습니다.
연결된 리포지토리에서는 **설명 쓰기** 또는 **설명 요약** 기능을 사용할 수 없습니다. 이러한 기능은 CodeCatalyst의 풀 요청에서만 사용할 수 있습니다.
CodeCatalyst 프로젝트는 하나의 Jira 프로젝트에만 연결할 수 있습니다. Jira 프로젝트는 여러 CodeCatalyst 프로젝트에 연결할 수 있습니다.

**Topics**
+ [연결된 타사 공급자의 리소스 연결](#extensions-link-resources)
+ [CodeCatalyst 프로젝트 생성 중에 타사 리포지토리 연결](#extensions-link-repositories-creation)

## 연결된 타사 공급자의 리소스 연결
<a name="extensions-link-resources"></a>

**확장 프로그램의 세부 정보 페이지에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 또는 Jira 프로젝트를 CodeCatalyst 프로젝트에 연결하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 스페이스로 이동합니다.

1. 다음 중 하나를 수행하여 스페이스에 설치된 확장 프로그램 목록을 봅니다.

   1. **설정**을 선택한 다음 **설치된 확장 프로그램**을 선택합니다.

   1. 상단 메뉴에서 **카탈로그** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) 아이콘을 선택합니다.

1. **GitHub 리포지토리**, **Bitbucket 리포지토리**, **GitLab 리포지토리** 또는 **Jira 소프트웨어** 중 하나에 대해 **구성**을 선택합니다.

1. 구성하도록 선택한 타사 확장 프로그램에 따라 다음 중 하나를 수행합니다.
   + **GitHub 리포지토리**: GitHub 리포지토리를 연결합니다.

     1. **연결된 GitHub 리포지토리** 탭에서 **GitHub 리포지토리 연결**을 선택합니다.

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

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

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

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

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

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

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

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

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

     1. **연결된 Bitbucket 리포지토리** 탭에서 **Bitbucket 리포지토리 연결**을 선택합니다.

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

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

     1. **CodeCatalyst 프로젝트** 드롭다운 메뉴에서 Bitbucket 리포지토리에 연결하려는 CodeCatalyst 프로젝트를 선택합니다.

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

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

     1. **연결된 GitLab 프로젝트 리포지토리** 탭에서 **GitLab 프로젝트 리포지토리 연결을** 선택합니다.

     1. **GitLab 사용자** 드롭다운에서 연결하려는 프로젝트 리포지토리가 포함된 GitLab 사용자를 선택합니다.

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

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

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

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

     1. **연결된 Jira 프로젝트** 탭에서 **Jira 프로젝트 연결**을 선택합니다.

     1. **Jira 사이트** 드롭다운 메뉴에서 연결하려는 프로젝트가 포함된 Jira 사이트를 선택합니다.

     1. **Jira 프로젝트** 드롭다운 메뉴에서 CodeCatalyst 프로젝트에 연결할 프로젝트를 선택합니다.

     1. **CodeCatalyst 프로젝트** 드롭다운 메뉴에서 Jira 프로젝트에 연결하려는 CodeCatalyst 프로젝트를 선택합니다.

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

     Jira 프로젝트가 CodeCatalyst 프로젝트에 연결되면 CodeCatalyst 문제에 대한 액세스가 완전히 비활성화되고 CodeCatalyst 탐색 창의 **문제**가 Jira 프로젝트에 연결되는 **Jira 문제** 항목으로 대체됩니다.  
![\[CodeCatalyst 문제는 탐색 창에서 연결된 Jira 문제로 대체되었습니다.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/integrations/jira-issues-nav.png)

     CodeCatalyst에서 Jira 프로젝트를 더 이상 사용하지 않으려면 CodeCatalyst 프로젝트에서 연결을 해제할 수 있습니다. Jira 프로젝트가 연결 해제되면 CodeCatalyst 프로젝트에서 Jira 문제를 사용할 수 없으며 CodeCatalyst **문제**가 다시 문제 공급자가 됩니다. 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결 해제](extensions-unlink.md) 섹션을 참조하세요.

**프로젝트의 소스 리포지토리 페이지에서 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 CodeCatalyst 프로젝트에 연결하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 프로젝트로 이동합니다.

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

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

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

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

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

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

     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 의 다른 프로젝트에 이미 연결되어 있으므로 해당 리포지토리를 연결할 수 없습니다.
   + **GitLab 리포지토리**: GitLab 프로젝트 리포지토리를 연결합니다.

     1. **GitLab 사용자** 드롭다운 메뉴에서 연결하려는 프로젝트 리포지토리가 포함된 GitLab 사용자를 선택합니다.

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

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

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



GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 CodeCatalyst 프로젝트에 연결한 후 CodeCatalyst 워크플로 및 개발 환경에서 사용할 수 있습니다. Amazon Q Developer, 블루프린트 등과 함께 연결된 리포지토리를 사용할 수도 있습니다. 자세한 내용은 [타사 리포지토리 이벤트 후 워크플로 실행 자동 시작](extensions-workflow-repositories.md) 및 [개발 환경 생성](devenvironment-create.md) 섹션을 참조하세요.

Jira 프로젝트를 CodeCatalyst 프로젝트에 연결하고 풀 요청을 연결하면 CodeCatalyst의 업데이트가 Jira 프로젝트에 반영됩니다. 풀 요청을 Jira 문제에 연결하는 방법에 대한 자세한 내용은 [Jira 문제를 CodeCatalyst 풀 요청에 연결](link-jira-issues-pull-requests.md) 섹션을 참조하세요. Jira에서 CodeCatalyst 이벤트 보기에 대한 자세한 내용은 [Jira 문제에서 CodeCatalyst 이벤트 보기](view-codecatalyst-events-jira.md) 섹션을 참조하세요.

## CodeCatalyst 프로젝트 생성 중에 타사 리포지토리 연결
<a name="extensions-link-repositories-creation"></a>

새 CodeCatalyst 프로젝트를 생성할 때 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 새 CodeCatalyst 프로젝트에 연결할 수 있습니다. 자세한 내용은 [연결된 타사 리포지토리를 사용하여 프로젝트 생성](projects-create.md#projects-create-3p-repo) 섹션을 참조하세요.

# CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결 해제
<a name="extensions-unlink"></a>

더 이상 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 사용하거나 CodeCatalyst에서 Jira 프로젝트를 관리하지 않으려면 CodeCatalyst 프로젝트에서 리포지토리 또는 프로젝트의 연결을 해제할 수 있습니다.

GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리의 연결을 해제해도 리포지토리가 삭제되거나 변경되지 않습니다. 연결된 리포지토리에 저장된 워크플로 구성 파일은 삭제되지 않습니다. 그러나 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리의 연결을 해제하면 해당 리포지토리의 이벤트는 더 이상 워크플로 실행을 시작하지 않으며 개발 환경과 함께 리포지토리를 사용할 수 없습니다. GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 **GitHub 리포지토리**, **Bitbucket 리포지토리** 또는 **GitLab 리포지토리** 확장 프로그램의 세부 정보 페이지 또는 프로젝트 자체의 **코드**에 있는 **소스 리포지토리** 보기를 통해 CodeCatalyst 프로젝트에서 연결 해제할 수 있습니다.

Jira 프로젝트의 연결을 해제해도 계획 항목 또는 개발 정보를 포함하여 프로젝트가 삭제되거나 변경되지 않습니다. 그러나 Jira 프로젝트의 연결을 해제하면 프로젝트의 Jira 문제를 CodeCatalyst 프로젝트에 더 이상 연결할 수 없으며 CodeCatalyst **문제**가 다시 문제 공급자가 됩니다.

**중요**  
CodeCatalyst 프로젝트에서 GitHub 리포지토리, Bitbucket 리포지토리 또는 Gitlab 프로젝트 리포지토리의 연결을 해제하려면 **스페이스 관리자** 또는 **프로젝트 관리자**여야 합니다.

**확장 프로그램 세부 정보 페이지에서 CodeCatalyst 프로젝트의 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 또는 Jira 프로젝트의 연결을 해제하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 스페이스로 이동합니다.

1. 다음 중 하나를 수행하여 스페이스에 설치된 확장 프로그램 목록을 봅니다.

   1. **설정**을 선택한 다음 **설치된 확장 프로그램**을 선택합니다.

   1. 상단 메뉴에서 **카탈로그** ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png) 아이콘을 선택합니다.

1. **구성**하려는 **GitHub 리포지토리**, **Bitbucket 리포지토리**, **GitLab 리포지토리** 또는 **Jira 소프트웨어** 확장 프로그램 중 하나에 대해 구성을 선택합니다.

1. 구성하도록 선택한 타사 확장 프로그램에 따라 다음 중 하나를 수행합니다.
   + **GitHub 리포지토리**: GitHub 리포지토리를 연결 해제합니다.

     **GitHub 리포지토리** 탭에서 연결을 해제하려는 GitHub 리포지토리를 선택한 다음 **GitHub 리포지토리 연결 해제**를 선택합니다.
   + **Bitbucket 리포지토리:** Bitbucket 리포지토리를 연결 해제합니다.

     **Bitbucket 리포지토리** 탭에서 연결을 해제하려는 Bitbucket 리포지토리를 선택한 다음 **Bitbucket 리포지토리 연결 해제**를 선택합니다.
   + **GitLab 리포지토리**: GitLab 프로젝트 리포지토리를 연결 해제합니다.

     **GitLab 프로젝트 리포지토리** 탭에서 연결을 해제하려는 GitLab 프로젝트 리포지토리를 선택한 다음 **GitLab 프로젝트 리포지토리 연결 해제**를 선택합니다.
   + **Jira 소프트웨어**: Jira 프로젝트의 연결을 해제합니다.

     **Jira 프로젝트** 탭에서 연결을 해제하려는 Jira 프로젝트를 선택한 다음 **Jira 프로젝트 연결 해제**를 선택합니다.

1. **연결 해제** 대화 상자에서 리포지토리 연결 해제의 영향을 검토합니다.

1. 텍스트 입력 필드에 **연결 해제**를 입력하고 **연결 해제**를 선택합니다.

**소스 리포지토리 페이지에서 CodeCatalyst 프로젝트의 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리 연결을 해제하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 프로젝트로 이동합니다.

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

1. 연결을 해제하려는 리포지토리의 라디오 버튼을 선택한 다음 **리포지토리 연결 해제**를 선택합니다.

1. 대화 상자의 정보를 검토합니다. 지침에 따라 **연결 해제**를 선택하여 리포지토리 연결을 해제합니다.

# CodeCatalyst에서 타사 리포지토리 보기 및 Jira 문제 검색
<a name="extensions-view-search"></a>

GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 연결한 후 CodeCatalyst에서 해당 리포지토리를 보고 리소스를 확인하고 구성할 수 있습니다. CodeCatalyst에서 연결된 Jira 문제를 검색할 수도 있습니다.

**Topics**
+ [CodeCatalyst에서 타사 리포지토리 보기](#extensions-view-repositories)
+ [CodeCatalyst에서 Jira 문제 검색](#extensions-search-issues)

## CodeCatalyst에서 타사 리포지토리 보기
<a name="extensions-view-repositories"></a>

연결된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 프로젝트의 소스 리포지토리 목록 또는 **GitHub 리포지토리**, **Bitbucket 리포지토리** 또는 **GitLab 리포지토리** 확장 프로그램 세부 정보 페이지에서 볼 수 있습니다. 리포지토리 목록에서 리포지토리를 선택하면 CodeCatalyst에서 열리지 않습니다. 대신 연결된 리포지토리의 코드를 보고 작업할 수 있는 타사 리포지토리 공급자에서 열립니다.

**CodeCatalyst에서 연결된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 보려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 프로젝트로 이동합니다.

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

**확장 프로그램 세부 정보 페이지에서 연결된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 보려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 스페이스로 이동한 다음 **설치된 확장 프로그램** 탭을 선택합니다.

1. 보려는 타사 리포지토리에 따라 다음 중 하나를 수행합니다.
   + **GitHub 리포지토리**에서 **구성**을 선택한 다음 **연결된 GitHub 리포지토리**를 선택하여 CodeCatalyst 스페이스의 CodeCatalyst 프로젝트에 연결된 모든 GitHub 리포지토리를 봅니다.
   + **Bitbucket 리포지토리**에서 **구성**을 선택한 다음 **연결된 Bitbucket 리포지토리**를 선택하여 CodeCatalyst 스페이스의 CodeCatalyst 프로젝트에 연결된 모든 Bitbucket 리포지토리를 봅니다.
   + **GitLab 리포지토리**에서 **구성**을 선택한 다음 **연결된 GitLab 리포지토리**를 선택하여 CodeCatalyst 스페이스의 CodeCatalyst 프로젝트에 연결된 모든 GitLab 리포지토리를 봅니다.

CodeCatalyst 프로젝트에 연결된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리가 목록에 표시됩니다. GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 선택하여 타사 리포지토리 공급자의 파일을 보고 편집합니다.

**참고**  
워크플로가 소스 작업에서 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 사용하는 경우 시각적 편집기의 워크플로 YAML 또는 CodeCatalyst의 YAML에 대한 변경 사항이 자동으로 커밋되어 타사 리포지토리로 푸시됩니다.

## CodeCatalyst에서 Jira 문제 검색
<a name="extensions-search-issues"></a>

Jira 프로젝트를 연결한 후 CodeCatalyst 글로벌 검색 창을 사용하여 연결된 Jira 프로젝트에서 문제를 검색할 수 있습니다. 풀 요청의 문제에 연결하는 동안 CodeCatalyst에서 Jira 문제를 검색할 수도 있습니다. Jira 문제를 CodeCatalyst 풀 요청에 연결하는 방법에 대한 자세한 내용은 [Jira 문제를 CodeCatalyst 풀 요청에 연결](link-jira-issues-pull-requests.md) 섹션을 참조하세요.

**연결된 Jira 프로젝트에서 Jira 문제를 검색하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 프로젝트로 이동합니다.

1. 글로벌 검색 표시줄에서 풀 요청에 연결하려는 문제 또는 Jira 문제에 대해 연결된 Jira 프로젝트를 검색합니다.

# 타사 리포지토리 이벤트 후 워크플로 실행 자동 시작
<a name="extensions-workflow-repositories"></a>

연결된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 워크플로의 소스로 사용할 수 있습니다. 이 경우 연결된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리의 지정된 브랜치에 대한 변경 사항이 자동으로 워크플로 실행을 시작합니다.

*워크플로*는 지속적 통합 및 지속적 전송(CI/CD) 시스템의 일부로 코드를 빌드, 테스트 및 배포하는 방법을 설명하는 자동화된 절차입니다. 워크플로는 워크플로 실행 중에 수행할 일련의 단계 또는 *작업*을 정의합니다. 또한 워크플로는 워크플로를 시작하게 하는 이벤트 또는 *트리거*를 정의합니다. 워크플로를 설정하려면 CodeCatalyst 콘솔의 [시각적 또는 YAML 편집기](https://docs.aws.amazon.com//codecatalyst/latest/userguide/flows.html#workflow.editors)를 사용하여 *워크플로 정의 파일*을 생성합니다.

**작은 정보**  
프로젝트에서 워크플로를 사용하는 방법을 간략하게 알아보려면 [블루프린트가 있는 프로젝트를 생성](https://docs.aws.amazon.com//codecatalyst/latest/userguide/projects-create.html#projects-create-console-template)합니다. 각 블루프린트는 검토, 실행 및 실험할 수 있는 기능 워크플로를 배포합니다.

연결된 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리를 사용하도록 워크플로를 구성하면 워크플로 구성 파일이 해당 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리에 저장됩니다. 워크플로 구성은 워크플로 이름, 트리거, 리소스, 아티팩트 및 작업을 정의하는 YAML 파일입니다. 워크플로 구성 파일에 대한 자세한 내용은 [워크플로 YAML 정의](workflow-reference.md) 섹션을 참조하세요.

워크플로 구성 파일은 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리의 `./codecatalyst/workflows/` 디렉터리에 있어야 합니다.

워크플로 편집기를 사용하여 워크플로를 생성하고 구성할 수 있습니다. 자세한 내용은 [워크플로 시작하기](workflows-getting-started.md) 및 [워크플로에 소스 리포지토리 연결](workflows-sources.md) 섹션을 참조하세요.

## 워크플로 실행을 시작하기 위한 트리거 추가
<a name="extensions-workflow-trigger-repositories"></a>

코드를 GitHub 또는 Bitbucket 리포지토리의 지정된 브랜치로 푸시할 때 자동으로 실행을 시작하도록 CodeCatalyst 워크플로를 구성할 수 있습니다. 워크플로 실행을 자동으로 시작하려면 워크플로 구성 파일의 `Triggers` 섹션에 트리거를 추가합니다.

### 예시: 간단한 코드 푸시 트리거
<a name="extensions-workflows-add-trigger-examples-push-simple"></a>

다음 예시는 소스 리포지토리의 모든 브랜치로 코드가 푸시될 때마다 워크플로 실행을 시작하는 트리거를 보여줍니다.

```
Triggers:
  - Type: PUSH
```

### 예시: 간단한 풀 요청 트리거
<a name="extensions-workflows-add-trigger-examples-push-simple"></a>

다음 예시는 소스 리포지토리의 브랜치에 대해 풀 요청이 생성될 때마다 워크플로 실행을 시작하는 트리거를 보여줍니다.

```
Triggers:
  - Type: PULLREQUEST
    Events:
      - OPEN
```

자세한 내용은 [트리거를 사용하여 워크플로 실행 자동 시작](workflows-add-trigger.md) 섹션을 참조하세요.

# 타사 리포지토리 공급자를 통한 IP 액세스 제한
<a name="extensions-restrict-ip-access"></a>

규칙 또는 구성을 설정하여 IP 주소를 기반으로 GitHub 리포지토리, Bitbucket 리포지토리 또는 GitLab 프로젝트 리포지토리에 대한 액세스를 제한할 수 있습니다. 타사 공급자의 설정 또는 액세스 제어 기능을 통해 이 작업을 수행할 수 있습니다.

사용 중인 타사 리포지토리 제공업체에 따라 다음 중 하나를 참조하세요.
+ Amazon CodeCatalyst **GitHub 리포지토리** 확장 프로그램은 [GitHub Enterprise Cloud IP 액세스 제한](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)과 호환됩니다. 특정 IP 주소에 대한 액세스를 제한하도록 GitHub Enterprise Cloud 조직을 구성할 때 [GitHub 앱이 허용 목록을 구성하도록 활성화](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)할 수도 있습니다. 그러면 CodeCatalyst가 GitHub에 IP 주소를 자동으로 등록할 수 있습니다. 또는 [CodeCatalyst IP 주소를 수동으로 추가](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address)할 수 있습니다.
+ Amazon CodeCatalyst **Bitbucket 리포지토리** 확장 프로그램은 [Bitbucket Cloud Premium 액세스 제한](https://support.atlassian.com/bitbucket-cloud/docs/control-access-to-your-private-content/)과 호환됩니다. 특정 IP 주소에 대한 액세스를 제한하도록 Bitbucket Cloud Premium 작업 영역을 구성할 때 [IP 주소 세트의 IP 주소 또는 네트워크 블록을 허용 목록에 추가](https://support.atlassian.com/bitbucket-cloud/docs/control-access-to-your-private-content/#Allowlisting-IP-addresses)할 수도 있습니다.
+ Amazon CodeCatalyst **GitLab 리포지토리** 확장 프로그램은 [GitLab IP 주소 제한](https://docs.gitlab.com/ee/administration/reporting/ip_addr_restrictions.html)과 호환됩니다. 특정 IP 주소에 대한 액세스를 제한하도록 GitLab Premium 또는 Ultimate 그룹을 구성할 때 [IP 주소 세트의 IP 주소 또는 네트워크 블록을 허용 목록에 추가](https://docs.gitlab.com/ee/user/group/access_and_permissions.html)할 수도 있습니다.

CodeCatalyst IP 주소가 타사 리포지토리의 허용 목록에 없는 경우 Amazon CodeCatalyst 앱은 타사 리포지토리에 액세스할 수 없습니다. 자세한 내용은 [타사 리포지토리 확장 프로그램에 사용되는 IP 주소](#codecatalyst-ip-address) 섹션을 참조하세요.

## 타사 리포지토리 확장 프로그램에 사용되는 IP 주소
<a name="codecatalyst-ip-address"></a>

다음 IP 주소는 타사 확장 프로그램에서 타사 리소스에 액세스하는 데 사용됩니다.
+ **GitHub 리포지토리**:

  ```
  us-west-2
    52.32.242.246
    54.148.176.49
    35.164.118.94
  eu-west-1
    34.241.64.10
    34.246.255.80
    3.248.38.7
  ```
+ **Bitbucket 리포지토리** 및 **GitLab 리포지토리**:

  ```
  us-west-2
    35.160.210.199 
    54.71.206.108 
    54.71.36.205
  eu-west-1
    34.242.64.82 
    52.18.37.201 
    54.77.75.62
  ```

# 워크플로 실패 시 타사 병합 차단
<a name="extensions-block-merges"></a>

GitHub 또는 Bitbucket 리포지토리를 CodeCatalyst에 연결한 후 풀 요청에 CodeCatalyst 워크플로를 추가할 수 있습니다. 마찬가지로 GitLab 프로젝트 리포지토리를 CodeCatalyst에 연결한 후 병합 요청에 CodeCatalyst 워크플로를 추가할 수 있습니다. 특정 커밋에서 하나 이상의 워크플로 실행이 발생할 수 있으며 CodeCatalyst의 각 워크플로 실행 상태도 GitHub, Bitbucket 또는 GitLab의 커밋 상태의 일부로 반영됩니다. 새 커밋이 푸시되면 새 커밋에 대한 새 워크플로 [실행 상태](https://docs.aws.amazon.com/codecatalyst/latest/userguide/workflows-view-run.html#workflows-view-run-status)가 GitHub, Bitbucket 또는 GitLab에 반영됩니다. 커밋에 대해 워크플로를 다시 실행하면 새 워크플로 실행 상태가 해당 커밋 및 워크플로의 이전 상태를 재정의합니다.

GitHub 또는 Bitbucket에서 브랜치 보호 규칙을 설정하여 풀 요청 병합을 차단하거나 GitLab에서 최신 커밋의 워크플로 실행 상태가 실패할 때 병합 요청을 차단할 수 있습니다. 브랜치 보호 규칙을 사용하면 최신 커밋 상태가 GitHub, Bitbucket 또는 GitLab에서 풀 요청을 병합하는 기능에 영향을 미칩니다. 워크플로에 대한 자세한 내용은 [워크플로 실행](workflows-working-runs.md) 및 [트리거를 사용하여 워크플로 실행 자동 시작](workflows-add-trigger.md) 섹션을 참조하세요.

사용 중인 타사 리포지토리 제공업체에 따라 다음을 참조하세요.
+ **GitHub 리포지토리**: GitHub의 [상태 확인](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks) 및 [보호 브랜치](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) 설명서.
+ **Bitbucket 리포지토리**: Bitbucket의 [Bitbucket Cloud에서 브랜치 권한 사용](https://confluence.atlassian.com/bitbucketserver/using-branch-permissions-776639807.html) 및 [브랜치 권한으로 제어](https://bitbucket.org/blog/take-control-with-branch-restrictions) 설명서.
+ **GitLab 리포지토리**: GitLab의 [자동 병합](https://docs.gitlab.com/ee/user/project/merge_requests/auto_merge.html) 및 [보호 브랜치](https://docs.gitlab.com/ee/user/project/protected_branches.html) 설명서.

# Jira 문제를 CodeCatalyst 풀 요청에 연결
<a name="link-jira-issues-pull-requests"></a>

CodeCatalyst 소스 리포지토리에서 생성된 풀 요청을 Jira 문제에 연결할 수 있습니다. Jira 문제를 연결하면 해당 문제가 풀 요청의 속성으로 표시됩니다. 따라서, 풀 요청 이벤트, 워크플로 이벤트 및 배포 이벤트가 Jira로 전송되어 Jira 문제에 추가됩니다. 풀 요청은 하나 이상의 Jira 문제에 연결할 수 있습니다. GitHub과 같은 타사 리포지토리에 있는 요청이 아니라, CodeCatalyst 소스 리포지토리에 있는 풀 요청만 연결할 수 있습니다. Jira 문제를 풀 요청에 연결하려면, 먼저 Jira 프로젝트를 CodeCatalyst 프로젝트에 연결해야 합니다. Jira 프로젝트를 CodeCatalyst 프로젝트에 연결하는 방법에 대한 자세한 내용은 [CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결](extensions-link.md) 섹션을 참조하세요.

**참고**  
CodeCatalyst 프로젝트에서 두 개의 브랜치가 있는 소스 리포지토리 없이는 풀 요청을 생성할 수 없습니다. 풀 요청에 대한 자세한 내용은 [ CodeCatalyst의 풀 요청 작업](source-pull-requests.md)을 참조하세요.

**Jira 문제를 CodeCatalyst 풀 요청에 연결하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 프로젝트로 이동합니다.

1. 탐색 창에서 **코드**를 선택한 다음, **풀 요청**을 선택합니다.

1. **풀 요청 생성**을 선택하여 풀 요청 세부 정보를 입력합니다.

1. **소스 리포지토리** 드롭다운 메뉴에서 풀 요청을 연결할 소스 리포지토리를 선택합니다.

1. **소스 브랜치** 드롭다운 메뉴에서 검토하려는 변경 사항이 포함된 브랜치를 선택합니다.

1. **대상 브랜치** 드롭다운 메뉴에서 검토된 변경 사항을 병합할 브랜치를 선택합니다.

1. **풀 요청 제목** 텍스트 입력 필드에 풀 요청의 제목을 입력합니다.

1. **Jira 문제**에 대한 **문제 연결 - *선택적*** 필드를 선택하고, 드롭다운을 선택한 다음 연결된 Jira 프로젝트에서 추가하려는 Jira 문제를 검색합니다.

1. 풀 요청에 추가하려는 Jira 문제를 선택합니다.

1. **생성**을 선택하여 풀 리퀘스트를 생성합니다.

Jira 문제를 CodeCatalyst 풀 요청에 연결하면, 풀 요청 요약을 사용할 수 있습니다. 요약에는 워크플로 실행, 연결된 문제, 필수 검토자, 선택적 검토자 및 작성자가 포함됩니다.

**참고**  
Jira 문제와 관련된 **담당자** 및 **작성자** 정보는 CodeCatalyst에서 사용할 수 없습니다.

풀 요청을 연결한 후, 동기화된 CodeCatalyst 프로젝트와 Jira 프로젝트로 CodeCatalyst의 업데이트를 Jira 프로젝트에 반영합니다. Jira에서 볼 때 연결된 풀 요청의 상태와 풀 요청과 관련된 모든 워크플로 이벤트는 Jira 문제에 표시됩니다. Jira에서 CodeCatalyst 이벤트 보기에 대한 자세한 내용은 [Jira 문제에서 CodeCatalyst 이벤트 보기](view-codecatalyst-events-jira.md) 섹션을 참조하세요.

# Jira 문제에서 CodeCatalyst 이벤트 보기
<a name="view-codecatalyst-events-jira"></a>

풀 요청의 요약 상태 및 연결된 CodeCatalyst 워크플로 이벤트의 상태는 CodeCatalyst 프로젝트와 Jira 프로젝트가 연결되어 있는 경우 Jira 문제에 반영됩니다. 예를 들어, CodeCatalyst에서 풀 요청을 닫거나 병합하는 경우 상태 업데이트가 Jira 문제에 반영됩니다. CodeCatalyst 풀 요청과 관련된 CodeCatalyst 워크플로 CI/CD 이벤트는 동기화되므로 워크플로 실행이 성공하면 Jira 문제에도 전송됩니다.

**Jira 문제에서 CodeCatalyst 이벤트 보기**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. CodeCatalyst 프로젝트로 이동합니다.

1. CodeCatalyst 탐색 창에서 **코드**, **풀 요청**을 선택한 다음 Jira 프로젝트에서 보려는 Jira 문제가 있는 풀 요청을 선택합니다.

1. **추가 정보** 창에서 Jira 프로젝트에서 보려는 Jira 이슈를 선택합니다.

1. Jira 프로젝트의 **세부 정보** 창에서 **개발**에 나열된 **풀 요청**을 선택하여 풀 요청의 세부 정보를 확인합니다.

1. (선택 사항) 최신 빌드를 보려면 **빌드** 탭을 선택합니다.

1. (선택 사항) 개발 상태를 보려면 **배포** 탭을 선택합니다.