Hinzufügen eines benutzerdefinierten Dateisystems zu einer Domain - Amazon SageMaker KI
VoraussetzungenZu einer Domain hinzufügenAn ein Leerzeichen anhängen

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.

Hinzufügen eines benutzerdefinierten Dateisystems zu einer Domain

Wenn Sie eine Domain erstellen, fügt Amazon SageMaker AI der Domain ein Standardvolume Amazon Elastic File System (Amazon EFS) hinzu. SageMaker AI erstellt dieses Volume für Sie. Sie haben auch die Möglichkeit, ein benutzerdefiniertes Amazon EFS- oder ein benutzerdefiniertes Amazon FSx for Lustre-Dateisystem hinzuzufügen, das Sie erstellt haben. Nachdem Sie es hinzugefügt haben, ist Ihr Dateisystem für Benutzer verfügbar, die zu Ihrer Domain gehören. Ihre Benutzer können auf das Dateisystem zugreifen, wenn sie Amazon SageMaker Studio verwenden. Sie können das Dateisystem an Bereiche anhängen, die sie für die folgenden unterstützten Anwendungen erstellen:

  • JupyterLab

  • Code-Editor

Nachdem Sie einen Space ausgeführt und die Anwendung gestartet haben, können Ihre Benutzer auf alle Daten, Codes oder andere Artefakte zugreifen, die Ihr Dateisystem enthält.

Sie können Ihren Benutzern auf folgende Weise den Zugriff auf Ihr Dateisystem ermöglichen:

  • Über gemeinsam genutzte Bereiche — Ein gemeinsam genutzter Bereich kann von jedem Benutzer erstellt werden, der zu Ihrer Domain gehört. Anschließend kann er von jedem Benutzer verwendet werden, der zu Ihrer Domain gehört.

  • Über private Bereiche — Ein privater Bereich kann von jedem Benutzer erstellt werden, der zu Ihrer Domain gehört. Dann kann er nur von diesem Benutzer verwendet werden.

  • Ausschließlich als einzelner Benutzer — Wenn Sie nicht allen Benutzern den Zugriff auf das Dateisystem ermöglichen möchten, können Sie nur einem bestimmten Benutzer den Zugriff darauf ermöglichen. Wenn Sie das tun, ist das Dateisystem nur in privaten Bereichen verfügbar, die der jeweilige Benutzer erstellt.

Sie können ein benutzerdefiniertes Dateisystem hinzufügen, indem Sie die SageMaker Amazon-API AWS SDKs, die oder die verwenden AWS CLI. Sie können kein benutzerdefiniertes Dateisystem mithilfe der SageMaker AI-Konsole hinzufügen.

Voraussetzungen

Bevor Sie einer Domain ein benutzerdefiniertes Dateisystem hinzufügen können, müssen Sie die folgenden Anforderungen erfüllen:

  • Sie haben eine Domain in SageMaker AI. Bevor Sie ein Dateisystem hinzufügen können, benötigen Sie die Domain-ID. Sie können die ID mithilfe der SageMaker AI-Konsole nachschlagen. Sie können den list-domainsBefehl auch mit dem ausführen AWS CLI.

  • Sie haben ein Amazon EFS- oder FSx for Lustre-Dateisystem in Ihrem AWS-Konto.

    Für Amazon EFS:

    • Die Schritte zum Erstellen eines Amazon EFS finden Sie unter Erstellen Sie Ihr Amazon EFS-Dateisystem im Amazon Elastic File System-Benutzerhandbuch.

    • Bevor Studio auf Ihr Dateisystem zugreifen kann, muss es in jedem der Subnetze, die Sie der Domain zuordnen, ein Mount-Ziel haben. Weitere Informationen zum Zuweisen von Mount-Zielen zu Subnetzen finden Sie unter Erstellen und Verwalten von Mount-Zielen und Sicherheitsgruppen im Amazon Elastic File System-Benutzerhandbuch.

    • Für jedes Mount-Ziel müssen Sie die Sicherheitsgruppe hinzufügen, die Amazon SageMaker AI bei der Erstellung der Domain in Ihrem AWS-Konto erstellt hat. Der Name der Sicherheitsgruppe hat das Formatsecurity-group-for-inbound-nfs-domain-id.

    • Ihre IAM-Berechtigungen müssen es Ihnen ermöglichen, die elasticfilesystem:DescribeMountTargets Aktion zu verwenden. Weitere Informationen zu dieser Aktion finden Sie unter Aktionen, Ressourcen und Bedingungsschlüssel für Amazon Elastic File System in der Service Authorization Reference.

    FSx Für Lustre:

    • Die Schritte zum Erstellen eines FSx for Lustre finden Sie unter Erste Schritte mit Amazon FSx for Lustre im Amazon FSx for Lustre-Benutzerhandbuch.

    • Stellen Sie sicher, dass das FSx for Lustre-Dateisystem in derselben VPC wie Ihre Domain und in einem der Subnetze in der Domain vorhanden ist.

    • Bevor Studio auf das FSx for Lustre-Dateisystem zugreifen kann, müssen Sie das gesamte ENIs for Lustre-Dateisystem SecurityGroupIdForInboundNfs anhängen. FSx Dazu können Sie in der Konsole das Dateisystem FSx für Lustre aufrufen und To see all the ENIs, see the Amazon EC2 console dort klicken, wo Sie alle ENIs angehängten Dateien für Lustre sehen können. FSx

      Alternativ finden ENIs Sie auch eine Verbindung zu FSx for Lustre via AWS CLI oder API, indem Sie die API aufrufen. fsx:describeFileSystems Für jede ENI von FSx for Lustre müssen Sie die Sicherheitsgruppe hinzufügen, die Amazon SageMaker AI bei der Erstellung der Domain in Ihrer AWS-Konto erstellt hat. Der Name der Sicherheitsgruppe hat das Formatsecurity-group-for-inbound-nfs-domain-id. Ohne diesen Schritt schlägt die App-Erstellung mit einem Kundenfehler fehl.

