Especificaciones de Dockerfile

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

Ejecutar la imagen

• Entrypoint— Recomendamos incrustar el punto de entrada en la imagen siguiendo las Docker CMD instrucciones o. Entrypoint También puede configurarlos ContainerEntrypoint y ContainerArguments pasarlos al contenedor en tiempo de ejecución. Para obtener más información, consulte CodeEditorAppImageConfig.

• EnvVariables— Con Studio, puede configurar ContainerEnvironment las variables que están disponibles en un contenedor. La variable de entorno se sobrescribe con las variables de entorno de SageMaker. Para proporcionarle una mejor experiencia, las variables de entorno suelen ser AWS_ y dar prioridad SageMaker_namespaced a los entornos de plataforma.

  Las siguientes son las variables de entorno:

  • AWS_REGION

  • AWS_DEFAULT_REGION

  • AWS_CONTAINER_CREDENTIALS_RELATIVE_URI

  • SAGEMAKER_SPACE_NAME

Especificaciones para el usuario y el sistema de archivos

• WorkingDirectory— El EBS volumen de Amazon para tu espacio está montado en la ruta/home/sagemaker-user. No puedes cambiar la ruta de montaje. Usa las WORKDIR instrucciones para establecer el directorio de trabajo de tu imagen en una carpeta interna/home/sagemaker-user.

• UID— El seudónimo del Docker contenedor. UID=1000 es un valor admitido. Puede añadir el acceso sudo a sus usuarios. IDsSe han reasignado para evitar que un proceso que se ejecuta en el contenedor tenga más privilegios de los necesarios.

• GID— El ID de grupo del Docker contenedor. GID=100 es un valor admitido. Puede añadir el acceso sudo a sus usuarios. IDsSe han reasignado para evitar que un proceso que se ejecuta 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 /opt/ml contiene metadatos sobre recursos comoDomainId.

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

  cat /opt/ml/metadata/resource-metadata.json
  {"AppType":"CodeEditor","DomainId":"example-domain-id","UserProfileName":"example-user-profile-name,"ResourceArn":"arn:aws:sagemaker:Región de AWS:111122223333;:app/domain-ID/user-ID/CodeEditor/default","ResourceName":"default","AppImageVersion":"current"}                             

• Directorios de registro: /var/log/studio están reservados para los directorios de registro de Code Editor y las extensiones asociadas a él. Se recomienda no utilizar las carpetas al crear la imagen.

Health Check y URL para aplicaciones

• Base URL— La base URL de la BYOI solicitud debe sercodeeditor/default. Solo puede tener una aplicación y siempre debe tener un nombredefault.

• Health Check Endpoint: debe alojar su servidor de editor de código en el puerto 0.0.0.0 8888 SageMaker para detectarlo.

• Autenticación: debes pasarlo --without-connection-token al abrirlo sagemaker-code-editor para poder autenticar SageMaker a tus usuarios.

nota

Si utilizas Amazon SageMaker Distribution como imagen base, estos requisitos ya están incluidos en el entrypoint-code-editor guion incluido.

Ejemplos de Dockerfile

El siguiente es un ejemplo de Dockerfile que cumple con las especificaciones enumeradas en las secciones anteriores para crear una imagen desde cero utilizando un entorno base: micromamba

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"        

El siguiente es un ejemplo de Dockerfile que cumple con las especificaciones enumeradas en las secciones anteriores para crear una imagen basada en Amazon SageMaker 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"]