View a markdown version of this page

Amazon EFS-Erstellung und automatisches Mounten in Studio - Amazon SageMaker KI

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon EFS-Erstellung und automatisches Mounten in Studio

Amazon SageMaker AI unterstützt das Erstellen eines Amazon EFS-Volumes für eine Domain und das automatische Mounten eines Home-Verzeichnisordners für jeden Benutzer. Mithilfe dieses Ordners können Benutzer Daten zwischen ihren eigenen privaten Bereichen austauschen. Benutzer können jedoch keine Daten mit anderen Benutzern in der Domain teilen. Benutzer haben nur Zugriff auf ihren eigenen Ordner.

Wichtig

Für Domains, die nach dem 1. Juni 2026 erstellt wurden, wird EFS bei der Domain-Erstellung standardmäßig nicht erstellt (zur schnellen Einrichtung). Sie müssen die EFS-Erstellung aktivieren, bevor das automatische Mounten aktiviert werden kann.

Einstellungen für EFS-Erstellung und automatisches Mounten

EFS in Amazon SageMaker Studio umfasst zwei Einstellungen, die zusammenarbeiten:

  • HomeEFSCreation— Steuert, ob ein EFS-Dateisystem von der SageMaker KI für die Domain erstellt und verwaltet wird.

    Standard für neue Domänen, die über die Schnelleinrichtung erstellt wurden: Deaktiviert

    Wenn aktiviert: Erstellt ein neues EFS-Dateisystem, das von SageMaker AI für diese Domain verwaltet wird.

  • AutoMountHomeEFS— Steuert, ob der EFS-Speicher automatisch für Benutzer bereitgestellt wird.

    Standard: Aktiviert (wenn aktiviert HomeEFSCreation ist)

    Beschreibung: Auto-mounts Ein Home-Verzeichnis, in dem jeder Benutzer Notizbücher, Daten und Code in seinen privaten Bereichen gemeinsam nutzen kann.

    Diese Einstellung kann nur bearbeitet werden, wenn sie aktiviert HomeEFSCreation ist.

    Auf Benutzerprofilebene ist dieser Wert standardmäßig auf DefaultAsDomain (erbt die Einstellung auf Domänenebene).

Wichtigste Verhaltensweisen:

  • Wenn kein Wert für festgelegt istAutoMountHomeEFS, ist EFS automatisch mounten standardmäßig aktiviert.

  • Wenn bereits ein Speicherplatz vorhanden ist, starten Sie den Bereich neu, um EFS zu mounten.

  • Auto-mount EFS ist nur für private Bereiche verfügbar.

Aktivieren Sie die EFS-Erstellung und das automatische Mounten

Nach der Domainerstellung (schnelle Einrichtung):

  1. Öffnen Sie die SageMaker AI-Konsole.

  2. Wählen Sie im linken Navigationsbereich unter Admin-Konfigurationen die Option Domains aus.

  3. Wählen Sie Ihre Domain aus und wählen Sie dann den Tab Domain-Einstellungen.

  4. Wählen Sie im Abschnitt Speicherkonfigurationen die Option Bearbeiten aus.

  5. Schalten Sie unter EFS-Speicher und Verschlüsselung HomeEFSCreation auf EIN. Dadurch wird ein neues EFS-Dateisystem erstellt, das von SageMaker AI für diese Domäne verwaltet wird.

  6. Stellen AutoMountHomeEFS Sie sicher, dass die Option ON aktiviert HomeEFSCreation ist (standardmäßig aktiviert, wenn aktiviert). Dadurch wird automatisch ein Home-Verzeichnis für jeden Benutzer bereitgestellt, um Notizbücher, Daten und Code in seinen privaten Bereichen gemeinsam nutzen zu können.

  7. Wählen Sie Absenden aus.

  8. Wenn Sie bereits Spaces haben, starten Sie sie neu, um auf EFS-Daten zuzugreifen.

Für das benutzerdefinierte Setup sind die EFS-Erstellung und das automatische Mounten standardmäßig aktiviert.

Auf den Ordner des Benutzers kann über einen Ordner mit dem Namen user-default-efs zugegriffen werden. Dieser Ordner befindet sich im $HOME-Verzeichnis der Studio-Anwendung.

Informationen zum Deaktivieren vom automatischen Mounting von Amazon EFS finden Sie unter Deaktivieren des automatischen Mountings von Amazon EFS.

Die automatische Bereitstellung von Amazon EFS erleichtert auch die Migration von Daten von Studio Classic zu Studio. Weitere Informationen finden Sie unter (Optional) Migrieren von Daten von Studio Classic zu Studio.

Informationen zum Zugangspunkt

Wenn das automatische Mounten aktiviert ist, verwendet SageMaker AI einen Amazon EFS-Zugangspunkt, um den Zugriff auf die Daten im Amazon EFS-Volume zu erleichtern. Weitere Informationen zu Access Points finden Sie unter Arbeiten mit Amazon EFS-Zugriffspunkten. SageMaker KI erstellt bei der Erstellung eines Benutzerprofils oder bei der Anwendungserstellung für ein vorhandenes Benutzerprofil einen eindeutigen Zugriffspunkt für jedes Benutzerprofil in der Domain. Der POSIX-Benutzerwert des Access Points entspricht dem HomeEfsFileSystemUid Wert des Benutzerprofils, für das SageMaker AI den Access Point erstellt. Informationen zum Abrufen des Benutzerwerts finden Sie unter DescribeUserProfile. Der Stammverzeichnispfad ist ebenfalls auf denselben Wert wie der POSIX-Benutzerwert gesetzt. 

SageMaker AI setzt die Berechtigungen des neuen Verzeichnisses auf die folgenden Werte:

  • Benutzer-ID des Eigentümers: POSIX user value

  • Gruppen-ID des Eigentümers: 0

  • Berechtigungen 700

Der Zugangspunkt ist für den Zugriff auf das Amazon-EFS-Volume erforderlich. Daher können Sie den Zugangspunkt nicht löschen oder aktualisieren, ohne den Zugriff auf das Amazon-EFS-Volume zu verlieren.

Fehlerbehebung

Wenn SageMaker AI beim automatischen Mounten des Amazon EFS-Benutzerordners während der Anwendungserstellung auf ein Problem stößt, wird die Anwendung trotzdem erstellt. In diesem Fall erstellt SageMaker AI jedoch eine Datei mit dem Namen, error.txt anstatt den Amazon EFS-Ordner einzubinden. Diese Datei beschreibt den aufgetretenen Fehler sowie die Schritte zu seiner Behebung. SageMaker AI erstellt die error.txt Datei in dem user-default-efs Ordner, der sich im $HOME Verzeichnis der Anwendung befindet.