Hinzufügen eines benutzerdefinierten Dateisystems zu einer Domain mit AWS CLI

Um einer Domäne oder einem Benutzerprofil mit dem ein benutzerdefiniertes Dateisystem hinzuzufügen AWS CLI, übergeben Sie eine CustomFileSystemConfigs Definition, wenn Sie einen der folgenden Befehle verwenden:

Die folgenden Beispiele zeigen, wie ein Dateisystem zu einer vorhandenen Domäne oder einem vorhandenen Benutzerprofil hinzugefügt wird.

Um ein Dateisystem hinzuzufügen, auf das in gemeinsam genutzten Bereichen zugegriffen werden kann

  • Aktualisieren Sie die Standardeinstellungen für den Speicherplatz für Ihre Domain. Im folgenden Beispiel werden die Dateisystemeinstellungen zu den standardmäßigen Speichereinstellungen hinzugefügt:

    aws sagemaker update-domain --domain-id domain-id \
--default-space-settings file://file-system-settings.json

    In diesem Beispiel wird die Dateisystemkonfiguration als JSON-Datei übergeben, was in einem späteren Beispiel gezeigt wird.

Um ein Dateisystem hinzuzufügen, auf das in privaten Bereichen zugegriffen werden kann

  • Aktualisieren Sie die Standardbenutzereinstellungen für Ihre Domain. Im folgenden Beispiel werden die Dateisystemeinstellungen zu den Standardbenutzereinstellungen hinzugefügt:

    aws sagemaker update-domain --domain-id domain-id \
--default-user-settings file://file-system-settings.json

    In diesem Beispiel wird die Dateisystemkonfiguration als JSON-Datei übergeben, was in einem späteren Beispiel gezeigt wird.

Um ein Dateisystem hinzuzufügen, auf das nur ein einzelner Benutzer zugreifen kann

  • Aktualisieren Sie das Benutzerprofil für den Benutzer. Im folgenden Beispiel werden die Dateisystemeinstellungen zu einem Benutzerprofil hinzugefügt:

    aws sagemaker update-user-profile --domain-id domain-id \
--user-profile-name user-profile-name \
--user-settings file://file-system-settings.json

    In diesem Beispiel wird die Dateisystemkonfiguration als JSON-Datei übergeben, was im folgenden Beispiel gezeigt wird.

Beispiel Datei mit Dateisystem-Einstellungen

Die Datei in den vorherigen Beispielen,file-system-settings.json, hat die folgenden Einstellungen:

For your FSx for Lustre file systems
{
    "CustomFileSystemConfigs":
    [
        {
            "FSxLustreFileSystemConfig":
            {
              "FileSystemId": "file-system-id",
              "FileSystemPath": "/"
            }
        }
    ]
}

Diese Beispielkonfiguration hat die folgenden Schlüssel:

CustomFileSystemConfigs

Einstellungen für benutzerdefinierte Dateisysteme (nur Amazon EFS-Dateisysteme werden unterstützt).

FSxLustreFileSystemConfig

Einstellungen für benutzerdefinierte Dateisysteme FSx für Lustre-Dateisysteme.

FileSystemId

Die ID Ihres Amazon EFS-Dateisystems.

FileSystemPath

Der Pfad zum Dateisystemverzeichnis, auf das die Domänenbenutzer in ihren Bereichen in Studio zugreifen können. Zulässige Benutzer können nur auf dieses Verzeichnis und darauf zugreifen. Der Standardpfad ist das Dateisystem-Stammverzeichnis:/.

For your Amazon EFS file systems
{
    "CustomFileSystemConfigs":
    [
        {
            "EFSFileSystemConfig":
            {
                "FileSystemId": "file-system-id",
                "FileSystemPath": "/"
            }
        }
    ]
}

Diese Beispielkonfiguration hat die folgenden Schlüssel:

CustomFileSystemConfigs

Einstellungen für benutzerdefinierte Dateisysteme (nur Amazon EFS-Dateisysteme werden unterstützt).

EFSFileSystemConfig

Einstellungen für benutzerdefinierte Amazon EFS-Dateisysteme.

FileSystemId

Die ID Ihres Amazon EFS-Dateisystems.

FileSystemPath

