在 Amazon 實驗 SageMaker 室中使用外部資源 - Amazon SageMaker
使用 GitHub 資源新增在 Studio Lab 中開啟按鈕至您的筆記本從電腦匯入檔案連接至 Amazon S3

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

在 Amazon 實驗 SageMaker 室中使用外部資源

使用 Amazon SageMaker Studio 實驗室，您可以整合 Git 儲存庫和 Amazon S3 中的外部資源，例如 Jupyter 筆記本和資料。您也可以在存放 GitHub 庫和筆記本中新增「在 Studio Lab 中開啟」按鈕。此按鈕可讓您直接從 Studio Lab 複製筆記本。

下列主題說明如何整合外部資源。

使用 GitHub 資源

工作室實驗室提供與 GitHub. 有了這項整合，您可以將筆記本和儲存庫直接複製到您的 Studio Lab 專案。

下列主題提供如何搭配 Studio Lab 使用 GitHub 資源的相關資訊。

Studio Lab 範例筆記本

若要開始使用為 Studio Lab 量身打造的範例筆記本儲存庫，請參閱 Studio Lab 範例筆記本。

此儲存庫提供下列使用案例等的筆記本。

  • 電腦視覺

  • 連接到 AWS

  • 建立自訂環境

  • 地理空間資料分析

  • 自然語言處理

  • 使用 R

克隆一個 GitHub 回購

若要將存放 GitHub 庫複製到您的 Studio 實驗室專案，請依照下列步驟執行。

  1. 啟動您的 Studio Lab 專案執行期。如需啟動 Studio Lab 專案執行期的詳細資訊，請參閱啟動專案執行時間。

  2. 在 Studio Lab 中，選擇左側選單上的檔案瀏覽器圖示 ( Black square icon representing a placeholder or empty image. )，使檔案瀏覽器面板顯示在左側。

  3. 選擇檔案搜尋列下方的檔案圖示，導覽至您的使用者目錄。

  4. 從左側選單中選取 Git 圖示 ( Black square icon representing a placeholder or empty image. )，以開啟新的下拉式選單。

  5. 選擇複製儲存庫。

  6. 將存儲庫粘貼到 Git 存儲庫URL（.git）URL下。

  7. 選取複製。

複製個別記事本 GitHub

若要在 Studio Lab 中開啟筆記本，您必須能夠存取筆記本所在的儲存庫。下列範例說明各種情況下的 Studio Lab 許可相關行為。

  • 如果儲存庫為公有，您可以從 Studio Lab 預覽頁面將筆記本自動複製到您的專案中。

  • 如果存放庫是私人的，系統會提示您 GitHub 從 Studio Lab 預覽頁面登入。如果您能夠存取私有儲存庫，則可以將筆記本複製到您的專案中。

  • 如果您無法存取私有儲存庫，則無法從 Studio Lab 預覽頁面複製筆記本。

以下各節顯示兩個選項，供您在 Studio Lab 專案中複製 GitHub 筆記本。這些選項取決於筆記本電腦是否具有在 Studio Lab 中開啟的按鈕。

選項 1：使用在 Studio Lab 中開啟按鈕複製筆記本

下列程序示範如何複製具有在 Studio Lab 中開啟按鈕的筆記本。如果要將此按鈕新增到筆記本，請參閱新增在 Studio Lab 中開啟按鈕至您的筆記本。

  1. 請遵循 登入 Studio 實驗室 中的步驟登入 Studio Lab。

  2. 在新的瀏覽器索引標籤中，瀏覽至您要複製的 GitHub 筆記本。

  3. 在筆記本中，選取在 Studio Lab 中開啟按鈕按鈕，以在 Studio Lab 中開啟具有筆記本預覽的新頁面。

  4. 如果您的專案執行期尚未執行，請選擇預覽頁面頂端的啟動執行期按鈕加以啟動。等待執行期開始後，再進行後續步驟。

  5. 專案執行期啟動之後，請選取複製到專案，以在新的瀏覽器標籤中開啟專案執行期。

  6. 在複製來源 GitHub？ 對話方塊中，選取「僅複製記事本」。這會將筆記本檔案複製到您的專案。

選項 2：克隆任何 GitHub 筆記本

下列程序顯示如何從中複製任何記事本 GitHub。

  1. 導覽至中的筆記本 GitHub。

  2. 在瀏覽器的網址列中，修改記事本URL，如下所示。

    # Original URL
https://github.com/<PATH_TO_NOTEBOOK>

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

  3. 導航到修改的URL。這會在 Studio Lab 中開啟筆記本的預覽。

  4. 如果您的專案執行期尚未執行，請選擇預覽頁面頂端的啟動執行期按鈕加以啟動。等待執行期開始後，再進行後續步驟。

  5. 專案執行期啟動之後，請選取複製到專案，以在新的瀏覽器標籤中開啟專案執行期。

  6. 在複製來源 GitHub？ 」對話方塊中，選取「僅複製筆記本」，將筆記本檔案複製到您的專案。

新增在 Studio Lab 中開啟按鈕至您的筆記本

當您將在 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>)

從電腦匯入檔案

下列步驟顯示如何從您的電腦將檔案匯入到 Studio Lab 專案。 

  1. 開啟 Studio Lab 專案執行期。

  2. 開啟檔案瀏覽器面板。

  3. 在檔案瀏覽器面板的動作列中，選取上傳檔案按鈕。

  4. 選取您要上傳於本機機器的檔案。

  5. 選取開啟。

或者，您可以將檔案從電腦拖放到檔案瀏覽器面板。

連接至 Amazon S3

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

若要 AWS CLI 搭配 Studio 實驗室使用，請完成以下步驟。如需概述此整合的筆記本，請參閱將 Studio Lab 與 AWS 資源搭配使用。

  1. 安裝 AWS CLI 以下步驟，在安裝或更新最新版本的 AWS CLI.

  2. 依照快速設定中的步驟設定您的 AWS 認證。您 AWS 帳戶的角色必須具有存取要從中複製資料的 Amazon S3 儲存貯體的權限。

  3. 從 Jupyter 筆記本，視需要從 Amazon S3 儲存貯體複製資源。下列命令示範如何從 Amazon S3 路徑複製所有資源到您的專案。如需詳細資訊，請參閱 AWS CLI 命令參考。

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