Benutzerdefinierte SageMaker AI-Bildspezifikationen

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.

Die folgenden Spezifikationen gelten für das Container-Image, das durch eine SageMaker AI-Image-Version dargestellt wird.

Das Image wird ausgeführt

ENTRYPOINTund CMD Anweisungen werden außer Kraft gesetzt, damit das Image als App ausgeführt werden kann. KernelGateway

Port 8888 im Image ist für den Betrieb des KernelGateway Webservers reserviert.

Stoppen des Images

Die DeleteApp-API gibt das Äquivalent zu einem docker stop-Befehl aus. Andere Prozesse im Container erhalten die SIGKILL/SIGTERM-Signale nicht.

Kernel-Erkennung

SageMaker AI erkennt Kernel so, wie sie in den Jupyter-Kernelspezifikationen definiert sind.

Sie können eine Liste von Kerneln angeben, die angezeigt werden sollen, bevor das Image ausgeführt wird. Wenn nicht angegeben, wird Python3 angezeigt. Verwenden Sie die DescribeAppImageConfigAPI, um die Liste der Kernel anzuzeigen.

Conda-Umgebungen werden standardmäßig als Kernel-Spezifikationen erkannt.

Dateisystem

Die Verzeichnisse /opt/.sagemakerinternal und /opt/ml sind reserviert. Alle Daten in diesen Verzeichnissen sind zur Laufzeit möglicherweise nicht sichtbar.

Benutzerdaten

Jeder Benutzer in einer Domain erhält ein Benutzerverzeichnis auf einem gemeinsam genutzten Amazon Elastic File System-Volume im Image. Der Speicherort des aktuellen Benutzerverzeichnisses auf dem Amazon EFS-Volume ist konfigurierbar. Standardmäßig ist der Speicherort des Verzeichnisses /home/sagemaker-user.

SageMaker AI konfiguriert POSIX UID/GID mappings between the image and the host. This defaults to mapping the root user's UID/GID (0/0) to the UID/GID auf dem Host.

Sie können diese Werte mithilfe der CreateAppImageConfigAPI angeben.

GID/UID-Grenzwerte

Amazon SageMaker Studio Classic unterstützt nur die folgenden DefaultUID und DefaultGID Kombinationen:

• defaultUID: 1000 und defaultGID: 100, was einem Benutzer ohne Privilegien entspricht.

• defaultUID: 0 und defaultGID: 0, was dem Root-Zugriff entspricht.

Metadaten

Eine Metadatendatei befindet sich unter. /opt/ml/metadata/resource-metadata.json Den im Image definierten Variablen werden keine zusätzlichen Umgebungsvariablen hinzugefügt. Weitere Informationen finden Sie unter Abrufen von App-Metadaten.

GPU

Auf einer GPU-Instance wird das Image mit der --gpus Option ausgeführt. Nur das CUDA-Toolkit sollte im Image enthalten sein, nicht die NVIDIA-Treiber. Weitere Informationen finden Sie im NVIDIA Benutzerhandbuch.

Metriken und Protokollierung

Protokolle des KernelGateway Prozesses werden CloudWatch im Kundenkonto an Amazon gesendet. Der Name der Protokollgruppe ist /aws/sagemaker/studio. Der Name des Protokollstream ist $domainID/$userProfileName/KernelGateway/$appName.

Größe des Images

Limitiert auf 35 GB. Führen Sie den Befehl aus, um die Größe Ihres Images anzuzeigendocker image ls.

Beispiel-Dockerfile

Das folgende Dockerfile-Beispiel erstellt ein Image, das auf Amazon Linux 2 basiert, installiert Pakete von Drittanbietern und den python3 Kernel und legt den Bereich auf den Benutzer ohne Zugriffsrechte fest.

FROM public.ecr.aws/amazonlinux/amazonlinux:2

ARG NB_USER="sagemaker-user"
ARG NB_UID="1000"
ARG NB_GID="100"

RUN \
    yum install --assumeyes python3 shadow-utils && \
    useradd --create-home --shell /bin/bash --gid "${NB_GID}" --uid ${NB_UID} ${NB_USER} && \
    yum clean all && \
    python3 -m pip install ipykernel && \
    python3 -m ipykernel install

USER ${NB_UID}