View a markdown version of this page

在 Studio 中建立和自動掛載 Amazon EFS - Amazon SageMaker AI

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

在 Studio 中建立和自動掛載 Amazon EFS

Amazon SageMaker AI 支援為網域建立 Amazon EFS 磁碟區，並自動為每個使用者掛載主目錄資料夾。使用此資料夾，使用者可以在自己的私有空間之間共用資料。不過，使用者無法與網域中的其他使用者共用資料。使用者只能存取自己的資料夾。

重要

對於 2026 年 6 月 1 日之後建立的網域，預設不會在網域建立期間建立 EFS （用於快速設定）。您必須先啟用 EFS 建立，才能啟用自動掛載。

EFS 建立和自動掛載設定

Amazon SageMaker Studio 中的 EFS 包含兩個可一起運作的設定：

  • HomeEFSCreation – 控制 EFS 檔案系統是否由網域的 SageMaker AI 建立和管理。

    透過快速設定建立新網域的預設值：已停用

    啟用時：為此網域建立新的由 SageMaker AI 管理的 EFS 檔案系統。

  • AutoMountHomeEFS – 控制是否自動掛載使用者的 EFS 儲存體。

    預設：已啟用 （啟用 HomeEFSCreation 時）

    描述：自動掛載每個使用者的主目錄，以便在其私有空間之間共用筆記本、資料和程式碼。

    只有在啟用 HomeEFSCreation 時，才能編輯此設定。

    在使用者設定檔層級，此值預設為 DefaultAsDomain （繼承網域層級設定）。

關鍵行為：

  • 如果未設定 的值AutoMountHomeEFS，則預設會啟用自動掛載 EFS。

  • 如果您有現有的空間，請重新啟動空間來掛載 EFS。

  • 自動掛載 EFS 僅適用於私有空間。

啟用 EFS 建立和自動掛載

建立網域後 （快速設定）：

  1. 開啟 SageMaker AI 主控台。

  2. 在左側導覽窗格的管理員組態下，選擇網域。

  3. 選取您的網域，然後選擇網域設定索引標籤。

  4. 在儲存組態區段中，選擇編輯。

  5. 在 EFS 儲存和加密下，切換HomeEFSCreation到開啟。這會為此網域建立由 SageMaker AI 管理的新 EFS 檔案系統。

  6. 確定 AutoMountHomeEFS 已切換為開啟 （預設為HomeEFSCreation在開啟 時啟用）。這會自動掛載每個使用者的主目錄，以便在其私有空間之間共用筆記本、資料和程式碼。

  7. 選擇提交。

  8. 如果您有現有的空間，請重新啟動它們來存取 EFS 資料。

對於自訂設定，預設會啟用 EFS 建立和自動掛載。

使用者資料夾可透過名為 user-default-efs 的資料夾存取。此資料夾存在於 Studio 應用程式的 $HOME 目錄中。

如需選擇退出 Amazon EFS 自動掛載的相關資訊，請參閱選擇退出 Amazon EFS 自動掛載。

Amazon EFS 自動掛載也有助於將資料從 Studio Classic 遷移至 Studio。如需詳細資訊，請參閱(選用) 將資料從 Studio Classic 遷移至 Studio。

存取點資訊

啟用自動掛載時，SageMaker AI 會使用 Amazon EFS 存取點，來協助存取 Amazon EFS 磁碟區中的資料。如需存取點的詳細資訊，請參閱使用 Amazon EFS 存取點。SageMaker AI 會在建立使用者設定檔期間或在為現有使用者設定檔建立應用程式期間，為網域中的每個使用者設定檔建立唯一的存取點。存取點的 POSIX 使用者值符合 SageMaker AI 為其建立存取點之使用者設定檔的 HomeEfsFileSystemUid 值。若要取得使用者的值，請參閱 DescribeUserProfile。根目錄路徑也會設定為與 POSIX 使用者值相同的值。 

SageMaker AI 會將新目錄的許可設定為下列值：

  • 擁有者使用者 ID：POSIX user value

  • 擁有者群組 ID：0

  • 許可 700

存取 Amazon EFS 磁碟區需要存取點。因此，您無法刪除或更新存取點，而不會失去對 Amazon EFS 磁碟區的存取。

錯誤解決

如果在建立應用程式期間自動掛載 Amazon EFS 使用者資料夾時 SageMaker AI 遇到問題，則仍會建立應用程式。不過，在此情況下，SageMaker AI 會建立名為 error.txt 的檔案，而不是掛載 Amazon EFS 資料夾。此檔案描述遇到的錯誤，以及解決該錯誤的步驟。SageMaker AI 會在位於應用程式 $HOME 目錄的 user-default-efs 資料夾中建立 error.txt 檔案。