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

# Git 기반 리포지토리를 EMR Studio Workspace에 연결
<a name="emr-studio-git-repo"></a>

노트북 파일을 저장하고 공유하도록 최대 3개의 Git 기반 리포지토리를 Amazon EMR Studio Workspace와 연결합니다.

## EMR Studio용 Git 리포지토리 정보
<a name="emr-studio-git-repo-about"></a>

최대 3개의 Git 리포지토리를 EMR Studio Workspace에 연결할 수 있습니다. 기본적으로 각 Workspace를 사용하면 Studio와 동일한 AWS 계정과 연결된 Git 리포지토리 목록에서 선택할 수 있습니다. 새 Git 리포지토리를 WorkSpace의 리소스로 생성할 수도 있습니다.

클러스터의 프라이머리 노드에 연결된 상태에서 터미널 명령을 사용하여 다음과 같은 Git 명령을 실행할 수 있습니다.

```
!git pull origin <branch-name>
```

또는 jupyterlab-git 확장을 사용할 수 있습니다. 왼쪽 사이드바에서 **Git** 아이콘을 선택하여 엽니다. JupyterLab용 jupyterlab-git 확장에 대한 자세한 내용은 [jupyterlab-git](https://github.com/jupyterlab/jupyterlab-git)를 참조하세요.

## 사전 조건
<a name="emr-studio-git-prereqs"></a>
+ Git 리포지토리를 Workspace에 연결하려면 Git 리포지토리 연결을 허용하도록 Studio를 구성해야 합니다. Studio 관리자가 [Git 기반 리포지토리에 대한 액세스 및 권한 설정](emr-studio-enable-git.md)에 대한 단계를 수행해야 합니다.
+ CodeCommit 리포지토리를 사용하는 경우 Git 보안 인증 및 HTTPS를 사용해야 합니다. AWS Command Line Interface 자격 증명 헬퍼가 있는 SSH 키 및 HTTPS는 지원되지 않습니다. CodeCommit은 개인용 액세스 토큰(PAT)도 지원하지 않습니다. 자세한 내용은 *IAM 사용 설명서*에서 [IAM과 CodeCommit을 함께 사용](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html) 및 *AWS CodeCommit 사용 설명서*에서 [Setup for HTTPS users using Git credentials](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html)를 참조하세요.

## 지침
<a name="emr-studio-link-git-repo"></a>

**연결된 Git 리포지토리를 Workspace에 연결하는 방법**

1. Studio의 **Workspace** 목록에서 리포지토리에 연결하려는 Workspace를 엽니다.

1. 왼쪽 사이드바에서 **Amazon EMR Git 리포지토리** 아이콘을 선택하여 **Git 리포지토리** 도구 패널을 엽니다.

1. **Git 리포지토리**에서 드롭다운 목록을 확장하고 Workspace에 연결할 리포지토리를 최대 3개 선택합니다. EMR Studio는 선택 항목을 등록하고 각 리포지토리를 연결하기 시작합니다.

연결 프로세스를 완료하는 데 시간이 걸릴 수 있습니다. **Git 리포지토리** 도구 패널에서 선택한 각 리포지토리의 상태를 볼 수 있습니다. EMR Studio가 리포지토리를 Workspace에 연결하면 해당 리포지토리에 속하는 파일이 **파일 브라우저** 패널에 나타납니다.

**새 Git 리포지토리를 Workspace에 리소스로 추가하는 방법**

1. Studio의 Workspace 목록에서 리포지토리에 연결하려는 Workspace를 엽니다.

1. 왼쪽 사이드바에서 **Amazon EMR Git 리포지토리** 아이콘을 선택하여 **Git 리포지토리** 도구 패널을 엽니다.

1. **새 Git 리포지토리 추가**를 선택합니다.

1. **리포지토리 이름**에 EMR Studio의 리포지토리에 대한 설명 이름을 입력합니다. 이름은 영숫자, 하이픈(-) 및 밑줄(\$1)만 포함할 수 있습니다.

1. **Git repository URL(Git 리포지토리 URL)**에 리포지토리 URL을 입력합니다. CodeCommit 리포지토리를 사용하는 경우, **URL 복제**를 선택한 다음 **HTTPS 복제**를 선택하면 복사되는 URL입니다. 예를 들어 `https://git-codecommit.us-west-2.amazonaws.com/v1/repos/[MyCodeCommitRepoName]`입니다.

1. **브랜치**에는 체크아웃하려는 기존 브랜치의 이름을 입력합니다.

1. Git 보안 인증의 경우 다음 지침에 따라 옵션을 선택합니다. EMR Studio는 Secrets Manager에 저장된 보안 암호를 사용하여 Git 보안 인증에 액세스합니다.
**참고**  
GitHub 리포지토리를 사용하는 경우 개인 액세스 토큰(PAT)을 사용하여 인증하는 것이 좋습니다. 2021년 8월 13일부터 GitHub는 토큰 기반 인증을 요구하며 Git 작업을 인증할 때 더 이상 암호를 허용하지 않습니다. 자세한 내용은 *GitHub* 블로그의 [Token authentication requirements for Git operations](https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/) 게시물을 참조하세요.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/emr/latest/ManagementGuide/emr-studio-git-repo.html)

1. **리포지토리 추가**를 선택하여 새 리포지토리를 생성합니다. EMR Studio에서 새 리포지토리를 생성한 후에 성공 메시지가 표시됩니다. 그러면 **Git 리포지토리** 아래 드롭다운 목록에 새 리포지토리가 표시됩니다.

1. 새 리포지토리를 Workspace에 연결하려면 **Git 리포지토리** 아래 드롭다운 목록에서 해당 리포지토리를 선택합니다.

연결 프로세스를 완료하는 데 시간이 걸릴 수 있습니다. EMR Studio가 새 리포지토리를 Workspace에 연결하면 **파일 브라우저** 패널에 리포지토리와 이름이 같은 새 폴더가 나타납니다.

연결된 다른 리포지토리를 열려면 **파일 브라우저**에서 해당 폴더로 이동합니다.