將 Amazon SageMaker 工作室實驗室環境導出到 Amazon SageMaker 工作室

Amazon SageMaker Studio 經典版提供許多適用於機器學習和深度學習工作流程的功能，這些功能無法在 Amazon SageMaker Studio 實驗室中使用。本頁說明如何將 Studio 實驗室環境移轉至 Studio 經典版，以利用更多運算容量、儲存空間和功能。但是，您可能想要熟悉 Studio 經典版的預構建容器，這些容器針對完整的 MLOP 管道進行了優化。如需更多資訊，請參閱 Amazon 實驗 SageMaker 室

若要將您的 Studio 實驗室環境遷移到工作室經典版，您必須先按照中的步驟加入工作室經典版Amazon SageMaker 域名概述。

步驟 1：匯出 Studio 實驗室 Conda 環境

透過遵循 管理您的環境 中的步驟，您可以匯出 Conda 環境，並將程式庫或套件新增至環境。下面的例子演示了如何使用default環境導出到工作室經典。

1. 開啟檔案瀏覽器 ( ) 面板，選擇檔案瀏覽器頂端選單中的加號 (+) 以開啟啟動器，然後選擇終端機，及可可開啟 Studio 實驗室。從 Studio 實驗室終端機，透過執行下列命令列出 Conda 環境。

   conda env list

   此命令會輸出 Conda 環境及其在檔案系統中的位置清單。當您加入 Studio 實驗室時，會自動啟動 studiolab Conda 環境。

   # conda environments: #
              default                  /home/studio-lab-user/.conda/envs/default
              studiolab             *  /home/studio-lab-user/.conda/envs/studiolab
              studiolab-safemode       /opt/amazon/sagemaker/safemode-home/.conda/envs/studiolab-safemode
              base                     /opt/conda

   我們建議您不要匯出 studiolab、studiolab-safemode、和 base 環境。這些環境無法在工作室經典版中使用，原因如下：

   • studiolab：這會為工作室實驗室設定 JupyterLab 環境。工作室實驗室運行 JupyterLab 比工作室經典不同的主要版本，所以它不能在工作室經典使用。

   • studiolab-safemode：這也會設定工作室實驗室的 JupyterLab 環境。工作室實驗室運行 JupyterLab 比工作室經典不同的主要版本，所以它不能在工作室經典使用。

   • base：此環境預設為具備 Conda。Studio 實驗室中的base環境和工作室經典中的base環境具有許多軟件包的不兼容版本。

2. 對於您要移轉至工作室傳統版的 Conda 環境，請先啟動 Conda 環境。然後，當安裝或移除新資源庫時，default環境會變更。若要取得環境的確切狀態，請使用命令列將其匯出至 YAML 檔案。下列命令列會將預設環境匯出至 YAML 檔案，並建立名為 myenv.yml 的檔案。

   conda activate default
   conda env export > ~/myenv.yml

步驟 2：儲存 Studio 實驗室成品

現在您已將環境儲存於 YAML 檔案，您可以將環境檔案移至任何平台。

Save to a local machine using Studio Lab GUI

注意

目前無法提供在目錄上按一下滑鼠右鍵，從 Studio 實驗室 GUI 下載目錄的功能。如果您想要匯出目錄，請遵循以下步驟使用儲存至 Git 儲存庫索引標籤。

其中一個選項是將環境儲存至本機機器。若要執行此操作，請使用下列程序。

1. 在 Studio 實驗室中，選擇左側選單上的檔案瀏覽器 ( ) 圖示，左側將顯示檔案瀏覽器面板。

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

3. 選擇 (按一下滑鼠右鍵) myenv.yml 檔案，然後選擇下載。您可以對要導入到 Studio 經典的其他文件重複此過程。

Save to a Git repository

另一種選項是將您的環境儲存至 Git 儲存庫。此選項用 GitHub 作範例。這些步驟需要 GitHub 帳戶和儲存庫。如需詳細資訊，請造訪 GitHub。下列程序顯示如何 GitHub 使用 Studio Lab 終端機同步處理您的內容。

1. 從 Studio 實驗室終端機，導覽至您的使用者目錄，並建立包含要匯出的檔案的新目錄。

   cd ~
   mkdir <NEW_DIRECTORY_NAME>

2. 建立新目錄後，複製想要匯出至 <NEW_DIRECTORY_NAME> 的任何檔案或目錄。

   使用下列程式碼格式複製檔案：

   cp <FILE_NAME> <NEW_DIRECTORY_NAME>

   例如：以 <FILE_NAME> 取代 myenv.yml。

   使用下列程式碼格式複製任何目錄：

   cp -r <DIRECTORY_NAME> <NEW_DIRECTORY_NAME>

   例如，以使用者目錄中的任何目錄名稱取代 <DIRECTORY_NAME>。

