View a markdown version of this page

사용자 지정 RStudio 이미지 사양 - Amazon SageMaker AI
RStudio PBC 요구 사항Amazon SageMaker Studio Classic 요구 사항

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

사용자 지정 RStudio 이미지 사양

이 설명서에서는 사용자 고유 이미지를 가져올 때 사용할 사용자 지정 RStudio 이미지 사양에 대해 알려드립니다. Amazon SageMaker AI에서 사용자 지정 RStudio 이미지를 사용하려면 먼저 두 가지 요구 사항을 충족해야 합니다. 이러한 요구 사항은 RStudio PBC와 Amazon SageMaker Studio Classic 플랫폼에서 부과합니다. 이러한 요구 사항 중 하나라도 충족되지 않으면 사용자 지정 이미지가 제대로 작동하지 않습니다.

RStudio PBC 요구 사항

RStudio PBC 요구 사항은 RStudio Workbench / RStudio Server Pro, Launcher, Kubernetes에서 도커 이미지 사용하기 문서에 나와 있습니다. 이 문서의 지침에 따라 사용자 지정 RStudio 이미지의 기반을 만드세요.

사용자 지정 이미지에 여러 R 버전을 설치하는 방법에 대한 지침은 Linux에 여러 버전의 R 설치하기를 참고하세요.

Amazon SageMaker Studio Classic 요구 사항

Amazon SageMaker Studio Classic을 사용하려면 RStudio 이미지에 대해 다음과 같은 설치 요구 사항을 충족해야 합니다.

  • 먼저 최소한 2025.05.1+513.pro3의 RStudio 기본 이미지를 사용해야 합니다. 자세한 내용은 RStudio 버전 관리 섹션을 참조하세요.

  • 먼저 다음과 같은 패키지를 설치해야 합니다.

    yum install -y sudo \
openjdk-11-jdk \
libpng-dev \
&& yum clean all \
&& /opt/R/${R_VERSION}/bin/R -e "install.packages('reticulate', repos='https://packagemanager.rstudio.com/cran/__linux__/centos7/latest')" \
&& /opt/python/${PYTHON_VERSION}/bin/pip install --upgrade \
    'boto3>1.0<2.0' \
    'awscli>1.0<2.0' \
    'sagemaker[local]<3'

  • 먼저 RSTUDIO_CONNECT_URL 및 RSTUDIO_PACKAGE_MANAGER_URL 환경 값의 기본값을 제공해야 합니다.

    ENV RSTUDIO_CONNECT_URL "YOUR_CONNECT_URL"
ENV RSTUDIO_PACKAGE_MANAGER_URL "YOUR_PACKAGE_MANAGER_URL"
ENV RSTUDIO_FORCE_NON_ZERO_EXIT_CODE 1

RStudio 이미지 버전으로 표시되는 이미지에는 다음과 같은 일반 사양이 적용됩니다.

이미지 실행

이미지가 RSession 애플리케이션으로 실행되도록 ENTRYPOINT 및 CMD 지침이 오버라이딩됩니다.

이미지 중지

DeleteApp API는 docker stop명령에 해당하는 것을 발행합니다. 컨테이너의 다른 프로세스는 SIGKILL/SIGTERM 신호를 받지 못합니다.

파일 시스템

/opt/.sagemakerinternal 및 /opt/ml디렉터리는 예약되어 있습니다. 이러한 디렉터리의 모든 데이터는 런타임에 표시되지 않을 수 있습니다.

사용자 데이터

SageMaker AI 도메인의 각 사용자는 이미지의 공유 Amazon Elastic File System 볼륨에 있는 사용자 디렉터리를 받습니다. Amazon Elastic File System 볼륨의 현재 사용자 디렉터리 위치는 /home/sagemaker-user입니다.

메타데이터

메타데이터 파일은 /opt/ml/metadata/resource-metadata.json에 있습니다. 이미지에 정의된 변수에는 추가 환경 변수가 추가되지 않습니다. 자세한 내용은 앱 메타데이터 가져오기 섹션을 참조하세요.

GPU

GPU 인스턴스에서는 이미지가 --gpus 옵션과 함께 실행됩니다. 이미지에는 CUDA 툴킷만 포함되어야 하며 NVIDIA 드라이버는 포함해서는 안 됩니다. 자세한 내용은 NVIDIA 사용 설명서를 참고하세요.

지표 및 로깅

RSession 프로세스의 로그는 고객 계정의 Amazon CloudWatch로 전송됩니다. 로그 그룹의 이름은 /aws/sagemaker/studio입니다. 로그 스트림의 이름은 $domainID/$userProfileName/RSession/$appName입니다.

이미지 크기

이미지 크기는 25GB로 제한됩니다. 이미지 크기를 보려면 docker image ls를 실행하세요.