本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Amazon SageMaker Studio Lab 中使用外部資源
<a name="studio-lab-use-external"></a>

使用 Amazon SageMaker Studio Lab，您可以從 Git 儲存庫和 Amazon S3 整合外部資源，例如 Jupyter 筆記本和資料。您還可以在 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/zh_tw/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/zh_tw/sagemaker/latest/dg/images/studio/icons/git.png))，以開啟新的下拉式選單。

1. 選擇**複製儲存庫**。

1. 將儲存庫 URL 貼到 **Git 儲存庫 URL (.git)** 下。

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 筆記本。這些選項取決於筆記本電腦是否具有**在 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 登入資料。

若要將功能性**在 Studio Lab 中開啟**按鈕新增至 Jupyter 筆記本或儲存庫，請將下列 Markdown 新增至筆記本或儲存庫的頂端。

```
[![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>

 AWS CLI 可在您的 Studio Lab 專案中啟用 AWS 整合。透過此整合，您可以從 Amazon S3 提取資源以搭配 Jupyter 筆記本使用。

若要 AWS CLI 搭配 Studio Lab 使用 ，請完成下列步驟。如需概述此整合的筆記本，請參閱[搭配使用 Studio Lab 與 AWS 資源](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 筆記本，視需要從 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
   ```