Mise à jour de la version RStudio - Amazon SageMaker
Dernières mises à jour de versionGestion des versionsMise à niveau de la nouvelle versionRétrogradation vers la version existanteModifications apportées aux images BYOI

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.

Mise à jour de la version RStudio

Important

Les politiques IAM personnalisées qui permettent à Amazon SageMaker Studio ou Amazon SageMaker Studio Classic de créer des SageMaker ressources Amazon doivent également accorder des autorisations pour ajouter des balises à ces ressources. L'autorisation d'ajouter des balises aux ressources est requise car Studio et Studio Classic balisent automatiquement toutes les ressources qu'ils créent. Si une politique IAM autorise Studio et Studio Classic à créer des ressources mais n'autorise pas le balisage, des erreurs « AccessDenied » peuvent se produire lors de la tentative de création de ressources. Pour plus d’informations, consultez Fournir des autorisations pour le balisage des ressources SageMaker.

AWS Politiques gérées pour Amazon SageMakerqui donnent des autorisations pour créer des SageMaker ressources incluent déjà des autorisations pour ajouter des balises lors de la création de ces ressources.

Ce guide fournit des informations sur la mise à jour de 2023.03.2-547.pro5 version de RStudio sur SageMaker. À partir du 27 février 2024, de nouveaux domaines compatibles avec RStudio sont créés avec Posit Workbench la version2023.03.2-547.pro5. Cela s'applique aux applications RStudioServerPro et aux applications RSessionGateway par défaut.

Les sections suivantes fournissent des informations sur cette 2023.03.2-547.pro5 version.

Dernières mises à jour de version

La 2023.03.2-547.pro5 version du correctif inclut les modifications suivantes :

  • Correction d'un crash intermittent de RServer lors de la participation à une RSession démarrée avec le lanceur de tâches et qui n'est pas immédiatement disponible.

La dernière version de RStudio est 2023.03.2-454.pro2. Cette version inclut les modifications suivantes :

  • Prise en charge de RTools 4.3 ajoutée

  • Prise en charge ajoutée pour R 4.3

  • Mise à niveau de Quarto vers 1.2.335

  • Gestion de session améliorée

Pour plus d'informations sur les modifications de cette version, consultez https://docs.posit.co/ide/news/.

Note

Si l'avertissement suivant s'affiche, il existe une incompatibilité de version entre la RSession et la Posit Workbench version utilisée dans RStudio on SageMaker. Pour résoudre ce problème, mettez à jour la version de RStudio pour le domaine. Pour plus d'informations sur la mise à jour de la version de RStudio, consultezMise à niveau de la nouvelle version. Malgré cet avertissement, les versions 2023.03.2-547.pro5 et 2023.03.2-454.pro2 les images sont compatibles.

Session version 2023.03.2+454.pro2 does not match server version 2023.03.3-547.pro5 - this is an unsupported configuration, and you may experience unexpected issues as a result.

Gestion des versions

Il existe actuellement deux versions de Posit Workbench prises en charge par SageMaker.

  • Dernière version prise en charge : 2023.03.2-547.pro5

  • Version précédente prise en charge : 2022.02.2-485.pro2

La Posit Workbench version par défaut sélectionnée par SageMaker dépend de la date de création du domaine.

  • Pour les domaines créés après le 27 février 2024, la version 2023.03.2-547.pro5 est la version sélectionnée par défaut.

  • Pour les domaines créés après le 27 juin 2023 et avant le 27 février 2024, la version 2023.03.2-454.pro2 est la version sélectionnée par défaut. Vous pouvez mettre à jour vos domaines avec la dernière version (2023.03.2-547.pro5) en la définissant comme version par défaut pour le domaine. Pour plus d’informations, consultez Mise à niveau de la nouvelle version.

  • Pour les domaines créés avant le 27 juin 2023, la version 2022.02.2-485.pro2 est la version sélectionnée par défaut. Vous pouvez mettre à jour vos domaines avec la dernière version (2023.03.2-547.pro5) en la définissant comme version par défaut pour le domaine. Pour plus d’informations, consultez Mise à niveau de la nouvelle version.

Note

La version par défaut de l'application RSessionGateway correspond à la version actuelle de l'application RStudioServerPro.

Le tableau suivant répertorie les ARN des images pour les deux versions pour chaque Région AWS. Ces ARN sont transmis dans le cadre d'une commande update-domain visant à définir la version souhaitée.

Region ARN d'image 2022.02.2-485.pro2 ARN d'image 2023.03.2-547.pro5
us-east-1 arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2021.08 arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2023.03
us-east-2 arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2021.08 arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2023.03
us-west-1 arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2021.08 arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2023.03
us-west-2 arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2021.08 arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2023.03
af-south-1 arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2021.08 arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2023.03
ap-east-1 arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2023.03
ap-south-1 arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2023.03
ap-northeast-2 arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2023.03
ap-southeast-1 arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2023.03
ap-southeast-2 arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2023.03
ap-northeast-1 arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2023.03
ca-central-1 arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2023.03
eu-central-1 arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2023.03
eu-west-1 arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2023.03
eu-west-2 arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2023.03
eu-west-3 arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2023.03
eu-north-1 arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2023.03
eu-south-1 arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2023.03
sa-east-1 arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2021.08 arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2023.03

Mise à niveau de la nouvelle version

