

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Imagens personalizadas

Se precisar de uma funcionalidade diferente da fornecida pela SageMaker distribuição, você pode trazer sua própria imagem com suas extensões e pacotes personalizados. Você também pode personalizar a interface de usuário do Editor de Código de acordo com sua própria marca ou necessidades de conformidade.

A página a seguir fornecerá Editor-specific informações de código e modelos para criar suas próprias imagens de SageMaker IA personalizadas. O objetivo é complementar as informações e instruções do Amazon SageMaker Studio sobre como criar sua própria imagem de SageMaker IA e trazer sua própria imagem para o Studio. Para saber mais sobre imagens personalizadas do Amazon SageMaker AI e como trazer sua própria imagem para o Studio, consulte[Traga sua própria imagem (BYOI)](studio-updated-byoi.md). 

**Topics**
+ [Verificação de integridade e URL de aplicações](#code-editor-custom-images-app-healthcheck)
+ [Exemplos de Dockerfile](#code-editor-custom-images-dockerfile-templates)

## Verificação de integridade e URL de aplicações
<a name="code-editor-custom-images-app-healthcheck"></a>
+ `Base URL`: O URL base para a aplicação BYOI deve ser `CodeEditor/default`. Você só pode ter uma aplicação e ele deve sempre ter um nome `default`.
+ Endpoint de verificação de integridade — Você deve hospedar seu servidor do Editor de Código na porta 0.0.0.0 8888 para SageMaker que a IA o detecte.
+  Autenticação — Você deve passar `--without-connection-token` ao abrir `sagemaker-code-editor` para permitir que a SageMaker IA autentique seus usuários.

**nota**  
Se você estiver usando o Amazon SageMaker Distribution como imagem base, esses requisitos já serão atendidos como parte do `entrypoint-code-editor` script incluído.

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

Os exemplos a seguir são arquivos `Dockerfile` que atendem às informações e [Especificações de imagem personalizadas](studio-updated-byoi-specs.md) acima.

**nota**  
Se você estiver trazendo sua própria imagem para o SageMaker Unified Studio, precisará seguir as especificações do [ Dockerfile ](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) no Guia do usuário do * Amazon SageMaker Unified Studio. *  
`Dockerfile`exemplos do SageMaker Unified Studio podem ser encontrados no exemplo do [ Dockerfile ](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) no Guia do usuário do * Amazon SageMaker Unified Studio. *

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

Veja o seguinte exemplo de Dockerfile para criar uma imagem do zero usando um ambiente [`micromamba`](https://mamba.readthedocs.io/en/latest/user_guide/micromamba.html) básico: 

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

Veja a seguir um exemplo de Dockerfile para criar uma imagem com base na [ Amazon SageMaker AI Distribution: ](https://github.com/aws/sagemaker-distribution/tree/main)

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

------