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
<a name="code-editor-custom-images"></a>

Wenn Sie Funktionen benötigen, die sich von den im SageMaker Vertrieb bereitgestellten unterscheiden, können Sie mit Ihren benutzerdefinierten Erweiterungen und Paketen Ihr eigenes Image 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 spezifische Informationen und Vorlagen für den Code-Editor, mit denen Sie Ihre eigenen benutzerdefinierten SageMaker KI-Images erstellen können. Dies soll die Informationen und Anweisungen von Amazon SageMaker Studio zur Erstellung Ihres eigenen SageMaker KI-Images und zum Einspielen Ihres eigenen Images in Studio ergänzen. Weitere Informationen zu benutzerdefinierten Amazon SageMaker AI-Images und dazu, wie Sie Ihr eigenes Bild in Studio importieren können, finden Sie unter[Bring Your Own Image (BYOI)](studio-updated-byoi.md). 

**Topics**
+ [Zustandsprüfung und URL für Anwendungen](#code-editor-custom-images-app-healthcheck)
+ [Dockerfile-Beispiele](#code-editor-custom-images-dockerfile-templates)

## Zustandsprüfung und URL für Anwendungen
<a name="code-editor-custom-images-app-healthcheck"></a>
+ `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.
+ Health Check-Endpunkt — Sie müssen Ihren Code Editor-Server auf 0.0.0.0 Port 8888 hosten, damit SageMaker KI ihn erkennen kann.
+  Authentifizierung — Sie müssen `--without-connection-token` beim Öffnen den Vorgang bestehen`sagemaker-code-editor`, damit SageMaker KI Ihre Benutzer authentifizieren kann.

**Anmerkung**  
Wenn Sie Amazon SageMaker Distribution als Basis-Image verwenden, werden diese Anforderungen bereits als Teil des mitgelieferten `entrypoint-code-editor` Skripts erfüllt.

## Dockerfile-Beispiele
<a name="code-editor-custom-images-dockerfile-templates"></a>

Die folgenden Beispiele sind `Dockerfile`s, die den obigen Informationen und [Benutzerdefinierte Image-Daten](studio-updated-byoi-specs.md) entsprechen.

**Anmerkung**  
Wenn Sie Ihr eigenes Image in SageMaker Unified Studio verwenden, müssen Sie die [Dockerfile-Spezifikationen](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) im *Amazon SageMaker Unified Studio-Benutzerhandbuch* befolgen.  
`Dockerfile`Beispiele für SageMaker Unified Studio finden Sie im [Dockerfile-Beispiel](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) im *Amazon SageMaker Unified Studio-Benutzerhandbuch*.

------
#### [ Example micromamba Dockerfile ]

Im Folgenden finden Sie ein Beispiel für eine Dockerfile, mit der Sie mithilfe einer [https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html](https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html)-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 ein Dockerfile zum Erstellen eines Images auf Basis von [Amazon SageMaker AI Distribution](https://github.com/aws/sagemaker-distribution/tree/main):

```
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"]
```

------