Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Immagini personalizzate
<a name="code-editor-custom-images"></a>

Se hai bisogno di funzionalità diverse da quelle fornite dalla SageMaker distribuzione, puoi aggiungere la tua immagine con le estensioni e i pacchetti personalizzati. Puoi anche utilizzarla per personalizzare l’interfaccia utente dell’Editor di codice in base alle tue esigenze di branding o conformità.

La pagina seguente fornirà informazioni e modelli specifici di Code Editor per creare immagini SageMaker AI personalizzate. Questo ha lo scopo di integrare le informazioni e le istruzioni di Amazon SageMaker Studio su come creare la propria immagine SageMaker AI e portare la propria immagine in Studio. Per informazioni sulle immagini Amazon SageMaker AI personalizzate e su come portare la tua immagine in Studio, consulta[Bring Your Own Image (BYOI)](studio-updated-byoi.md). 

**Topics**
+ [Controllo dell’integrità e URL per le applicazioni](#code-editor-custom-images-app-healthcheck)
+ [Esempi di Dockerfile](#code-editor-custom-images-dockerfile-templates)

## Controllo dell’integrità e URL per le applicazioni
<a name="code-editor-custom-images-app-healthcheck"></a>
+ `Base URL`: l’URL di base per l’applicazione BYOI deve essere `CodeEditor/default`. È possibile avere una sola applicazione e deve avere sempre il nome `default`.
+ Endpoint Health check: è necessario ospitare il server Code Editor sulla porta 0.0.0.0 8888 affinché SageMaker AI lo rilevi.
+  Autenticazione: è necessario eseguire l'autenticazione `sagemaker-code-editor` all'`--without-connection-token`apertura per consentire all' SageMaker IA di autenticare gli utenti.

**Nota**  
Se utilizzi Amazon SageMaker Distribution come immagine di base, questi requisiti sono già soddisfatti come parte dello `entrypoint-code-editor` script incluso.

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

Gli esempi seguenti sono `Dockerfile` che soddisfano le informazioni descritte sopra e quelle in [Specifiche dell’immagine personalizzata](studio-updated-byoi-specs.md).

**Nota**  
Se stai trasferendo la tua immagine in SageMaker Unified Studio, dovrai seguire le [specifiche di Dockerfile nella Guida](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) per l'utente di *Amazon SageMaker Unified* Studio.  
`Dockerfile`alcuni esempi di SageMaker Unified Studio sono disponibili nell'[esempio di Dockerfile](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) nella *Amazon SageMaker Unified* Studio User Guide.

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

Di seguito è riportato un esempio di Dockerfile per creare un’immagine da zero utilizzando un ambiente di 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 ]

Di seguito è riportato un esempio di Dockerfile per creare un'immagine basata su [Amazon SageMaker AI](https://github.com/aws/sagemaker-distribution/tree/main) Distribution:

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

------