3. 導覽到新目錄，並使用下列命令將目錄初始化為 Git 儲存庫。如需詳細資訊，請參閱 git-init 文件。

   cd <NEW_DIRECTORY_NAME>
   git init

4. 使用 Git，新增所有相關檔案，然後提交變更。

   git add .
   git commit -m "<COMMIT_MESSAGE>"

   例如：以 <COMMIT_MESSAGE> 取代 Add Amazon SageMaker Studio Lab artifacts to GitHub repository to migrate to Amazon SageMaker Studio Classic 。

5. 將遞交推送至遠端儲存庫。此儲存庫的格式https://github.com/<GITHUB_USERNAME>/ <REPOSITORY_NAME>.git<GITHUB_USERNAME>為您的 GitHub使用者名稱，<REPOSITORY_NAME>也是您的遠端存放庫名稱。建立分支<BRANCH_NAME>以將內容推送至存 GitHub 放庫。

   git branch -M <BRANCH_NAME>
   git remote add origin https://github.com/<GITHUB_USERNAME>/<REPOSITORY_NAME>.git
   git push -u origin <BRANCH_NAME>

第 3 步：將您的工作室實驗室工件導入經典工作室

下列程序顯示如何將成品匯入至工作室傳統版。透過主控台使用功能存放區的指示取決於您是否已啟用 Studio 或 Studio 傳統版做為預設體驗。如需透過主控台存取 Studio 典型版的相關資訊，請參閱如果工作室是您的預設體驗，請啟動工作室。

從工作室經典版，您可以從本機電腦或 Git 儲存庫匯入檔案。您可以使用工作室經典 GUI 或終端來執行此操作。下列程序使用 步驟 2：儲存 Studio 實驗室成品 的範例。

Import using the Studio Classic GUI

如果您將檔案儲存到本機電腦，您可以使用下列步驟將檔案匯入至 Studio 經典版。

1. 開啟 Studio 傳統版左上方的檔案瀏覽器 ( ) 面板。

2. 選擇檔案瀏覽器面板頂端選單上的上傳檔案圖示 ( )。

3. 導覽至您要匯入的檔案，然後選擇「開啟」。

注意

若要將目錄匯入至 Studio 經典版，請先將本機電腦上的目錄壓縮為檔案。在 Mac 中，在目錄上按一下滑鼠右鍵，然後選擇壓縮 "<DIRECTORY_NAME>"。在 Windows 中，在目錄上按一下滑鼠右鍵，選擇傳送到，然後選擇壓縮的 (已壓縮) 資料夾)。壓縮目錄之後，請使用上述步驟匯入已壓縮的檔案。通過導航到 Studio 經典終端並運行命令<DIRECTORY_NAME>.zip來解壓縮壓縮文件。

Import using a Git repository

這個例子提供了如何將 GitHub 存儲庫克隆到工作室經典的兩個選項。您可以通過選擇 Git（ ）選項卡上的工作室經典的左側使用工作室經典 GUI。選擇複製儲存庫，然後從中貼上 GitHub 儲存庫 URL 步驟 2：儲存 Studio 實驗室成品。另一種選擇是使用工作室經典終端使用以下過程。

1. 開啟工作室經典啟動器。有關打開啟動器的更多信息，請參閱 Amazon SageMaker 工作室經典啟動器。

2. 在啟動器的筆記本和運算資源區段中，選擇變更環境。

3. 在工作室經典版中，開啟啟動器。要打開啟動器，請選擇 Amazon SageMaker 工作室經典工作室經典工作室的左上角。

   若要了解開啟啟動器的所有可用方法，請參閱 使用 Amazon 工 SageMaker 作室經典啟動器。

4. 在變更環境對話方塊中，使用映像下拉式清單選取資料科學映像，然後選擇選取。此映像隨附預先安裝的 Conda。

5. 在工作室傳統啟動器中，選擇 [開啟影像終端機]。

6. 從映像終端機，執行下列命令以複製儲存庫。此命令會在您的 Studio 經典實例<REPOSITORY_NAME>中創建一個以命名的目錄，並在該存儲庫中克隆您的成品。

   git clone https://github.com/<GITHUB_USERNAME>/<REPOSITORY_NAME>.git

第 4 步：在工作室經典中安裝您的工作室實驗室控制環境

您現在可以在 Studio 傳統型執行個體中使用 YAML 檔案，重新建立您的 Conda 環境。開啟工作室經典啟動器。有關打開啟動器的更多信息，請參閱 Amazon SageMaker 工作室經典啟動器。從啟動器中，選擇開啟映像終端機。在終端機中，導覽至包含 YAML 檔案的目錄，然後執行下列命令。

conda env create --file <ENVIRONMENT_NAME>.yml
conda activate <ENVIRONMENT_NAME>

完成這些指令之後，您可以選取環境作為 Studio Classic 筆記本執行個體的核心。若要檢視可用環境，請執行 conda env list。若要啟動您的環境，請執行 conda activate <ENVIRONMENT_NAME>。