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á.

# Especificações de imagem personalizadas
<a name="studio-updated-byoi-specs"></a>

A imagem que você especifica no Dockerfile deve atender as especificações nas seções a seguir para criar a imagem com sucesso.

**Topics**
+ [Executando a imagem](#studio-updated-byoi-specs-run)
+ [Especificações para o usuário e o sistema de arquivos](#studio-updated-byoi-specs-user-and-filesystem)
+ [Verificação de integridade e URL de aplicações](#studio-updated-byoi-specs-app-healthcheck)
+ [Exemplos de Dockerfile](#studio-updated-byoi-specs-dockerfile-templates)

## Executando a imagem
<a name="studio-updated-byoi-specs-run"></a>

As configurações a seguir podem ser feitas atualizando sua [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html). Para ver um exemplo, consulte [Atualizar a configuração do contêiner](studio-updated-byoi-how-to-container-configuration.md).
+ `Entrypoint`: você pode configurar `ContainerArguments` e `ContainerEntrypoint`, que são transferidos para o contêiner no runtime. Recomendamos que você use `ContainerConfig` para configurar seu ponto de entrada. Consulte o link acima para ver um exemplo.
+ `EnvVariables`: ao usar o Studio, você pode definir variáveis personalizadas de `ContainerEnvironment` para seu contêiner. Opcionalmente, use `ContainerConfig` para atualizar suas variáveis de ambiente. Consulte o link acima para ver um exemplo.

  SageMaker As variáveis de ambiente específicas da IA têm precedência e substituirão todas as variáveis com os mesmos nomes. Por exemplo, a SageMaker IA fornece automaticamente variáveis de ambiente prefixadas com `AWS_` e `SAGEMAKER_` para garantir a integração adequada com AWS os serviços e a funcionalidade da SageMaker IA. Veja a seguir alguns exemplos de variáveis de ambiente SageMaker específicas de IA:
  + `AWS_ACCOUNT_ID`
  + `AWS_REGION`
  + `AWS_DEFAULT_REGION`
  + `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI`
  + `SAGEMAKER_SPACE_NAME`
  + `SAGEMAKER_APP_TYPE`

## Especificações para o usuário e o sistema de arquivos
<a name="studio-updated-byoi-specs-user-and-filesystem"></a>
+ `WorkingDirectory`: O volume do Amazon EBS do seu espaço está montado no caminho `/home/sagemaker-user`. Não é possível mudar o caminho de montagem. Use a instrução `WORKDIR` para definir o diretório de trabalho da sua imagem como uma pasta em `/home/sagemaker-user`.
+ `UID`: O ID do usuário do contêiner do Docker. UID=1000 é um valor compatível. É possível adicionar acesso sudo aos seus usuários. Eles IDs são remapeados para evitar que um processo em execução no contêiner tenha mais privilégios do que o necessário.
+ `GID`: O ID do grupo do contêiner do Docker. GID=100 é um valor compatível. É possível adicionar acesso sudo aos seus usuários. Eles IDs são remapeados para evitar que um processo em execução no contêiner tenha mais privilégios do que o necessário.
+ Diretórios de metadados — Os `/opt/ml` diretórios `/opt/.sagemakerinternal` e que são usados pelo. AWS O arquivo de metadados em `/opt/ml` contém metadados sobre recursos como `DomainId`.

  Use o seguinte comando para mostrar o conteúdo do sistema de arquivos:

  ```
  cat /opt/ml/metadata/resource-metadata.json
  ```
+ Diretórios de registro: `/var/log/studio` são reservados para os diretórios de suas aplicações e as extensões correspondentes. Recomendamos que você não use essas pastas para criar a imagem.

## Verificação de integridade e URL de aplicações
<a name="studio-updated-byoi-specs-app-healthcheck"></a>

A verificação de integridade e o URL dependem das aplicações. Escolha o link a seguir associado à aplicação para a qual você está criando a imagem.
+ [Verificação de integridade e URL de aplicações](code-editor-custom-images.md#code-editor-custom-images-app-healthcheck) para o Editor de Código
+ [Verificação de integridade e URL de aplicações](studio-updated-jl-admin-guide-custom-images.md#studio-updated-jl-admin-guide-custom-images-app-healthcheck) para JupyterLab

## Exemplos de Dockerfile
<a name="studio-updated-byoi-specs-dockerfile-templates"></a>

Para ver exemplos de Dockerfile que atendam aos requisitos nesta página e às necessidades específicas de sua aplicação, acesse os exemplos de Dockerfile na seção da respectiva aplicação. As opções a seguir incluem aplicativos do Amazon SageMaker Studio. 
+ [Exemplos de Dockerfile](code-editor-custom-images.md#code-editor-custom-images-dockerfile-templates) para o Editor de Código
+ [Exemplos de Dockerfile](studio-updated-jl-admin-guide-custom-images.md#studio-updated-jl-custom-images-dockerfile-templates)para JupyterLab

**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 no Guia do](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) *usuário do Amazon SageMaker Unified Studio*.