Hängen Sie das SageMaker Bild an eine Domain an Hängen Sie das SageMaker Bild an einen gemeinsam genutzten Bereich an Sehen Sie sich das angehängte Image an

Hängen Sie ein benutzerdefiniertes SageMaker Bild an

Wichtig

Benutzerdefinierte IAM Richtlinien, die es Amazon SageMaker Studio oder Amazon SageMaker Studio Classic ermöglichen, SageMaker Amazon-Ressourcen zu erstellen, müssen auch Berechtigungen zum Hinzufügen von Tags zu diesen Ressourcen gewähren. Die Berechtigung zum Hinzufügen von Tags zu Ressourcen ist erforderlich, da Studio und Studio Classic automatisch alle von ihnen erstellten Ressourcen taggen. Wenn eine IAM Richtlinie Studio und Studio Classic das Erstellen von Ressourcen, aber kein Taggen erlaubt, können "AccessDenied" Fehler auftreten, wenn versucht wird, Ressourcen zu erstellen. Weitere Informationen finden Sie unter Stellen Sie Berechtigungen für das Taggen von Ressourcen SageMaker bereit.

AWS Verwaltete Richtlinien für Amazon SageMakerdie Berechtigungen zum Erstellen von SageMaker Ressourcen gewähren, beinhalten bereits Berechtigungen zum Hinzufügen von Tags beim Erstellen dieser Ressourcen.

Wichtig

Seit dem 30. November 2023 heißt das vorherige Amazon SageMaker Studio-Erlebnis jetzt Amazon SageMaker Studio Classic. Der folgende Abschnitt bezieht sich speziell auf die Verwendung der Studio Classic-Anwendung. Informationen zur Verwendung der aktualisierten Studio-Oberfläche finden Sie unterAmazon SageMaker Studio.

Um ein benutzerdefiniertes SageMaker Image zu verwenden, müssen Sie eine Version des Images an Ihre Domain oder Ihren gemeinsam genutzten Bereich anhängen. Wenn Sie eine Image-Version anhängen, wird sie im SageMaker Studio Classic Launcher angezeigt und ist in der Dropdownliste Bild auswählen verfügbar, mit der Benutzer eine Aktivität starten oder das von einem Notizbuch verwendete Bild ändern können.

Um ein benutzerdefiniertes SageMaker Bild für alle Benutzer innerhalb einer Domain verfügbar zu machen, hängen Sie das Bild an die Domain an. Um ein Image für alle Benutzer in einem gemeinsam genutzten Bereich verfügbar zu machen, können Sie das Image an den gemeinsam genutzten Bereich anhängen. Um ein Image für einen einzelnen Benutzer verfügbar zu machen, hängen Sie das Image an das Profil des Benutzers an. Wenn Sie ein Bild anhängen, SageMaker wird standardmäßig die neueste Image-Version verwendet. Sie können auch eine bestimmte Image-Version anhängen. Nachdem Sie die Version angehängt haben, können Sie die Version im SageMaker Launcher oder in der Bildauswahl auswählen, wenn Sie ein Notizbuch starten.

Die Anzahl der Image-Versionen, die zu einem bestimmten Zeitpunkt angehängt werden können, ist eingeschränkt. Wenn Sie das Limit erreicht haben, müssen Sie eine Version trennen, um eine weitere Version des Images anzuhängen.

In den folgenden Abschnitten wird gezeigt, wie Sie mithilfe der SageMaker Konsole oder der ein benutzerdefiniertes SageMaker Image an Ihre Domain anhängen. AWS CLI Sie können ein benutzerdefiniertes Image nur über AWS CLI an einen Freigabebereich anhängen.

Hängen Sie das SageMaker Bild an eine Domain an

Hängen Sie das SageMaker Bild mithilfe der Konsole an

In diesem Thema wird beschrieben, wie Sie über das SageMaker Control Panel eine vorhandene benutzerdefinierte SageMaker Image-Version an Ihre Domain anhängen können. Sie können auch ein benutzerdefiniertes SageMaker Bild und eine Imageversion erstellen und diese Version dann an Ihre Domain anhängen. Informationen zum Erstellen eines Images und einer Image-Version finden Sie unter Erstellen Sie ein benutzerdefiniertes SageMaker Bild.

