사용자 지정 이미지 - Amazon SageMaker AI
애플리케이션의 상태 확인 및 URLDockerfile 예시

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

사용자 지정 이미지

SageMaker 배포에서 제공하는 것과 다른 기능이 필요한 경우 사용자 지정 확장 및 패키지와 함께 자체 이미지를 가져올 수 있습니다. 또한 이를 사용하여 자체 브랜딩 또는 규정 준수 요구 사항에 맞게 코드 편집기 UI를 개인화할 수 있습니다.

다음 페이지에서는 사용자 지정 SageMaker AI 이미지를 생성하기 위한 Code Editor 관련 정보와 템플릿을 제공합니다. 이는 자체 SageMaker AI 이미지를 생성하고 자체 이미지를 Studio에 가져오는 방법에 대한 Amazon SageMaker Studio 정보와 지침을 보완하기 위한 것입니다. 사용자 지정 Amazon SageMaker AI 이미지와 Studio로 자체 이미지를 가져오는 방법에 대한 자세한 내용은 기존 보유 이미지 사용(BYOI) 섹션을 참조하세요.

애플리케이션의 상태 확인 및 URL

  • Base URL – BYOI 애플리케이션의 기본 URL은 CodeEditor/default여야 합니다. 애플리케이션은 하나만 가질 수 있으며 항상 이름이 default여야 합니다.

  • 상태 확인 엔드포인트 - SageMaker AI가 감지하려면 Code Editor 서버를 0.0.0.0 포트 8888에서 호스팅해야 합니다.

  • 인증 - SageMaker AI가 사용자를 인증할 수 있도록 sagemaker-code-editor를 열 때 --without-connection-token을 전달해야 합니다.

참고

Amazon SageMaker Distribution을 기본 이미지로 사용하는 경우 이러한 요구 사항은 이미 포함된 entrypoint-code-editor 스크립트의 일부로 처리됩니다.

Dockerfile 예시

다음 예시는 위 정보와 사용자 지정 이미지 사양을 충족하는 Dockerfile입니다.

참고

자체 이미지를 SageMaker Unified Studio에 가져오는 경우 Amazon SageMaker Unified Studio 사용 설명서의 Dockerfile specifications을 따라야 합니다.

SageMaker Unified Studio의 Dockerfile 예시는 Amazon SageMaker Unified Studio 사용 설명서의 Dockerfile example에서 확인할 수 있습니다.

Example micromamba Dockerfile

다음은 micromamba 기본 환경을 사용하여 처음부터 이미지를 생성하는 Dockerfile의 예입니다.

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

다음은 Amazon SageMaker AI 배포를 기반으로 이미지를 생성하는 Dockerfile의 예입니다.

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