Les domaines existants utilisent la version 2022.02.2-485.pro2 ou 2023.03.2-454.pro2 peuvent passer à 2023.03.2-547.pro5 la version de l'une des deux manières suivantes :

  • Créez un nouveau domaine à partir du AWS CLI avec RStudio activé.

  • Mettez à jour un domaine existant pour utiliser la version 2023.03.2-547.pro5.

La procédure suivante montre comment supprimer l'application RStudio pour un domaine existant, définir la version par défaut sur 2023.03.2-547.pro5, puis créer une application RStudio.

  1. Supprimez l'application RStudioServerPro et toutes les applications RSessionGateway associées à votre domaine existant. Pour plus d'informations sur la façon de trouver votre ID de domaine, consultez Afficher les domaines. Pour plus d'informations sur la suppression des applications, consultez Arrêter et redémarrer RStudio.

    aws sagemaker delete-app \
    --region region \
    --domain-id domainId \
    --user-profile-name domain-shared \
    --app-type RStudioServerPro \
    --app-name default

  2. Si votre domaine utilise la version RStudio2022.02.2-485.pro2, mettez-le à jour pour le définir 2023.03.2-547.pro5 comme Posit Workbench version par défaut. La valeur SageMakerImageArn de la commande update-domain suivante indique la version 2023.03.2-547.pro5 de RStudio par défaut. Cet ARN doit correspondre à la Region dans laquelle se trouve votre domaine. Pour obtenir la liste des ARN disponibles, consultez Gestion des versions.

    Transmettez un ARN de rôle d'exécution pour le domaine qui fournit les autorisations de mise à jour du domaine. 

    aws sagemaker update-domain \
    --region region \
    --domain-id domainId \
    --domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2023.03.2-547.pro5-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"

  3. Créez une nouvelle application RStudioServerPro dans le domaine existant.

    aws sagemaker create-app \
    --region region
    --domain-id domainId \
    --user-profile-name domain-shared \
    --app-type RStudioServerPro \
    --app-name default

La version de votre application RStudioServerPro est maintenant mise à jour vers 2023.03.2-547.pro5. Vous pouvez désormais relancer vos applications RSessionGateway.

Rétrogradation vers la version existante

Vous pouvez rétrograder manuellement la version de votre application RStudio existante vers la 2022.02.2-485.pro2 version.

Pour rétrograder vers la version existante

  1. Supprimez l'application RStudioServerPro associée à votre domaine existant. Pour plus d'informations sur la façon de trouver votre ID de domaine, consultez Afficher les domaines.

    aws sagemaker delete-app \
    --domain-id domainId \
    --user-profile-name domain-shared \
    --app-type RStudioServerPro \
    --app-name default

  2. Transmettez l'ARN 2022.02.2-485.pro2 correspondant à votre nom pour votre Region dans le cadre de la commande update-domain. Pour obtenir la liste des ARN disponibles, consultez Gestion des versions. Vous devez également transmettre un ARN de rôle d'exécution pour le domaine qui fournit les autorisations de mise à jour du domaine. 

    aws sagemaker update-domain \
    --region region \
    --domain-id domainId \
    --domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2022.02.2+485.pro2-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"

  3. Créez une nouvelle application RStudioServerPro dans le domaine existant. La version par défaut de RStudio est 2022.02.2-485.pro2.

    aws sagemaker create-app \
    --domain-id domainId \
    --user-profile-name domain-shared \
    --app-type RStudioServerPro \
    --app-name default

La version de votre application RStudioServerPro est désormais rétrogradée vers 2022.02.2-485.pro2.

Modifications apportées aux images BYOI

Si vous utilisez une image BYOI avec RStudio et que vous mettez à jour votre version RStudioServerPro vers 2023.03.2-547.pro5, vous devez mettre à niveau vos images personnalisées pour utiliser la version 2023.03.2-547.pro5 et redéployer vos RSessions existantes. Si vous essayez de charger une image non compatible dans une RSession d'un domaine à l'aide de la version 2023.03.2-547.pro5, la RSession échoue car elle ne peut pas analyser les paramètres qu'elle reçoit. Pour éviter tout échec, mettez à jour toutes les images personnalisées déployées dans votre application RStudioServerPro existante.

Le RSW_VERSION in Dockerfile doit être cohérent avec la Posit Workbench version utilisée dans RStudio on SageMaker. Vous pouvez valider la version actuelle dans Posit Workbench. Pour ce faire, utilisez le nom de version situé dans le coin inférieur gauche de la page du lanceur Posit Workbench.

...
ARG RSW_VERSION=2023.03.3-547.pro5
ENV RSTUDIO_FORCE_NON_ZERO_EXIT_CODE="1"
ARG RSW_NAME=rstudio-workbench
ARG OS_CODE_NAME=bionic
ARG RSW_DOWNLOAD_URL=https://s3.amazonaws.com/rstudio-ide-build/server/${OS_CODE_NAME}/amd64
RUN RSW_VERSION_URL=`echo -n "${RSW_VERSION}" | sed 's/+/-/g'` \
    && curl -o rstudio-workbench.deb ${RSW_DOWNLOAD_URL}/${RSW_NAME}-${RSW_VERSION_URL}-amd64.deb \
    && gdebi -n ./rstudio-workbench.deb
Note

Si l'avertissement suivant s'affiche, il existe une incompatibilité de version entre la RSW_VERSION et la Posit Workbench version utilisée dans RStudio on SageMaker. Malgré cet avertissement, les versions 2023.03.2-547.pro5 et 2023.03.2-454.pro2 les images sont compatibles.

Session version 2023.03.2+454.pro2 does not match server version 2023.03.3-547.pro5 - this is an unsupported configuration, and you may experience unexpected issues as a result.