將 Amazon SageMaker Studio Lab 環境匯出至 Amazon SageMaker Studio Classic - Amazon SageMaker AI
步驟 1：匯出 Studio Lab Conda 環境步驟 2：儲存 Studio Lab 成品步驟 3：將 Studio Lab 成品匯入 Studio Classic步驟 4：在 Studio Classic 中安裝您的 Studio Lab conda 環境

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

將 Amazon SageMaker Studio Lab 環境匯出至 Amazon SageMaker Studio Classic

Amazon SageMaker Studio Classic 為機器學習和深度學習工作流程提供許多功能，這些功能在 Amazon SageMaker Studio Lab 中無法使用。此頁面說明如何將 Studio Lab 環境遷移至 Studio Classic，以利用更多運算容量、儲存體和功能。不過，您可能想要熟悉 Studio Classic 預先建置的容器，這些容器針對完整的 MLOP 管道進行最佳化。如需詳細資訊，請參閱 Amazon SageMaker Studio Lab

若要將 Studio Lab 環境遷移至 Studio Classic，您必須先依照中的步驟加入 Studio ClassicAmazon SageMaker AI 網域概觀。

步驟 1：匯出 Studio Lab Conda 環境

透過遵循 管理您的環境 中的步驟，您可以匯出 Conda 環境，並將程式庫或套件新增至環境。下列範例示範使用要匯出至 Studio Classic default的環境。

  1. 開啟檔案瀏覽器面板 () 以開啟 Studio Lab 終端機 Black square icon representing a placeholder or empty image. ，在檔案瀏覽器頂端的選單上選擇加號 (＋) 以開啟啟動器，然後選擇終端機。從 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環境有許多套件的不相容版本。

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

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

步驟 2：儲存 Studio Lab 成品

現在您已將環境儲存於 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. )，使檔案瀏覽器面板顯示在左側。

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

  3. 選擇 (按一下滑鼠右鍵) myenv.yml 檔案，然後選擇下載。您可以針對要匯入 Studio Classic 的其他檔案重複此程序。

Save to a Git repository

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

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

    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 Lab 成品匯入 Studio Classic

下列程序說明如何將成品匯入 Studio Classic。透過主控台使用 Feature Store 的指示取決於您是否已啟用 Studio 或 Studio Classic 做為預設體驗。如需透過主控台存取 Studio Classic 的資訊，請參閱如果 Studio 是您的預設體驗，請啟動 Studio Classic。

從 Studio Classic，您可以從本機機器或從 Git 儲存庫匯入檔案。您可以使用 Studio Classic GUI 或終端機來執行此操作。下列程序使用 步驟 2：儲存 Studio Lab 成品 的範例。

Import using the Studio Classic GUI

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

  1. 開啟 Studio Classic 左上角的檔案瀏覽器面板 ( Black square icon representing a placeholder or empty image. )。

  2. 在檔案瀏覽器面板頂端的功能表上，選擇上傳檔案圖示 ( Black square icon representing a placeholder or empty image. )。

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

注意

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

Import using a Git repository

此範例提供兩個選項，說明如何將 GitHub 儲存庫複製到 Studio Classic。您可以選擇 Studio Classic 左側的 Git ( Black square icon representing a placeholder or empty image. ) 索引標籤，以使用 Studio Classic GUI。選擇複製儲存庫，然後從 步驟 2：儲存 Studio Lab 成品 貼上您的 GitHub 儲存庫 URL。另一個選項是使用 Studio Classic 終端機，方法是使用下列程序。

  1. 開啟 Studio Classic Launcher。如需開啟啟動器的詳細資訊，請參閱 Amazon SageMaker Studio Classic Launcher。

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

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

    若要了解開啟啟動器的所有可用方法，請參閱使用 Amazon SageMaker Studio Classic Launcher。

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

  5. 在 Studio Classic Launcher 中，選擇開啟映像終端機。

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

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

步驟 4：在 Studio Classic 中安裝您的 Studio Lab conda 環境

您現在可以在 Studio Classic 執行個體中使用 YAML 檔案重新建立您的 conda 環境。開啟 Studio Classic Launcher。如需開啟啟動器的詳細資訊，請參閱 Amazon SageMaker Studio Classic Launcher。從啟動器中，選擇開啟映像終端機。在終端機中，導覽至包含 YAML 檔案的目錄，然後執行下列命令。

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

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