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

# 將 Amazon SageMaker Studio Lab 環境匯出至 Amazon SageMaker Studio Classic
<a name="studio-lab-use-migrate"></a>

Amazon SageMaker Studio Classic 提供許多適用於機器學習和深度學習工作流程的功能，這些功能在 Amazon SageMaker Studio Lab 中無法使用。本頁面展示如何將 Studio Lab 環境遷移至 Studio Classic，以利用更多運算容量、儲存體和功能。但是，您可能想要熟悉 Studio Classic 的預先建置容器，這些容器已針對完整 MLOP 管道最佳化。如需詳細資訊，請參閱[Amazon SageMaker Studio Lab](studio-lab.md)

若要將您的 Studio Lab 環境遷移至 Studio Classic，您必須先遵循 [Amazon SageMaker AI 網域概觀](gs-studio-onboard.md)中的步驟加入 Studio Classic。

**Topics**
+ [步驟 1：匯出 Studio Lab Conda 環境](#studio-lab-use-migrate-step1)
+ [步驟 2：儲存 Studio Lab 成品](#studio-lab-use-migrate-step2)
+ [步驟 3：將您的 Studio Lab 成品匯入至 Studio Classic](#studio-lab-use-migrate-step3)
+ [步驟 4：在 Studio Classic 中安裝您的 Studio Lab Conda 環境](#studio-lab-use-migrate-step4)

## 步驟 1：匯出 Studio Lab Conda 環境
<a name="studio-lab-use-migrate-step1"></a>

透過遵循 [管理您的環境](studio-lab-use-manage.md) 中的步驟，您可以匯出 Conda 環境，並將程式庫或套件新增至環境。下列範例示範如何使用要匯出至 Studio Classic 的 `default` 環境。

1. 開啟**檔案瀏覽器**面板 (![\[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**) 以開啟**啟動器**，然後選擇**終端機**，即可開啟 Studio Lab。從 Studio Lab 終端機，透過執行下列命令列出 Conda 環境。

   ```
   conda env list
   ```

   此命令會輸出 Conda 環境及其在檔案系統中的位置清單。當您加入 Studio Lab 時，會自動啟動 `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` 環境。這些環境在 Studio Classic 中無法使用的原因如下：
   +  `studiolab`：這會為 Studio Lab 設定 JupyterLab 環境。Studio Lab 執行與 Studio Classic 不同的 JupyterLab 主要版本，因此無法在 Studio Classic 中使用。
   +  `studiolab-safemode`：這同樣會為 Studio Lab 設定 JupyterLab 環境。Studio Lab 執行與 Studio Classic 不同的 JupyterLab 主要版本，因此無法在 Studio Classic 中使用。
   +  `base`：此環境預設為具備 Conda。Studio Lab 中的 `base` 環境和 Studio Classic 中的 `base` 環境具有許多套件的不相容版本。

1. 針對您要遷移至 Studio Classic 的 conda 環境，請先啟用 conda 環境。然後，安裝或從中移除新的程式庫時，`default` 環境就會變更。若要取得環境的確切狀態，請使用命令列將其匯出至 YAML 檔案。下列命令列會將預設環境匯出至 YAML 檔案，並建立名為 `myenv.yml` 的檔案。

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

## 步驟 2：儲存 Studio Lab 成品
<a name="studio-lab-use-migrate-step2"></a>

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

------
#### [ Save to a local machine using Studio Lab GUI ]

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

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

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. 選擇 (按一下滑鼠右鍵) `myenv.yml` 檔案，然後選擇**下載**。您可以針對想要匯入至 Studio Classic 的其他檔案重複此程序。

------
#### [ Save to a Git repository ]

另一種選項是將您的環境儲存至 Git 儲存庫。此選項使用 GitHub 做為範例。這些步驟需要 GitHub 帳戶和儲存庫。如需詳細資訊，請造訪 [GitHub](https://github.com/)。下列程序示範如何使用 Studio Lab 終端機同步您的內容與 GitHub。

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

   ```
   cd ~
   mkdir <NEW_DIRECTORY_NAME>
   ```

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

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

   ```
   cp <FILE_NAME> <NEW_DIRECTORY_NAME>
   ```

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

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

   ```
   cp -r <DIRECTORY_NAME> <NEW_DIRECTORY_NAME>
   ```

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

1. 導覽到新目錄，並使用下列命令將目錄初始化為 Git 儲存庫。如需詳細資訊，請參閱 [git-init 文件](https://git-scm.com/docs/git-init)。

   ```
   cd <NEW_DIRECTORY_NAME>
   git init
   ```

1. 使用 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 `。

1. 將遞交推送至遠端儲存庫。此儲存庫的格式為 `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 Lab 成品匯入至 Studio Classic
<a name="studio-lab-use-migrate-step3"></a>

下列程序展示如何將成品匯入至 Studio Classic。透過主控台使用特徵存放區的指示取決於您是否已啟用 Studio 或 Studio Classic 作為預設體驗。如需透過主控台存取 Studio Classic 的資訊，請參閱[如果 Studio 是您的預設體驗，請啟動 Studio Classic](studio-launch.md#studio-launch-console-updated)。

從 Studio Classic 中，您可以從本機電腦或從 Git 儲存庫匯入檔案。您可以使用 Studio Classic GUI 或終端機執行此動作。下列程序使用 [步驟 2：儲存 Studio Lab 成品](#studio-lab-use-migrate-step2) 的範例。

------
#### [ Import using the Studio Classic GUI ]

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

1. 開啟 Studio Classic 左上方的**檔案瀏覽器** (![\[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. 選擇**檔案瀏覽器**面板頂端功能表上的**上傳檔案**圖示 (![\[Black square icon representing a placeholder or empty image.\]](http://docs.aws.amazon.com/zh_tw/sagemaker/latest/dg/images/icons/File_upload_squid.png))。

1. 導覽至您要匯入的檔案，然後選擇**開啟**。

**注意**  
若要將目錄匯入至 Studio Classic，首先請將本機電腦上的目錄壓縮至檔案。在 Mac 中，在目錄上按一下滑鼠右鍵，然後選擇**壓縮 "*<DIRECTORY\$1NAME>*"**。在 Windows 中，在目錄上按一下滑鼠右鍵，選擇**傳送到**，然後選擇**壓縮的 (已壓縮) 資料夾**。壓縮目錄之後，請使用上述步驟匯入已壓縮的檔案。透過導覽到 Studio Classic 終端機並執行命令 `<DIRECTORY_NAME>.zip` 來解壓縮已壓縮的檔案。

------
#### [ Import using a Git repository ]

此範例提供如何將 GitHub 儲存庫複製至 Studio 的兩個選項。您可以透過選擇 Studio Classic 左側的 **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)) 索引標籤來使用 Studio Classic GUI。選擇**複製儲存庫**，然後從 [步驟 2：儲存 Studio Lab 成品](#studio-lab-use-migrate-step2) 貼上您的 GitHub 儲存庫 URL。另一個選項是使用下列程序來使用 Studio Classic 終端機。

1. 開啟 Studio Classic **啟動器**。如需開啟**啟動器**的詳細資訊，請參閱 [Amazon SageMaker Studio Classic 啟動器](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-launcher.html)。

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

1. 在 Studio Classic 中，開啟**啟動器**。若要開啟**啟動器**，請選擇 Studio Classic 左上角的 **Amazon SageMaker Studio Classic**。

   若要了解開啟**啟動器**的所有可用方法，請參閱[使用 Amazon SageMaker Studio Classic 啟動器](studio-launcher.md)。

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

1. 在 Studio Classic **啟動器**中，選擇**開啟映像終端機**。

1. 從映像終端機，執行下列命令以複製儲存庫。此命令會在您的 Studio Classic 執行個體中建立以 `<REPOSITORY_NAME>` 命名的目錄，並複製該儲存庫中的成品。

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

------

## 步驟 4：在 Studio Classic 中安裝您的 Studio Lab Conda 環境
<a name="studio-lab-use-migrate-step4"></a>

您現在可以在 Studio Classic 執行個體中使用 YAML 檔案來重新建立您的 Conda 環境。開啟 Studio Classic **啟動器**。如需開啟**啟動器**的詳細資訊，請參閱 [Amazon SageMaker Studio Classic 啟動器](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-launcher.html)。從**啟動器**中，選擇**開啟映像終端機**。在終端機中，導覽至包含 YAML 檔案的目錄，然後執行下列命令。

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

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