Erstellen einer Lebenszykluskonfiguration aus der SageMaker-AI-Konsole für Amazon SageMaker Studio Classic
Wichtig
Benutzerdefinierte IAM-Richtlinien, die es Amazon SageMaker Studio oder Amazon SageMaker Studio Classic ermöglichen, Amazon-SageMaker-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 Tagging erlaubt, können bei dem Versuch, Ressourcen zu erstellen, „AccessDenied“-Fehler auftreten. Weitere Informationen finden Sie unter Bereitstellen von Berechtigungen für das Markieren von SageMaker-AI-Ressourcen.
Verwaltete AWS-Richtlinien für Amazon SageMaker AI, die Berechtigungen zum Erstellen von SageMaker-Ressourcen gewähren, enthalten bereits Berechtigungen zum Hinzufügen von Tags während der Erstellung dieser Ressourcen.
Wichtig
Am 30. November 2023 wurde Amazon SageMaker Studio in Amazon SageMaker Studio umbenannt. Der folgende Abschnitt bezieht sich konkret auf die Verwendung der Studio-Classic-Anwendung. Informationen zur Verwendung der aktualisierten Studio-Konfiguration finden Sie unter Amazon SageMaker Studio.
Das folgende Thema zeigt, wie Sie eine Lebenszykluskonfiguration von der Konsole von Amazon SageMaker AI aus erstellen, um die Anpassung für Ihre Studio-Classic-Umgebung zu automatisieren.
Voraussetzungen
Bevor Sie mit diesem Lernprogramm beginnen können, müssen Sie die folgenden Voraussetzungen erfüllen:
-
Führen Sie ein Onboarding in Amazon SageMaker Studio Classic durch. Weitere Informationen finden Sie unter Onboarding in Amazon SageMaker Studio Classic.
Schritt 1: Erstellen einer neuen Lebenszykluskonfiguration
Sie können eine Lebenszykluskonfiguration erstellen, indem Sie ein Skript von der Konsole von Amazon SageMaker AI aus eingeben.
Anmerkung
Jedes Skript kann bis zu 16.384 Zeichen enthalten.
Das folgende Verfahren zeigt, wie Sie ein Skript für die Lebenszykluskonfiguration erstellen, das Hello World druckt.
Öffnen Sie die Konsole von Amazon SageMaker AI unter https://console.aws.amazon.com/sagemaker/
. -
Wählen Sie im linken Navigationsbereich Admin-Konfigurationen.
-
Wählen Sie unter Admin-Konfigurationen die Option Lifecycle-Konfigurationen aus.
-
Wählen Sie die Registerkarte Studio.
-
Wählen Sie Create configuration (Konfiguration erstellen).
-
Wählen Sie unter Konfigurationstyp auswählen den Anwendungstyp aus, an den die Lebenszykluskonfiguration angehängt werden soll. Weitere Informationen zur Auswahl der Anwendung, an die die Lebenszykluskonfiguration angehängt werden soll, finden Sie unter Festlegen einer Standard-Lebenszykluskonfiguration für Amazon SageMaker Studio Classic.
-
Wählen Sie Weiter aus.
-
Geben Sie im Abschnitt Konfigurationseinstellungen einen Namen für Ihre Lebenszykluskonfiguration ein.
-
Geben Sie im Abschnitt Skripte den folgenden Inhalt ein.
#!/bin/bash set -eux echo 'Hello World!' -
(Optional) Erstellen Sie ein Tag für Ihre Lebenszykluskonfiguration.
-
Wählen Sie Absenden aus.
Schritt 2: Anfügen der Lebenszykluskonfiguration an eine Domain oder ein Benutzerprofil
Auf Domainebene zugeordnete Skripte zur Lebenszykluskonfiguration werden von allen Benutzern übernommen. Skripte, die auf Benutzerprofilebene verknüpft sind, sind jedoch auf einen bestimmten Benutzer beschränkt.
Sie können mehrere Lebenszykluskonfigurationen an eine Domain oder ein Benutzerprofil sowohl für JupyterServer- als auch für KernelGateway-Anwendungen anhängen.
Anmerkung
Um eine Lebenszykluskonfiguration an einen gemeinsam genutzten Bereich anzuhängen, müssen Sie den AWS CLI verwenden. Weitere Informationen finden Sie unter Erstellen einer Lebenszykluskonfiguration aus der AWS CLI für Amazon SageMaker Studio Classic.
In den folgenden Abschnitten wird gezeigt, wie Sie eine Lebenszykluskonfiguration an Ihre Domain oder Ihr Benutzerprofil anfügen.
An eine Domain anhängen
Im Folgenden wird gezeigt, wie Sie über die SageMaker-AI-Konsole eine Lebenszykluskonfiguration an Ihre bestehende Domain anfügen.
Öffnen Sie die Konsole von Amazon SageMaker AI 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 aus der Liste der Domains die Domain aus, an die die Lebenszykluskonfiguration angefügt werden soll.
-
Wählen Sie in den Domaindetails die Registerkarte Umgebung aus.
-
Wählen Sie unter Lebenszykluskonfigurationen für persönliche Studio-Apps die Option Anhängen aus.
-
Wählen Sie unter Quelle die Option Bestehende Konfiguration aus.
-
Wählen Sie unter Studio-Lebenszykluskonfigurationen die Lebenszykluskonfiguration aus, die Sie im vorherigen Schritt erstellt haben.
-
Wählen Sie An Domain anhängen aus.
An Ihr Benutzerprofil anhängen
Im Folgenden wird gezeigt, wie Sie eine Lebenszykluskonfiguration an Ihr vorhandenes Benutzerprofil anhängen.
Öffnen Sie die Konsole von Amazon SageMaker AI 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 aus der Liste der Domains die Domain aus, die das Benutzerprofil enthält, an das die Lebenszykluskonfiguration angefügt werden soll.
-
Wählen Sie unter Benutzerprofile das Benutzerprofil aus.
-
Wählen Sie auf der Seite Benutzerdetails die Option Bearbeiten.
-
Wählen Sie in der linken Navigation Studioeinstellungen.
-
Wählen Sie unter Lebenszykluskonfigurationen, die dem Benutzer zugeordnet sind, die Option Anhängen.
-
Wählen Sie unter Quelle die Option Bestehende Konfiguration aus.
-
Wählen Sie unter Studio-Lebenszykluskonfigurationen die Lebenszykluskonfiguration aus, die Sie im vorherigen Schritt erstellt haben.
-
Wählen Sie An Benutzerprofil anhängen.
Schritt 3: Starten einer Anwendung mit der Lebenszykluskonfiguration
Nachdem Sie einer Domain oder einem Benutzerprofil eine Lebenszykluskonfiguration angehängt haben, können Sie eine Anwendung mit dieser angehängten Lebenszykluskonfiguration starten. Die Auswahl, mit welcher Lebenszykluskonfiguration gestartet werden soll, hängt vom Anwendungstyp ab.
-
JupyterServer: Wenn Sie eine JupyterServer-Anwendung von der Konsole aus starten, verwendet SageMaker AI immer die standardmäßige Lebenszykluskonfiguration. Sie können keine andere Lebenszykluskonfiguration verwenden, wenn Sie von der Konsole aus starten. Hinweise zum Ändern der standardmäßigen Lebenszykluskonfiguration nach dem Start einer JupyterServer-Anwendung finden Sie unter Festlegen einer Standard-Lebenszykluskonfiguration für Amazon SageMaker Studio Classic.
Um eine andere angehängte Lebenszykluskonfiguration auszuwählen, müssen Sie mit dem AWS CLI starten. Weitere Informationen zum Starten einer JupyterServer-Anwendung mit einer angehängten Lebenszykluskonfiguration aus den AWS CLI finden Sie unter Erstellen einer Lebenszykluskonfiguration aus der AWS CLI für Amazon SageMaker Studio Classic.
-
KernelGateway: Sie können jede der angehängten Lebenszykluskonfigurationen auswählen, wenn Sie eine KernelGateway-Anwendung mit dem Studio Classic Launcher starten.
Das folgende Verfahren beschreibt, wie Sie eine KernelGateway-Anwendung mit einer angefügten Lebenszykluskonfiguration von der SageMaker-AI-Konsole aus starten.
Öffnen Sie die Konsole von Amazon SageMaker AI unter https://console.aws.amazon.com/sagemaker/
. -
Starten Sie Studio Classic. Weitere Informationen finden Sie unter Starten von Amazon SageMaker Studio Classic.
-
Öffnen Sie in der Studio-Classic-Benutzeroberfläche den Studio Classic Launcher. Weitere Informationen finden Sie unter Öffnen des Amazon SageMaker Studio Classic Launchers.
-
Navigieren Sie im Studio Classic Launcher zum Abschnitt Notebooks und Rechenressourcen.
-
Klicken Sie auf die Schaltfläche Umgebung ändern.
-
Wählen Sie im Dialogfeld Umgebung ändern in den Dropdown-Menüs das Image, den Kernel, den Instance-Typ und ein Startskript aus. Wenn es keine standardmäßige Lebenszykluskonfiguration gibt, ist der Wert für das Startskript standardmäßig auf
No scriptfestgelegt. Andernfalls ist der Wert für das Startskript Ihre standardmäßige Lebenszykluskonfiguration. Nachdem Sie eine Lebenszykluskonfiguration ausgewählt haben, können Sie das gesamte Skript anzeigen. -
Klicken Sie auf Auswählen.
-
Kehren Sie zum Launcher zurück und klicken Sie auf Notebook erstellen, um einen neuen Notebook-Kernel mit dem ausgewählten Image und der Lebenszykluskonfiguration zu starten.
Schritt 4: Anzeigen von Protokollen für eine Lebenszyklus-Konfiguration
Sie können die Protokolle für Ihre Lebenszykluskonfiguration anzeigen, nachdem sie an eine Domain oder ein Benutzerprofil angehängt wurde.
-
Stellen Sie zunächst Zugriff auf CloudWatch für Ihre AWS Identity and Access Management (IAM)-Rolle bereit. Fügen Sie Leseberechtigungen für die folgende Protokollgruppe und den folgenden Protokollstream hinzu.
Log-Gruppe:
/aws/sagemaker/studioLog-Stream:
domain/user-profile/app-type/app-name/LifecycleConfigOnStart
Informationen zum Hinzufügen von Berechtigungen finden Sie unter Aktivieren der Protokollierung für bestimmte AWS Dienste.
-
Navigieren Sie in Studio Classic zum Symbol Laufende Terminals und Kernel (
) aus, um Ihre Lebenszykluskonfiguration zu überwachen. -
Wählen Sie eine Anwendung aus der Liste der laufenden Anwendungen aus. Anwendungen mit angehängten Lebenszykluskonfigurationen haben ein angehängtes Indikatorsymbol
. -
Wählen Sie das Indikatorsymbol für Ihre Anwendung aus. Dadurch wird ein neues Fenster geöffnet, in dem die Lebenszykluskonfiguration aufgeführt ist.
-
Wählen Sie in dem neuen Panel
View logs. Dadurch wird eine neue Registerkarte geöffnet, auf der die Protokolle angezeigt werden.