Um ein vorhandenes Image anzuhängen

Öffnen Sie die SageMaker Amazon-Konsole unter https://console.aws.amazon.com/sagemaker/.
Wählen Sie im linken Navigationsbereich Admin-Konfigurationen.
Wählen Sie unter Admin-Konfigurationen die Option Domains aus.
Wählen Sie auf der Seite Domains die Domain aus, an die das Bild angehängt werden soll.
Wählen Sie auf der Seite mit den Domaindetails die Registerkarte Umgebung aus.
Wählen Sie auf der Registerkarte Umgebung unter Custom SageMaker Studio Classic-Images, die an die Domain angehängt sind, die Option Bild anhängen aus.
Wählen Sie als Image-Quelle die Option Bestehendes Image aus.
Wählen Sie einen vorhandenen Benutzer aus der Liste aus.
Wählen Sie eine Version des Images aus der Liste aus.
Wählen Sie Weiter.
Überprüfen Sie die Werte für Image-Name, Image-Aanzeigename und Beschreibung.
Wählen Sie die IAM Rolle aus. Weitere Informationen finden Sie unter Erstellen Sie ein benutzerdefiniertes SageMaker Bild.
(Optional) Fügen Sie Tags für das Image hinzu.
Geben Sie den EFS Bereitstellungspfad an. Dies ist der Pfad innerhalb des Images, um das Amazon Elastic File System (EFS) -Home-Verzeichnis des Benutzers zu mounten.
Wählen Sie als Bildtyp die Option SageMaker Studio-Image
Geben Sie als Kernelname den Namen eines vorhandenen Kernels im Image ein. Informationen zum Abrufen der Kernel-Informationen aus dem Image finden Sie DEVELOPMENTim SageMaker Studio Classic Custom Image Samples-Repository. Weitere Informationen finden Sie in den Abschnitten Kernel-Erkennung und Benutzerdaten von Benutzerdefinierte SageMaker Bildspezifikationen.
(Optional) Geben Sie unter Kernel-Anzeigename den Anzeigenamen für den Kernel ein.
Wählen Sie Kernel hinzufügen.
Wählen Sie Absenden aus.
1. Warten Sie, bis die Image-Version an die Domain angehängt ist. Wenn die Version angehängt ist, wird sie in der Liste der benutzerdefinierten Images angezeigt und kurz hervorgehoben.

Hängen Sie das SageMaker Bild an, indem Sie AWS CLI

In den folgenden Abschnitten wird gezeigt, wie Sie ein benutzerdefiniertes SageMaker Bild anhängen, wenn Sie eine neue Domain erstellen oder Ihre bestehende Domain mit dem aktualisieren AWS CLI.

Hängen Sie das SageMaker Bild an eine neue Domain an

Der folgende Abschnitt zeigt, wie Sie eine neue Domain mit der angehängten Version erstellen. Für diese Schritte müssen Sie die Amazon Virtual Private Cloud (VPC) -Informationen und die Ausführungsrolle angeben, die für die Erstellung der Domain erforderlich sind. Sie führen die folgenden Schritte aus, um die Domain zu erstellen und das benutzerdefinierte SageMaker Image anzuhängen:

Holen Sie sich Ihre VPC Standard-ID und Ihr SubnetzIDs.
Erstellen Sie die Konfigurationsdatei für die Domain, die das Image spezifiziert.
Erstellen Sie die Domain mit der Konfigurationsdatei.

Um das benutzerdefinierte SageMaker Bild zu Ihrer Domain hinzuzufügen

Holen Sie sich Ihre VPC Standard-ID.


aws ec2 describe-vpcs \
    --filters Name=isDefault,Values=true \
    --query "Vpcs[0].VpcId" --output text

Die Antwort sollte in etwa so aussehen wie die folgende.


vpc-xxxxxxxx

