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.
Hängen Sie ein benutzerdefiniertes SageMaker Bild in Amazon SageMaker Studio Classic an
Wichtig
Benutzerdefinierte IAM-Richtlinien, die es Amazon SageMaker Studio oder Amazon SageMaker Studio Classic ermöglichen, SageMaker Amazon-Ressourcen zu erstellen, müssen ebenfalls 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 zwar das Erstellen von Ressourcen erlaubt, das Taggen jedoch nicht zulässt, können AccessDenied "“ -Fehler auftreten, wenn versucht wird, Ressourcen zu erstellen. Weitere Informationen finden Sie unter Stellen Sie Berechtigungen für das Taggen von SageMaker KI-Ressourcen bereit.
AWS verwaltete Richtlinien für Amazon AI SageMakerdie Berechtigungen zum Erstellen von SageMaker Ressourcen gewähren, enthalten bereits Berechtigungen zum Hinzufügen von Tags bei der Erstellung dieser Ressourcen.
Anmerkung
Seit dem 30. November 2023 heißt das vorherige Amazon SageMaker Studio-Erlebnis nun Amazon SageMaker Studio Classic. Der folgende Abschnitt bezieht sich konkret auf die Verwendung der Studio-Classic-Anwendung. Informationen zur Verwendung der aktualisierten Studio-Konfiguration finden Sie unter Amazon Studio SageMaker.
Studio Classic wird weiterhin für bestehende Workloads beibehalten, ist jedoch nicht mehr für das Onboarding verfügbar. Sie können nur bestehende Studio Classic-Anwendungen beenden oder löschen und keine neuen erstellen. Wir empfehlen Ihnen, Ihre Arbeitslast auf das neue Studio-Erlebnis zu migrieren.
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, die Benutzer verwenden, um eine Aktivität zu starten oder das von einem Notizbuch verwendete Bild zu ändern.
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, verwendet SageMaker AI standardmäßig die neueste Image-Version. Sie können auch eine bestimmte Image-Version anhängen. Nachdem Sie die Version angehängt haben, können Sie die Version im SageMaker AI 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 veranschaulicht, wie Sie mithilfe der SageMaker AI-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 mit der Konsole an
In diesem Thema wird beschrieben, wie Sie mithilfe des SageMaker AI Control Panels eine vorhandene benutzerdefinierte SageMaker Image-Version an Ihre Domain anhängen können. Sie können auch ein benutzerdefiniertes SageMaker Bild und eine Image-Version 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 Image für Amazon SageMaker Studio Classic.
Um ein vorhandenes Image anzuhängen
-
Öffnen Sie die Amazon SageMaker AI-Konsole unter https://console.aws.amazon.com/sagemaker/
. -
Wählen Sie im linken Navigationsbereich Admin-Konfigurationen.
-
Wählen Sie unter Admin-Konfigurationen Domains aus.
-
Wählen Sie auf der Domain-Seite die Domain aus, an die das Image angefügt 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 aus.
-
Überprüfen Sie die Werte für Image-Name, Image-Aanzeigename und Beschreibung.
-
Wählen Sie die &IAM; -Rolle () Weitere Informationen finden Sie unter Erstellen Sie ein benutzerdefiniertes SageMaker Image für Amazon SageMaker Studio Classic.
-
(Optional) Fügen Sie Tags für das Image hinzu.
-
Geben Sie den EFS-Bereitstellungspfad an. Dies ist der Pfad innerhalb des Images zum Bereitstellen des Amazon Elastic File System (EFS) -Stammverzeichnisses des Benutzers.
-
Wählen Sie als Bildtyp die Option SageMaker Studio-Bild aus
-
Geben Sie als Kernelname den Namen eines vorhandenen Kernels im Image ein. Informationen zum Abrufen der Kernelinformationen aus dem Image finden Sie unter ENTWICKLUNG
im SageMaker Studio Classic-Repository mit benutzerdefinierten Image-Beispielen. Weitere Informationen finden Sie in den Abschnitten Kernel-Erkennung und Benutzerdaten von Benutzerdefinierte SageMaker Image-Spezifikationen für Amazon Studio Classic SageMaker. -
(Optional) Geben Sie unter Kernel-Anzeigename den Anzeigenamen für den Kernel ein.
-
Wählen Sie Kernel hinzufügen.
-
Wählen Sie Absenden aus.
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 mit dem an 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 mithilfe von 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 Standard-VPC-ID und Subnetz-IDs.
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 Standard-VPC-ID.
aws ec2 describe-vpcs \ --filters Name=isDefault,Values=true \ --query "Vpcs[0].VpcId" --output textDie Antwort sollte in etwa so aussehen wie die folgende.
vpc-xxxxxxxx -
Rufen Sie mithilfe der VPC-ID aus dem vorherigen Schritt Ihre Standard-Subnetz-IDs ab.
aws ec2 describe-subnets \ --filters Name=vpc-id,Values=<vpc-id>\ --query "Subnets[*].SubnetId" --output jsonDie Antwort sollte in etwa so aussehen wie die folgende.
[ "subnet-b55171dd", "subnet-8a5f99c6", "subnet-e88d1392" ] -
Erstellen Sie eine Konfigurationsdatei namens
create-domain-input.json. Fügen Sie die VPC-ID, die Subnetz-IDsImageNameundAppImageConfigNameaus den vorherigen Schritten ein. DaImageVersionNumbernicht 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.jsonDie 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 mit einer SageMaker AI-Domain verbunden sind, können Sie das benutzerdefinierte Bild an Ihre aktuelle Domain anhängen. Weitere Informationen zum Onboarding in eine SageMaker AI-Domain finden Sie unter. Übersicht über die Amazon SageMaker AI-Domain Sie müssen die VPC-Informationen und die Ausführungsrolle nicht angeben, wenn Sie ein benutzerdefiniertes Image 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 Amazon SageMaker AI-Domain.
Sie führen die folgenden Schritte aus, um das SageMaker Bild zu Ihrer aktuellen Domain hinzuzufügen.
Holen Sie sich Ihr
DomainIDFrom SageMaker AI Control Panel.Verwenden Sie das
DomainID, um dasDefaultUserSettingsfür die Domain abzurufen.Fügen Sie das
ImageNameundAppImageConfigals einCustomImagezumDefaultUserSettingshinzu.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 Amazon SageMaker AI-Konsole unter https://console.aws.amazon.com/sagemaker/
. -
Wählen Sie im linken Navigationsbereich Admin-Konfigurationen.
-
Wählen Sie unter Admin-Konfigurationen Domains aus.
-
Wählen Sie auf der Domain-Seite die Domain aus, an die das Image angefügt 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
ImageNameundAppImageConfigNameaus den vorherigen Schritten als benutzerdefiniertes Image ein. DaImageVersionNumbernicht 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.jsonDie 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 Amazon SageMaker AI-Domain.
Führen Sie die folgenden Schritte aus, um das SageMaker Bild einem gemeinsam genutzten Bereich hinzuzufügen.
Holen Sie sich Ihr
DomainIDFrom SageMaker AI Control Panel.Verwenden Sie das
DomainID, um dasDefaultSpaceSettingsfür die Domain abzurufen.Fügen Sie das
ImageNameundAppImageConfigals einCustomImagezumDefaultSpaceSettingshinzu.Aktualisieren Sie Ihre Domain so, dass sie das benutzerdefinierte Image für den gemeinsam genutzten Bereich enthält.
Um das benutzerdefinierte SageMaker Bild zu deinem geteilten Bereich hinzuzufügen
-
Öffnen Sie die Amazon SageMaker AI-Konsole unter https://console.aws.amazon.com/sagemaker/
. -
Wählen Sie im linken Navigationsbereich Admin-Konfigurationen.
-
Wählen Sie unter Admin-Konfigurationen Domains aus.
-
Wählen Sie auf der Domain-Seite die Domain aus, an die das Image angefügt 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. -
Fügen Sie das
ImageNameundAppImageConfigNameaus den vorherigen Schritten als benutzerdefiniertes Image ein. DaImageVersionNumbernicht angegeben ist, wird die neueste Version des Images verwendet, was in diesem Fall die einzige Version ist.{ "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.jsonDie 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 in SageMaker AI an
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 anzeigen, AWS CLI indem Sie den folgenden Befehl verwenden.
aws sagemaker describe-domain \ --domain-id<d-xxxxxxxxxxxx>