Wie behebe ich Probleme, wenn ich in SageMaker Studio auf ein Amazon-SageMaker-Projekt zugreife?

Auflösung

Mit SageMaker Project können Sie umfassende ML-Lösungen verwalten und orchestrieren. Wenn Sie Projekte aus der Studio-Umgebung heraus erstellen oder darauf zugreifen, kann es aus einem oder mehreren der folgenden Gründe zu Problemen kommen:

• Fehlende Berechtigungen
• Netzwerkprobleme im Nur-VPC-Modus
• Probleme mit der Studio-Benutzeroberfläche

Fehlende Berechtigungen

SageMaker-Projekte verlassen sich auf AWS Service Catalog, um Projektvorlagen zu verwenden oder zu erstellen und AWS-Ressourcen für Ihre Konten bereitzustellen. Die Benutzer Ihrer Studio-Domäne können nur dann auf diese Vorlagen zugreifen oder sie anzeigen, wenn Sie die Rechte für Projects erteilen.

Wenn Ihr Benutzer nicht über die Berechtigungen für Projects verfügt, erhält er eine Fehlermeldung ähnlich der folgenden:

Amazon SageMaker project templates aren't enabled for your account.
Contact your administrator to enable SageMaker project templates.

Um dieses Problem zu beheben, müssen Sie Projects-Berechtigungen für den Administrator und Benutzer der Domänenausführungsrolle erteilen.

Möglicherweise bestehen auch Berechtigungsprobleme, weil eines der folgenden Elemente fehlt, gelöscht, geändert oder manuell neu erstellt wurde:

• Eine Servicerolle, die erstellt wurde, als Sie SageMaker Project aktiviert haben
• Amazon SageMaker JumpStart

Um dieses Problem zu beheben, führen Sie die folgenden Schritte aus, um SageMaker-Projektvorlagen und JumpStart zu deaktivieren:

1.    Öffnen Sie die SageMaker-Konsole.

2.    Wählen Sie im Navigationsbereich Domänen.

3.    Verwenden Sie die Schaltfläche neben dem Domänennamen, um Ihre Domäne auszuwählen. Wählen Sie dann oben im Domänen-Menü die Option Bearbeiten aus.

4.    Wählen Sie auf der Seite Allgemeine Einstellungen die Option Weiter aus.

5.    Deaktivieren Sie unter SageMaker Projects und JumpStart die Option Amazon-SageMaker-Projektvorlagen und Amazon SageMaker JumpStart für dieses Konto aktivieren. Deaktivieren Sie außerdem die Optionen Amazon-SageMaker-Projektvorlagen aktivieren und Amazon SageMaker JumpStart für Studio-Benutzer aktivieren.

6.    Wählen Sie Weiter aus.

7.    Wählen Sie auf der RStudio-Einstellungsseite die Option Weiter aus.

8.    Wählen Sie auf der Seite Einstellungen für Amazon SageMaker Canvas die Option Senden aus.

9.    Löschen Sie alle Rollen, die mit AmazonSageMakerServiceCatalogProduct* beginnen.

10.  Verwenden Sie die vorangehenden Anweisungen, um die Schalter zu aktivieren, mit denen SageMaker-Projektvorlagen und JumpStart aktiviert werden. In diesem Schritt werden mehrere neue Rollen für Sie erstellt. Um die Liste Ihrer Rollen anzuzeigen: Wählen Sie unter Projects die Registerkarte Apps und dann Systemsteuerung aus.

Hinweis: Um über die erforderlichen Berechtigungen für den Zugriff auf die Konsole von AWS Service Catalog zu verfügen, fügen Sie die verwaltete Richtlinie SageMakerFullAccess an die Ausführungsrollen Ihrer Studio-Benutzer an.

Netzwerkprobleme im Nur-VPC-Modus

Der Internetzugang ist bei dem Netzwerkzugriffstyp Nur VPC nicht aktiv. Daher können Sie ein Studio-Notebook nur ausführen, wenn die folgenden Bedingungen erfüllt sind:

• Ihre VPC verfügt über einen Schnittstellenendpunkt zur SageMaker-API und -Laufzeit oder über ein NAT-Gateway mit Internetzugang.
• Ihre Sicherheitsgruppen erlauben ausgehende Verbindungen.

Wenn Sie für Ihr SageMaker-Projekt keinen NAT-Gateway-Zugriff benötigen, müssen Sie Schnittstellen-VPC-Endpunkte (AWS PrivateLink) erstellen, um eine Verbindung zu com.amazonaws herzustellen.[region].servicecatalog herzustellen. Wenn Sie beispielsweise Studio in der AWS-Region eu-west-1 verwenden, verwenden Sie com.amazonaws.eu-west-1.servicecatalog. Weitere Informationen finden Sie unter Anforderungen für die Verwendung des Nur-VPC-Modus.

Führen Sie die folgenden Befehle von einem Studio-Systemterminal aus, um zu überprüfen, ob Ihre Studio-Netzwerkeinstellungen eine Verbindung zu SageMaker-API- und Service-Catalog-Endpunkten zulassen:

Zugriff auf den SageMaker-API-Endpunkt überprüfen:

curl -v https://api.sagemaker.example-region.amazonaws.com

Überprüfen Sie den Zugriff auf den Service-Catalog-Endpunkt in der gewünschten Region:

curl -v https://api.sagemaker.example-region.amazonaws.com

Wenn Sie beim Ausführen dieser Befehle den Fehler Verbindungstimeout erhalten, überprüfen Sie, ob Ihre VPC-Netzwerkeinstellungen für den Nur-VPC-Modus konfiguriert sind.

Zeigen Sie die Liste der verfügbaren Projekte vom Systemterminal aus an, indem Sie den folgenden Befehl ausführen:

$ aws sagemaker list-projects --sort-by CreationTime --sort-order Descending

Wenn Sie dieselbe Liste nicht in der SageMaker-Studio-Oberfläche anzeigen können, stellen Sie sicher, dass Sie die Domäne Ihres Studios aktualisieren. Führen Sie danach folgende Aktionen aus:

1.    SageMaker Studio starten.

2.    Wählen Sie in der linken Seitenleiste Befehle aus.

3.    Suchen Sie in der Suchleiste nach Anwendungsstatus zurücksetzen, und wählen Sie dann diese Option aus.

Hinweis: In JupyterLab 3 gibt es standardmäßig keine Befehlspalette in der linken Seitenleiste. Um die Befehlspalette hinzuzufügen: Wählen Sie im Menü die Option Ansicht und dann in der Menüleiste die Option Befehlspalette aktivieren. Oder Sie können den Tastaturkurzbefehl Strg + Umschalt + C verwenden.

---