Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Images personnalisées
<a name="code-editor-custom-images"></a>

Si vous avez besoin de fonctionnalités différentes de celles fournies par SageMaker la distribution, vous pouvez apporter votre propre image avec vos extensions et packages personnalisés. Vous pouvez également l’utiliser pour personnaliser l’interface utilisateur de l’éditeur de code en fonction de vos propres besoins en matière de marque ou de conformité.

La page suivante fournit des informations et des modèles spécifiques à l'éditeur de code pour créer vos propres images d' SageMaker IA personnalisées. Ceci est destiné à compléter les informations et les instructions d'Amazon SageMaker Studio sur la création de votre propre image SageMaker AI et l'intégration de votre propre image dans Studio. Pour en savoir plus sur les images Amazon SageMaker AI personnalisées et sur la manière d'intégrer votre propre image dans Studio, consultez[Apporter votre propre image (BYOI)](studio-updated-byoi.md). 

**Topics**
+ [Surveillance de l’état et URL des applications](#code-editor-custom-images-app-healthcheck)
+ [Exemples de fichiers Docker](#code-editor-custom-images-dockerfile-templates)

## Surveillance de l’état et URL des applications
<a name="code-editor-custom-images-app-healthcheck"></a>
+ `Base URL` : l’URL de base de l’application BYOI doit être `CodeEditor/default`. Vous ne pouvez avoir qu’une seule application et elle doit toujours être nommée `default`.
+ Health check endpoint — Vous devez héberger votre serveur Code Editor sur le port 0.0.0.0 8888 pour que l' SageMaker IA le détecte.
+  Authentification — Vous devez réussir `sagemaker-code-editor` à l'`--without-connection-token`ouverture pour permettre à l' SageMaker IA d'authentifier vos utilisateurs.

**Note**  
Si vous utilisez Amazon SageMaker Distribution comme image de base, ces exigences sont déjà prises en compte dans le `entrypoint-code-editor` script inclus.

## Exemples de fichiers Docker
<a name="code-editor-custom-images-dockerfile-templates"></a>

Les exemples suivants sont des fichiers `Dockerfile` qui répondent aux informations ci-dessus et aux [Spécifications d’images personnalisées](studio-updated-byoi-specs.md).

**Note**  
Si vous apportez votre propre image à SageMaker Unified Studio, vous devez suivre les [spécifications Dockerfile](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) du guide de l'*utilisateur d'Amazon SageMaker Unified Studio*.  
`Dockerfile`vous trouverez des exemples d' SageMaker Unified Studio dans l'[exemple Dockerfile du guide](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) de l'*utilisateur d'Amazon SageMaker Unified Studio*.

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

Voici un exemple de fichier Docker permettant de créer une image à partir de zéro à l’aide d’un environnement de base [https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html](https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html) : 

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

Voici un exemple de Dockerfile permettant de créer une image basée sur [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"]
```

------