Especificaciones de imágenes personalizadas - Amazon SageMaker AI
Ejecutar la imagenEspecificaciones para el usuario y el sistema de archivosComprobación de estado y URL de las aplicacionesEjemplos de Dockerfile

Especificaciones de imágenes personalizadas

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

Ejecutar la imagen

Puede realizar las siguientes configuraciones actualizando su ContainerConfig. Para ver un ejemplo, consulta Actualización de la configuración de un contenedor.

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

    Las variables de entorno específicas de SageMaker AI tienen prioridad y anularán cualquier variable con los mismos nombres. Por ejemplo, SageMaker AI proporciona automáticamente variables de entorno con el prefijo AWS_ y SAGEMAKER_ para garantizar una integración adecuada con los servicios de AWS y la funcionalidad de SageMaker AI. A continuación, se muestran algunos ejemplos de variables de entorno específicas de SageMaker AI:

    • 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

  • 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. Los ID 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. Los ID se han reasignado para evitar que un proceso que se ejecuta en el contenedor tenga más privilegios de los necesarios.

  • Directorios de metadatos: los directorios /opt/.sagemakerinternal y /opt/ml 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

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.

Ejemplos de Dockerfile

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.

nota

Si va a incorporar su propia imagen en Estudio unificado de Amazon SageMaker, tendrá que seguir las Dockerfile specifications de la Guía del usuario de Estudio unificado de Amazon SageMaker.

Puede consultar ejemplos de Dockerfile para Estudio unificado de Amazon SageMaker en el Dockerfile example de la Guía del usuario de Estudio unificado de Amazon SageMaker.