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

# Amazon SageMaker Studio Lab의 외부 리소스 사용
<a name="studio-lab-use-external"></a>

Amazon SageMaker Studio Lab을 사용하면 Git 리포지토리와 Amazon S3의 외부 리소스(예: Jupyter Notebook 및 데이터)를 통합할 수 있습니다. GitHub 리포지토리 및 노트북에 **Studio Lab에서 열기** 버튼을 추가할 수도 있습니다. 이 버튼을 사용하면 Studio Lab에서 노트북을 직접 복제할 수 있습니다.

외부 리소스를 통합하는 방법은 다음 주제에 나와 있습니다.

**Topics**
+ [GitHub 리소스 사용](#studio-lab-use-external-clone-github)
+ [노트북에 **Studio Lab에서 열기** 버튼 추가](#studio-lab-use-external-add-button)
+ [컴퓨터에서 파일 가져오기](#studio-lab-use-external-import)
+ [Amazon S3에 연결](#studio-lab-use-external-s3)

## GitHub 리소스 사용
<a name="studio-lab-use-external-clone-github"></a>

Studio Lab은 GitHub와의 통합을 제공합니다. 이 통합을 이용해 노트북 및 리포지토리를 Studio Lab 프로젝트로 직접 복제할 수 있습니다.

다음 주제에서는 Studio Lab으로 GitHub 리소스를 사용하는 방법에 대한 정보를 제공합니다.

### Studio Lab 샘플 노트북
<a name="studio-lab-use-external-clone-examples"></a>

Studio Lab에 맞게 조정된 샘플 노트북의 리포지토리를 시작하려면 [Studio Lab 샘플 노트북](https://github.com/aws/studio-lab-examples#sagemaker-studio-lab-sample-notebooks)을 참조하세요.

이 리포지토리는 다음 사용 사례 및 기타 사용 사례에 필요한 노트북을 제공합니다.
+ 컴퓨터 비전
+ 에 연결 AWS
+ 사용자 지정 환경 생성
+ 지리 공간 데이터 분석
+ 자연어 처리
+ R 사용

### GitHub 리포지토리 복제
<a name="studio-lab-use-external-clone-repo"></a>

GitHub 리포지토리를 Studio Lab 프로젝트로 복제하려면 다음 단계를 따르세요.

1. Studio Lab 프로젝트 런타임을 시작하세요. Studio Lab 프로젝트 런타임을 시작하는 방법에 대한 자세한 내용은 [프로젝트 런타임 시작](studio-lab-manage-runtime.md#studio-lab-manage-runtime-start)을(를) 참조하세요.

1. Studio Lab에서 왼쪽 메뉴의 **파일 브라우저** 아이콘(![\[Black square icon representing a placeholder or empty image.\]](http://docs.aws.amazon.com/ko_kr/sagemaker/latest/dg/images/studio/icons/folder.png))을 선택하면 **파일 브라우저** 패널이 왼쪽에 나타납니다.

1. 파일 검색 창 아래에 있는 파일 아이콘을 선택하여 사용자 디렉터리로 이동하세요.

1. 왼쪽 메뉴에서 **Git** 아이콘(![\[Black square icon representing a placeholder or empty image.\]](http://docs.aws.amazon.com/ko_kr/sagemaker/latest/dg/images/studio/icons/git.png))을 선택하여 새 드롭다운 메뉴를 여세요.

1. **리포지토리 복제**를 선택하세요.

1. **Git 리포지토리 URL(.git)** 란에 해당 리포지토리의 URL을 붙여 넣으세요.

1. **복제**를 선택하세요.

### GitHub에서 개별 노트북을 복제하세요.
<a name="studio-lab-use-external-clone-individual"></a>

Studio Lab에서 노트북을 열려면 해당 노트북이 있는 리포지토리에 액세스할 수 있어야 합니다. 다음 예제에서는 다양한 상황에서의 Studio Lab 권한 관련 동작을 설명합니다.
+ 리포지토리가 공개 상태라면 Studio Lab 미리 보기 페이지에서 노트북을 프로젝트로 자동 복제할 수 있습니다.
+ 리포지토리가 비공개 상태라면 Studio Lab 미리 보기 페이지에서 GitHub에 로그인하라는 메시지가 표시됩니다. 비공개 리포지토리에 액세스할 수 있는 경우 노트북을 프로젝트로 복제할 수 있습니다.
+ 비공개 리포지토리에 액세스할 수 없는 경우에는 Studio Lab 미리 보기 페이지에서 노트북을 복제할 수 없습니다.

다음 섹션에서는 Studio Lab 프로젝트에서 GitHub 노트북을 복사할 수 있는 2가지 옵션을 보여줍니다. 이 옵션들은 노트북에 **Studio Lab에서 열기** 버튼이 있는지 여부에 따라 달라집니다.

#### 옵션 1: **Studio Lab에서 열기** 버튼을 이용한 노트북 복사
<a name="studio-lab-use-external-clone-individual-button"></a>

다음 절차에서는 **Studio Lab에서 열기** 버튼이 있는 노트북을 복사하는 방법을 보여줍니다. 노트북에 이 버튼을 추가하려면 [노트북에 **Studio Lab에서 열기** 버튼 추가](#studio-lab-use-external-add-button)을(를) 참조하세요.

1. [Studio Lab에 로그인하기](studio-lab-onboard.md#studio-lab-onboard-signin)의 단계에 따라 Studio Lab에 로그인하세요.

1. 새 브라우저 탭에서 복제할 GitHub 노트북으로 이동하세요.

1. 이 노트북에서 **Studio Lab에서 열기** 버튼을 선택하면 Studio Lab에서 해당 노트북의 미리 보기가 포함된 새 페이지가 열립니다.

1. 프로젝트 런타임을 아직 실행하지 않고 있다면 미리 보기 페이지 상단의 **런타임 시작** 버튼을 선택하여 프로젝트 런타임을 시작하세요. 런타임이 시작될 때까지 기다렸다가 다음 단계로 진행하세요.

1. 프로젝트 런타임이 시작되고 나서 **프로젝트로 복사**를 선택하면, 새 브라우저 탭에서 프로젝트 런타임이 열립니다.

1. **GitHub에서 복사하시겠습니까?** 대화 상자에서 **노트북만 복사**를 선택하세요. 그러면 노트북 파일이 프로젝트로 복사됩니다.

#### 옵션 2: GitHub 노트북(종류 무관) 복제
<a name="studio-lab-use-external-clone-individual-general"></a>

다음 절차에서는 GitHub에서 노트북(종류 무관)을 복사하는 방법을 보여줍니다.

1. GitHub에서 노트북으로 이동하세요.

1. 브라우저의 주소 표시줄에서 노트북 URL을 다음 주소로 수정하세요.

   ```
   # Original URL
   https://github.com/<PATH_TO_NOTEBOOK>
   
   # Modified URL 
   https://studiolab.sagemaker.aws/import/github/<PATH_TO_NOTEBOOK>
   ```

1. 수정된 URL로 이동하세요. 그러면 Studio Lab에서 노트북의 미리 보기가 열립니다.

1. 프로젝트 런타임을 아직 실행하지 않고 있다면 미리 보기 페이지 상단의 **런타임 시작** 버튼을 선택하여 프로젝트 런타임을 시작하세요. 런타임이 시작될 때까지 기다렸다가 다음 단계로 진행하세요.

1. 프로젝트 런타임이 시작되고 나서 **프로젝트로 복사**를 선택하면, 새 브라우저 탭에서 프로젝트 런타임이 열립니다.

1. **GitHub에서 복사하시겠습니까?** 대화 상자에서 **노트북만 복사**를 선택하여 노트북 파일을 프로젝트로 복사하세요.

## 노트북에 **Studio Lab에서 열기** 버튼 추가
<a name="studio-lab-use-external-add-button"></a>

노트북에 **Studio Lab에서 열기** 버튼을 추가하면 다른 사용자가 노트북 또는 리포지토리를 Studio Lab 프로젝트로 직접 복제할 수 있습니다. 공개 GitHub 리포지토리 내에서 노트북을 공유하면 누구나 콘텐츠를 공개적으로 읽을 수 있습니다. 노트북에서 AWS 액세스 키 또는 AWS Identity and Access Management 자격 증명과 같은 프라이빗 콘텐츠를 공유하지 마십시오.

Jupyter notebook 또는 리포지토리에 기능적인 **Studio Lab에서 열기** 버튼을 추가하려면 노트북 또는 리포지토리 상단에 다음 마크다운을 추가하세요.

```
[![Open In SageMaker Studio Lab](https://studiolab.sagemaker.aws/studiolab.svg)](https://studiolab.sagemaker.aws/import/github/<PATH_TO_YOUR_NOTEBOOK_ON_GITHUB>)
```

## 컴퓨터에서 파일 가져오기
<a name="studio-lab-use-external-import"></a>

다음 단계에서는 컴퓨터에서 Studio Lab 프로젝트로 파일을 가져오는 방법을 보여줍니다.  

1. Studio Lab 프로젝트 런타임을 여세요.

1. **파일 브라우저** 패널을 여세요.

1. **파일 브라우저** 패널의 작업 표시줄에서 **파일 업로드** 버튼을 선택하세요.

1. 로컬 시스템에서 업로드할 파일을 선택하세요.

1. **열기**를 선택하세요.



아니면 컴퓨터에서 **파일 브라우저** 패널로 파일을 끌어다 놓을 수도 있습니다.

## Amazon S3에 연결
<a name="studio-lab-use-external-s3"></a>

는 Studio Lab 프로젝트에서 AWS 통합을 AWS CLI 활성화합니다. 이 통합을 실행하면 Amazon S3에서 리소스를 가져와서 Jupyter notebook과 함께 사용할 수 있습니다.

Studio Lab AWS CLI 에서를 사용하려면 다음 단계를 완료하세요. 이 통합을 설명하는 노트북은 [AWS 리소스와 함께 Studio Lab 사용을](https://github.com/aws/studio-lab-examples/blob/main/connect-to-aws/Access_AWS_from_Studio_Lab.ipynb) 참조하세요.

1. [최신 버전의 설치 또는 업데이트 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)에서 AWS CLI   다음 단계를 설치합니다.

1. [빠른 설정](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html)의 단계에  따라 AWS 자격 증명을 구성합니다. AWS 계정의 역할에는 데이터를 복사하는 Amazon S3 버킷에 액세스할 수 있는 권한이 있어야 합니다.

1. 필요한 경우 Jupyter Notebook에서 Amazon S3 버킷의 리소스를 복제하세요. 다음 명령에서는 Amazon S3 경로의 모든 리소스를 프로젝트로 복제하는 방법을 보여줍니다. 자세한 내용은 [AWS CLI 명령 참조](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/cp.html)를 참조하세요.

   ```
   !aws s3 cp s3://<BUCKET_NAME>/<PATH_TO_RESOURCES>/ <PROJECT_DESTINATION_PATH>/ --recursive
   ```