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

# 사용자 지정 RStudio 이미지 사양
<a name="rstudio-byoi-specs"></a>

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

## RStudio PBC 요구 사항
<a name="rstudio-byoi-specs-rstudio"></a>

RStudio PBC 요구 사항은 [RStudio Workbench / RStudio Server Pro, Launcher, Kubernetes에서 도커 이미지 사용하기](https://support.rstudio.com/hc/en-us/articles/360019253393-Using-Docker-images-with-RStudio-Server-Pro-Launcher-and-Kubernetes) 문서에 나와 있습니다. 이 문서의 지침에 따라 사용자 지정 RStudio 이미지의 기반을 만드세요.

사용자 지정 이미지에 여러 R 버전을 설치하는 방법에 대한 지침은 [Linux에 여러 버전의 R 설치하기](https://support.rstudio.com/hc/en-us/articles/215488098)를 참고하세요.

## Amazon SageMaker Studio Classic 요구 사항
<a name="rstudio-byoi-specs-studio"></a>

Amazon SageMaker Studio Classic을 사용하려면 RStudio 이미지에 대해 다음과 같은 설치 요구 사항을 충족해야 합니다.
+ 먼저 최소한 `2025.05.1+513.pro3`의 RStudio 기본 이미지를 사용해야 합니다. 자세한 내용은 [RStudio 버전 관리](rstudio-version.md) 섹션을 참조하세요.
+ 먼저 다음과 같은 패키지를 설치해야 합니다.

  ```
  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`에 있습니다. 이미지에 정의된 변수에는 추가 환경 변수가 추가되지 않습니다. 자세한 내용은 [앱 메타데이터 가져오기](notebooks-run-and-manage-metadata.md#notebooks-run-and-manage-metadata-app) 섹션을 참조하세요.

**GPU**  
GPU 인스턴스에서는 이미지가 `--gpus` 옵션과 함께 실행됩니다. 이미지에는 CUDA 툴킷만 포함되어야 하며 NVIDIA 드라이버는 포함해서는 안 됩니다. 자세한 내용은 [NVIDIA 사용 설명서](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/user-guide.html)를 참고하세요.

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

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