Rufen Sie Ihr Standard-Subnetz IDs mit der VPC ID aus dem vorherigen Schritt ab.


aws ec2 describe-subnets \
    --filters Name=vpc-id,Values=<vpc-id> \
    --query "Subnets[*].SubnetId" --output json

Die Antwort sollte in etwa so aussehen wie die folgende.


[
    "subnet-b55171dd",
    "subnet-8a5f99c6",
    "subnet-e88d1392"
]

Erstellen Sie eine Konfigurationsdatei namens create-domain-input.json. Geben Sie die VPC ID, das Subnetz IDs und AppImageConfigName aus den vorherigen Schritten ein. ImageName Da ImageVersionNumber nicht angegeben ist, wird die neueste Version des Images verwendet, was in diesem Fall die einzige Version ist.


{
    "DomainName": "domain-with-custom-image",
    "VpcId": "<vpc-id>",
    "SubnetIds": [
        "<subnet-ids>"
    ],
    "DefaultUserSettings": {
        "ExecutionRole": "<execution-role>",
        "KernelGatewayAppSettings": {
            "CustomImages": [
                {
                    "ImageName": "custom-image",
                    "AppImageConfigName": "custom-image-config"
                }
            ]
        }
    },
    "AuthMode": "IAM"
}

Erstellen Sie die Domain mit dem angehängten benutzerdefinierten SageMaker Bild.


aws sagemaker create-domain \
    --cli-input-json file://create-domain-input.json

Die Antwort sollte in etwa so aussehen wie die folgende.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx",
    "Url": "https://d-xxxxxxxxxxxx.studio.us-east-2.sagemaker.aws/..."
}

Hängen Sie das SageMaker Bild an Ihre aktuelle Domain an

Wenn Sie bei einer SageMaker Domain angemeldet sind, können Sie das benutzerdefinierte Bild an Ihre aktuelle Domain anhängen. Weitere Informationen zum Onboarding in eine SageMaker Domain finden Sie unter. SageMaker Amazon-Domain-Übersicht Sie müssen die VPC Informationen und die Ausführungsrolle nicht angeben, wenn Sie ein benutzerdefiniertes Bild an Ihre aktuelle Domain anhängen. Nachdem Sie die Version angehängt haben, müssen Sie alle Apps in Ihrer Domain löschen und Studio Classic erneut öffnen. Informationen zum Löschen von Anwendungen finden Sie unter Löschen Sie eine SageMaker Amazon-Domain.

Sie führen die folgenden Schritte aus, um das SageMaker Bild zu Ihrer aktuellen Domain hinzuzufügen.

Holen Sie sich Ihr DomainID aus dem SageMaker Kontrollpanel.
Verwenden Sie das DomainID, um das DefaultUserSettings für die Domain abzurufen.
Fügen Sie das ImageName und AppImageConfig als ein CustomImage zum DefaultUserSettings hinzu.
Aktualisieren Sie Ihre Domain so, dass sie das benutzerdefinierte Image enthält.

Um das benutzerdefinierte SageMaker Bild zu Ihrer Domain hinzuzufügen

Öffnen Sie die SageMaker Amazon-Konsole unter https://console.aws.amazon.com/sagemaker/.
Wählen Sie im linken Navigationsbereich Admin-Konfigurationen.
Wählen Sie unter Admin-Konfigurationen die Option Domains aus.
Wählen Sie auf der Seite Domains die Domain aus, an die das Bild angehängt werden soll.
Wählen Sie auf der Seite mit den Domain-Details den Tab Domaineinstellungen aus.
Auf der Registerkarte Domaineinstellungen finden Sie unter Allgemeine Einstellungen den Eintrag DomainId. Die ID hat das folgende Format: d-xxxxxxxxxxxx.

Verwenden Sie die Domain-ID, um die Beschreibung der Domain abzurufen.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

Die Antwort sollte in etwa so aussehen wie die folgende.


