Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Especificaciones de imágenes personalizadas
<a name="studio-updated-byoi-specs"></a>

La imagen que especifique en su Dockerfile debe coincidir con las especificaciones de las siguientes secciones para crear la imagen correctamente.

**Topics**
+ [Ejecutar la imagen](#studio-updated-byoi-specs-run)
+ [Especificaciones para el usuario y el sistema de archivos](#studio-updated-byoi-specs-user-and-filesystem)
+ [Comprobación de estado y URL de las aplicaciones](#studio-updated-byoi-specs-app-healthcheck)
+ [Ejemplos de Dockerfile](#studio-updated-byoi-specs-dockerfile-templates)

## Ejecutar la imagen
<a name="studio-updated-byoi-specs-run"></a>

Puede realizar las siguientes configuraciones actualizando su [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html). Para ver un ejemplo, consulta [Actualización de la configuración de un contenedor](studio-updated-byoi-how-to-container-configuration.md).
+ `Entrypoint`: puede configurar `ContainerEntrypoint` y `ContainerArguments` que se pasan al contenedor en el tiempo de ejecución. Le recomendamos configurar su punto de entrada con `ContainerConfig`. Consulte el enlace anterior para ver un ejemplo.
+ `EnvVariables`: al usar Studio, puede definir variables de `ContainerEnvironment` personalizadas para su contenedor. Si lo desea, puede actualizar sus variables de entorno con `ContainerConfig`. Consulte el enlace anterior para ver un ejemplo.

  SageMaker Las variables de entorno específicas de la IA tienen prioridad y anularán cualquier variable con el mismo nombre. Por ejemplo, la SageMaker IA proporciona automáticamente las variables de entorno con el prefijo `AWS_` y `SAGEMAKER_` para garantizar una integración adecuada con los servicios y la funcionalidad de la IA. AWS SageMaker A continuación se muestran algunos ejemplos de variables de entorno SageMaker específicas de la IA:
  + `AWS_ACCOUNT_ID`
  + `AWS_REGION`
  + `AWS_DEFAULT_REGION`
  + `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI`
  + `SAGEMAKER_SPACE_NAME`
  + `SAGEMAKER_APP_TYPE`

## Especificaciones para el usuario y el sistema de archivos
<a name="studio-updated-byoi-specs-user-and-filesystem"></a>
+ `WorkingDirectory`: el volumen de Amazon EBS de su espacio está montado en la ruta `/home/sagemaker-user`. No puede cambiar la ruta de montaje. Utilice la instrucción `WORKDIR` para establecer el directorio de trabajo de la imagen en una carpeta dentro de `/home/sagemaker-user`.
+ `UID`: ID del usuario del contenedor de Docker. UID=1000 es un valor admitido. Puede agregar acceso a sudo a sus usuarios. IDs Se han reasignado para evitar que un proceso que se ejecuta en el contenedor tenga más privilegios de los necesarios.
+ `GID`: ID del grupo del contenedor de Docker. GID=100 es un valor admitido. Puede agregar acceso a sudo a sus usuarios. IDs Se han reasignado para evitar que un proceso que se ejecute en el contenedor tenga más privilegios de los necesarios.
+ Directorios de metadatos: los `/opt/ml` directorios `/opt/.sagemakerinternal` y que utiliza. AWS El archivo de metadatos de `/opt/ml` contiene metadatos sobre recursos como `DomainId`.

  Utilice el siguiente comando para mostrar el contenido del sistema de archivos:

  ```
  cat /opt/ml/metadata/resource-metadata.json
  ```
+ Directorios de registro: `/var/log/studio` están reservados para los directorios de registro de sus aplicaciones y las extensiones asociadas. Le recomendamos que no utilice estas carpetas para crear la imagen.

## Comprobación de estado y URL de las aplicaciones
<a name="studio-updated-byoi-specs-app-healthcheck"></a>

La comprobación de estado y las URL dependen de las aplicaciones. Elija el siguiente enlace asociado a la aplicación para la que está creando la imagen.
+ [Comprobación de estado y URL de las aplicaciones](code-editor-custom-images.md#code-editor-custom-images-app-healthcheck) para Editor de código
+ [Comprobación de estado y URL de las aplicaciones](studio-updated-jl-admin-guide-custom-images.md#studio-updated-jl-admin-guide-custom-images-app-healthcheck) para JupyterLab

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

Para ver ejemplos de Dockerfile que cumplan tanto los requisitos de esta página como las necesidades específicas de su aplicación, navegue hasta los Dockerfiles de muestra en la sección de la aplicación correspondiente. Las siguientes opciones incluyen las aplicaciones de Amazon SageMaker Studio. 
+ [Ejemplos de Dockerfile](code-editor-custom-images.md#code-editor-custom-images-dockerfile-templates) para Editor de código
+ [Ejemplos de Dockerfile](studio-updated-jl-admin-guide-custom-images.md#studio-updated-jl-custom-images-dockerfile-templates)para JupyterLab

**nota**  
Si va a traer su propia imagen a SageMaker Unified Studio, tendrá que seguir las [especificaciones de Dockerfile](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) de la Guía del *usuario de Amazon SageMaker Unified Studio*.  
`Dockerfile`Puedes encontrar ejemplos de SageMaker Unified Studio en el [ejemplo de Dockerfile](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) de la Guía del *usuario de Amazon SageMaker Unified Studio*.