Der Pfad zum Dateisystemverzeichnis, auf das die Domänenbenutzer in ihren Bereichen in Studio zugreifen können. Zulässige Benutzer können nur auf dieses Verzeichnis und darauf zugreifen. Der Standardpfad ist das Dateisystem-Stammverzeichnis:/.

Wenn Sie den standardmäßigen Speichereinstellungen für eine Domäne ein Dateisystem zuweisen, müssen Sie auch die Ausführungsrolle in die Einstellungen aufnehmen:

{
    "ExecutionRole": "execution-role-arn"
}

Diese Beispielkonfiguration hat den folgenden Schlüssel:

ExecutionRole

Die standardmäßige Ausführungsrolle für die Benutzer der Domain.

Wenn Sie POSIX-Berechtigungen für Ihr Dateisystem anwenden möchten, können Sie auch die folgenden Einstellungen an die create-user-profile Befehle create-domain oder übergeben:

{
    "CustomPosixUserConfig":
    {
        "Uid": UID,
        "Gid": GID
    }
}

Diese Beispielkonfiguration hat die folgenden Schlüssel:

CustomPosixUserConfig

Die POSIX-Standardidentitäten, die für Dateisystemoperationen verwendet werden. Sie können diese Einstellungen verwenden, um Ihre bestehende POSIX-Berechtigungsstruktur auf die Benutzerprofile anzuwenden, die auf das benutzerdefinierte Dateisystem zugreifen. Auf POSIX-Berechtigungsebene können Sie steuern, welche Benutzer auf das Dateisystem zugreifen können und auf welche Dateien oder Daten sie zugreifen können.

Sie können CustomPosixUserConfig Einstellungen auch anwenden, wenn Sie ein Benutzerprofil erstellen, indem Sie den create-user-profile Befehl verwenden. Die Einstellungen, die Sie auf ein Benutzerprofil anwenden, haben Vorrang vor denen, die Sie auf die zugehörige Domäne anwenden.

Anmerkung

Sie können CustomPosixUserConfig Einstellungen anwenden, wenn Sie die create-user-profile Befehle create-domain und verwenden. Sie können diese Einstellungen jedoch nicht anwenden, wenn Sie wie folgt vorgehen:

  • Verwenden Sie den update-domain Befehl für eine Domäne, die bereits mit Benutzerprofilen verknüpft ist. Sie können diese Einstellungen nur auf Domänen anwenden, die keine Benutzerprofile haben.

  • Verwenden Sie den update-user-profile-Befehl. Um diese Einstellungen auf ein Profil anzuwenden, das Sie bereits erstellt haben, löschen Sie das Profil und erstellen Sie ein neues Profil mit den aktualisierten Einstellungen.

Uid

Die POSIX-Benutzer-ID. Die Standardeinstellung ist 200001.

Gid

Die POSIX-Gruppen-ID. Die Standardeinstellung ist 1001.

Ein benutzerdefiniertes Dateisystem an einen Space anhängen mit AWS CLI

Nachdem Sie einer Domäne ein benutzerdefiniertes Dateisystem hinzugefügt haben, können die Domänenbenutzer das Dateisystem an von ihnen erstellte Bereiche anhängen. Sie können beispielsweise das Dateisystem anhängen, wenn sie Studio oder den Befehl create-space mit dem verwenden. AWS CLI

Um ein benutzerdefiniertes Dateisystem an einen Space anzuhängen

  • Fügen Sie die Dateisystemkonfiguration zu den Speichereinstellungen hinzu. Mit dem folgenden Beispielbefehl wird ein Dateisystem an einen neuen Bereich angehängt.

    aws sagemaker create-space \
--space-name space-name \
--domain-id domain-id \
--ownership-settings "OwnerUserProfileName=user-profile-name" \
--space-sharing-settings "SharingType=Private" \
--space-settings file://space-settings.json

    In diesem Beispiel space-settings.json hat die Datei die folgenden Einstellungen, zu denen auch die CustomFileSystems Konfiguration mit dem FileSystemId Schlüssel gehört.

    For your FSx for Lustre file systems
    {
    "AppType": "JupyterLab",
    "JupyterLabAppSettings":
    {
        "DefaultResourceSpec":
        {
          "InstanceType": "instance-type"
        }
    },
    "CustomFileSystems":
    [
        {
            "FSxLustreFileSystem":
            {
              "FileSystemId": "file-system-id"
            }
        }
    ]
}
    For your Amazon EFS file systems
    {
    "AppType": "JupyterLab",
    "JupyterLabAppSettings":
    {
        "DefaultResourceSpec":
        {
            "InstanceType": "instance-type"
        }
    },
    "CustomFileSystems":
    [
        {
            "EFSFileSystem":
            {
                "FileSystemId": "file-system-id"
            }
        }
    ]
}

    SageMaker AI erstellt einen symbolischen Link unter dem folgenden Pfad:/home/sagemaker-user/custom-file-systems/file-system-type/file-system-id. Damit können die Domain-Benutzer von ihrem Home-Verzeichnis aus zum benutzerdefinierten Dateisystem navigieren/home/sagemaker-user.