{
    "DomainId": "d-xxxxxxxxxxxx",
    "DefaultUserSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

Speichern Sie den Abschnitt mit den Standardbenutzereinstellungen der Antwort in einer Datei mit dem Namen default-user-settings.json.

Fügen Sie das ImageName und AppImageConfigName aus den vorherigen Schritten als benutzerdefiniertes Image ein. Da ImageVersionNumber nicht angegeben ist, wird die neueste Version des Images verwendet, was in diesem Fall die einzige Version ist.


{
    "DefaultUserSettings": {
        "KernelGatewayAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "string",
                 "AppImageConfigName": "string"
              }
           ],
           ...
        }
    }
}

Verwenden Sie die Domain-ID und die Datei mit den Standardbenutzereinstellungen, um Ihre Domain zu aktualisieren.


aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://default-user-settings.json

Die Antwort sollte in etwa so aussehen wie die folgende.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}

Hängen Sie das SageMaker Bild an einen gemeinsam genutzten Bereich an

Sie können das SageMaker Bild nur mit dem an einen gemeinsam genutzten Bereich anhängen AWS CLI. Nachdem Sie die Version angehängt haben, müssen Sie alle Anwendungen in Ihrem gemeinsam genutzten Bereich löschen und Studio Classic erneut öffnen. Informationen zum Löschen von Anwendungen finden Sie unter Löschen Sie eine SageMaker Amazon-Domain.

Sie führen die folgenden Schritte aus, um das SageMaker Bild einem gemeinsam genutzten Bereich hinzuzufügen.

Holen Sie sich Ihr DomainID von der SageMaker Systemsteuerung.
Verwenden Sie das DomainID, um das DefaultSpaceSettings für die Domain abzurufen.
Fügen Sie das ImageName und AppImageConfig als ein CustomImage zum DefaultSpaceSettings hinzu.
Aktualisieren Sie Ihre Domain so, dass sie das benutzerdefinierte Image für den gemeinsam genutzten Bereich enthält.

Um das benutzerdefinierte SageMaker Bild zu Ihrem gemeinsamen Bereich hinzuzufügen

Öffnen Sie die SageMaker Amazon-Konsole unter https://console.aws.amazon.com/sagemaker/.
Wählen Sie im linken Navigationsbereich Admin-Konfigurationen.
Wählen Sie unter Admin-Konfigurationen die Option Domains aus.
Wählen Sie auf der Seite Domains die Domain aus, an die das Bild angehängt werden soll.
Wählen Sie auf der Seite mit den Domain-Details den Tab Domaineinstellungen aus.
Auf der Registerkarte Domaineinstellungen finden Sie unter Allgemeine Einstellungen den Eintrag DomainId. Die ID hat das folgende Format: d-xxxxxxxxxxxx.

Verwenden Sie die Domain-ID, um die Beschreibung der Domain abzurufen.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

Die Antwort sollte in etwa so aussehen wie die folgende.


{
    "DomainId": "d-xxxxxxxxxxxx",
    ...
    "DefaultSpaceSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

Speichern Sie den Abschnitt mit den standardmäßigen Speichereinstellungen der Antwort in einer Datei mit dem Namen default-space-settings.json.


{
    "DefaultSpaceSettings": {
        "KernelGatewayAppSettings": { 
           "CustomImages": [ 
              { 
                 "ImageName": "string",
                 "AppImageConfigName": "string"
              }
           ],
           ...
        }
    }
}

Verwenden Sie die Domain-ID und die Datei mit den Standardeinstellungen für den Speicherplatz, um Ihre Domain zu aktualisieren.


aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://default-space-settings.json

Die Antwort sollte in etwa so aussehen wie die folgende.


{
    "DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}

Sehen Sie sich das angehängte Bild an in SageMaker

Nachdem Sie das benutzerdefinierte SageMaker Image erstellt und an Ihre Domain angehängt haben, wird das Bild auf der Registerkarte Umgebung der Domain angezeigt. Sie können die angehängten Bilder für gemeinsam genutzte Bereiche nur mit AWS CLI dem folgenden Befehl anzeigen.


aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Erstellen Sie ein SageMaker Bild

Starten Sie ein benutzerdefiniertes Image