View a markdown version of this page

Spécifications d’images personnalisées de RStudio - Amazon SageMaker AI
Exigences pour RStudio PBCExigences relatives à Amazon SageMaker Studio Classic

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Spécifications d’images personnalisées de RStudio

Dans ce guide, vous découvrirez les spécifications d’image personnalisées de RStudio à utiliser lorsque vous apportez votre propre image. Vous devez satisfaire à deux ensembles d'exigences avec votre image RStudio personnalisée pour pouvoir l'utiliser avec Amazon SageMaker AI. Ces exigences sont imposées par RStudio PBC et la plateforme Amazon SageMaker Studio Classic. Si l’un de ces ensembles d’exigences n’est pas satisfait, votre image personnalisée ne fonctionnera pas correctement.

Exigences pour RStudio PBC

Les exigences de RStudio PBC sont définies dans l'article Utilisation d'images Docker avec RStudio Workbench/RStudio Server Pro, Launcher et Kubernetes. Suivez les instructions de cet article pour créer la base de votre image personnalisée de RStudio.

Pour obtenir des instructions sur la façon d’installer plusieurs versions R dans votre image personnalisée, consultez Installation de plusieurs versions de R sous Linux.

Exigences relatives à Amazon SageMaker Studio Classic

Amazon SageMaker Studio Classic impose les exigences d'installation suivantes pour votre image RStudio.

  • Vous devez utiliser une image de base RStudio d’au moins 2025.05.1+513.pro3. Pour de plus amples informations, veuillez consulter Gestion des versions RStudio.

  • Vous pouvez installer les packages suivants :

    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'

  • Vous devez fournir des valeurs par défaut pour les valeurs d'environnement RSTUDIO_CONNECT_URL et 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

Les spécifications suivantes s'appliquent à l'image représentée par une version d'image SageMaker.

Exécution de l’image

Les instructions de ENTRYPOINT et CMD sont remplacées afin que l'image soit exécutée en tant qu'application RSession.

Arrêt de l’image

L'API DeleteApp émet l'équivalent d'une commande docker stop. Les autres processus du conteneur ne recevront pas les SIGKILL/SIGTERM signaux.

Système de fichiers

Les répertoires /opt/.sagemakerinternal et /opt/ml sont réservés. Les données de ces répertoires peuvent ne pas être visibles lors de l'exécution.

Données de l’utilisateur

Chaque utilisateur d'un domaine SageMaker AI obtient un répertoire utilisateur sur un volume Amazon Elastic File System partagé dans l'image. L’emplacement du répertoire de l’utilisateur actuel sur le volume Amazon EFS est /home/sagemaker-user.

Métadonnées

Un fichier de métadonnées se trouve à l'emplacement suivant : /opt/ml/metadata/resource-metadata.json. Aucune variable d'environnement supplémentaire n'est ajoutée aux variables définies dans l'image. Pour de plus amples informations, veuillez consulter Obtenir les métadonnées de l’application.

GPU

Sur une instance GPU, l’image est exécutée avec l’option --gpus. Seule la boîte à outils CUDA doit être incluse dans l'image et non les pilotes NVIDIA. Pour plus d’informations, consultez le Guide de l’utilisateur NVIDIA.

Métriques et journalisation

Les journaux du processus RSession sont envoyés à Amazon CloudWatch dans le compte du client. Le nom du groupe de journaux est /aws/sagemaker/studio. Le nom du flux de journaux est $domainID/$userProfileName/RSession/$appName.

Taille de l’image

La taille de l'image est limitée à 25 Go. Pour afficher la taille de votre image, exécutez docker image ls.