View a markdown version of this page

Benutzerdefinierte Images - Amazon SageMaker KI
Zustandsprüfung und URL für AnwendungenDockerfile-Beispiele

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.

Benutzerdefinierte Images

Wenn Sie Funktionen benötigen, die sich von den in der SageMaker Distribution bereitgestellten unterscheiden, können Sie Ihr eigenes Image mit Ihren benutzerdefinierten Erweiterungen und Paketen mitbringen. Sie können es auch verwenden, um die Code-Editor-Benutzeroberfläche an Ihre eigenen Branding- oder Compliance-Anforderungen anzupassen.

Auf der folgenden Seite finden Sie Editor-specific Codeinformationen und Vorlagen zum Erstellen Ihrer eigenen benutzerdefinierten SageMaker AI-Images. Dies soll die Amazon SageMaker Studio-Informationen und Anweisungen zum Erstellen Ihres eigenen SageMaker KI-Images und zum Einbringen Ihres eigenen Bilds in Studio ergänzen. Weitere Informationen zu benutzerdefinierten Amazon SageMaker AI-Bildern und dazu, wie Sie Ihr eigenes Bild in Studio integrieren können, finden Sie unterBring Your Own Image (BYOI).

Zustandsprüfung und URL für Anwendungen

  • Base URL – Die Basis-URL für die BYOI-Anwendung muss CodeEditor/default lauten. Es ist nur eine Anwendung zulässig, und diese muss stets den Namen default haben.

  • Endpunkt der Integritätsprüfung — Sie müssen Ihren Code-Editor-Server auf Port 8888 0.0.0.0 hosten, damit SageMaker KI ihn erkennen kann.

  • Authentifizierung — Sie müssen die Prüfung --without-connection-token beim Öffnen bestehensagemaker-code-editor, damit SageMaker AI Ihre Benutzer authentifizieren kann.

Anmerkung

Wenn Sie Amazon SageMaker Distribution als Basis-Image verwenden, werden diese Anforderungen bereits im Rahmen des mitgelieferten entrypoint-code-editor Skripts berücksichtigt.

Dockerfile-Beispiele

Die folgenden Beispiele sind Dockerfiles, die den obigen Informationen und Benutzerdefinierte Image-Daten entsprechen.

Anmerkung

Wenn Sie Ihr eigenes Image zu SageMaker Unified Studio mitbringen, müssen Sie die Dockerfile-Spezifikationen im Amazon SageMaker Unified Studio-Benutzerhandbuch befolgen.

DockerfileBeispiele für SageMaker Unified Studio finden Sie im Dockerfile-Beispiel im Amazon SageMaker Unified Studio-Benutzerhandbuch.

Example micromamba Dockerfile

Im Folgenden finden Sie ein Beispiel für eine Dockerfile, mit der Sie mithilfe einer micromamba-Basisumgebung ein Image von Grund auf neu erstellen können: 

FROM mambaorg/micromamba:latest
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100

USER root

RUN micromamba install -y --name base -c conda-forge sagemaker-code-editor

USER $NB_UID

CMD eval "$(micromamba shell hook --shell=bash)"; \
    micromamba activate base; \
    sagemaker-code-editor --host 0.0.0.0 --port 8888 \
        --without-connection-token \
        --base-path "/CodeEditor/default"
Example SageMaker AI Distribution Dockerfile

Im Folgenden finden Sie ein Beispiel für eine Dockerfile zum Erstellen eines Images, das auf Amazon AI Distribution basiert: SageMaker 

FROM public.ecr.aws/sagemaker/sagemaker-distribution:latest-cpu
ARG NB_USER="sagemaker-user"
ARG NB_UID=1000
ARG NB_GID=100
ENV MAMBA_USER=$NB_USER

USER root

 # install scrapy in the base environment
RUN micromamba install -y --name base -c conda-forge scrapy

 # download VSCodeVim
RUN \
  wget https://github.com/VSCodeVim/Vim/releases/download/v1.27.2/vim-1.27.2.vsix \
  -P /tmp/exts/ --no-check-certificate

 # Install the extension
RUN \
  extensionloc=/opt/amazon/sagemaker/sagemaker-code-editor-server-data/extensions \
  && sagemaker-code-editor \
    --install-extension "/tmp/exts/vim-1.27.2.vsix" \
    --extensions-dir "${extensionloc}"

USER $MAMBA_USER
ENTRYPOINT ["entrypoint-code-editor"]