RStudio バージョンのアップグレード - Amazon SageMaker
最新バージョンのアップデートバージョニング新しいバージョンにアップグレードする既存のバージョンにダウングレードするBYOI イメージの変更

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

RStudio バージョンのアップグレード

重要

Amazon SageMaker Studio または Amazon SageMaker Studio Classic が Amazon SageMaker リソースを作成できるようにするカスタムIAMポリシーでは、それらのリソースにタグを追加するアクセス許可も付与する必要があります。Studio と Studio Classic は、作成したリソースに自動的にタグ付けするため、リソースにタグを追加するアクセス許可が必要です。IAM ポリシーで Studio と Studio Classic がリソースを作成することを許可されているが、タグ付けが許可されていない場合、リソースを作成しようとするとAccessDenied「」エラーが発生する可能性があります。詳細については、「リソースにタグ付けするための SageMakerアクセス許可を提供する」を参照してください。

AWS Amazon の マネージドポリシー SageMaker SageMaker リソースを作成するアクセス許可を付与する には、それらのリソースの作成中にタグを追加するアクセス許可が既に含まれています。

このガイドでは、 の RStudio 2023.03.2-547.pro5のバージョン更新について説明します SageMaker。2024 年 2 月 27 日以降、 RStudio をサポートする新しいドメインがPosit Workbenchバージョン で作成されます2023.03.2-547.pro5。これは RStudioServerPro アプリケーションとデフォルトの RSessionGateway アプリケーションに適用されます。

以下のセクションでは、 2023.03.2-547.pro5リリースについて説明します。

最新バージョンのアップデート

パッチバージョンの2023.03.2-547.pro5リリースには、次の変更が含まれています。

  • ジョブランチャーで開始RSessionされ、すぐには利用できない に参加したときの断続的なRServerクラッシュを修正しました。

RStudio 最新バージョンは です2023.03.2-454.pro2。このバージョンには、次の変更が含まれています。

  • RTools 4.3 のサポートの追加

  • R 4.3 のサポートの追加

  • Quarto の 1.2.335 へのアップグレード

  • セッション管理の向上

このリリースでの変更については、「https://docs.posit.co/ide/news/」を参照してください。

注記

次の警告が表示された場合、 RSessionと の RStudioで使用されているバージョンの間には、Posit Workbenchバージョンが一致しません SageMaker。この問題を解決するには、ドメインRStudioのバージョンを更新します。RStudio バージョンの更新については、「」を参照してください新しいバージョンにアップグレードする。この警告にもかかわらず、 バージョン2023.03.2-547.pro5と 2023.03.2-454.pro2は互換性のあるイメージです。

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.

バージョニング

現在、 でPosit Workbenchサポートされている のバージョンは 2 つあります SageMaker。

  • サポートされている最新のバージョン: 2023.03.2-547.pro5

  • サポートされている以前のバージョン: 2022.02.2-485.pro2

によって選択されるデフォルトPosit Workbenchバージョンは、ドメインの作成日 SageMaker によって異なります。

  • 2024 年 2 月 27 日以降に作成されたドメインの場合、バージョン 2023.03.2-547.pro5はデフォルトで選択されたバージョンです。

  • 2023 年 6 月 27 日以降、2024 年 2 月 27 日より前に作成されたドメインの場合、 バージョン2023.03.2-454.pro2がデフォルトの選択バージョンになります。ドメインのデフォルトのバージョンとして設定することにより、ドメインを最新バージョン (2023.03.2-547.pro5) に更新できます。詳細については、「新しいバージョンにアップグレードする」を参照してください。

  • 2023 年 6 月 27 日より前に作成されたドメインの場合、 バージョン2022.02.2-485.pro2がデフォルトで選択されたバージョンです。ドメインのデフォルトのバージョンとして設定することにより、ドメインを最新バージョン (2023.03.2-547.pro5) に更新できます。詳細については、「新しいバージョンにアップグレードする」を参照してください。

注記

RSessionGateway アプリケーションのデフォルトのバージョンは、RStudioServerPro アプリケーションの現在のバージョンと一致します。

次の表に、各 ARNsの両バージョンのイメージを示します AWS リージョン。これらはARNs、目的のバージョンを設定するupdate-domainコマンドの一部として渡されます。

Region 2022.02.2-485.pro2 イメージ ARN 2023.03.2-547.pro5 イメージ ARN
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

新しいバージョンにアップグレードする

バージョン 2022.02.2-485.pro2または を使用する既存のドメイン2023.03.2-454.pro2は、次の 2 つの方法のいずれかで2023.03.2-547.pro5バージョンにアップグレードできます。

  • RStudio を有効に AWS CLI して から新しいドメインを作成します。

  • 2023.03.2-547.pro5 バージョンを使用するように既存のドメインを更新する。

次の手順は、既存のドメインのRStudioアプリケーションを削除し、デフォルトバージョンを に設定してから2023.03.2-547.pro5、RStudioアプリケーションを作成する方法を示しています。

  1. RStudioServerPro アプリケーションと、既存のドメインに関連付けられているすべての RSessionGateway アプリケーションを削除します。ドメイン ID を検索する方法の詳細については、「ドメインの表示」を参照してください。アプリケーションの削除の詳細については、「RStudio をシャットダウンして再起動する」をご参照ください。

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

  2. ドメインがRStudioバージョン を使用している場合は2022.02.2-485.pro2、ドメインを更新してデフォルトPosit Workbenchバージョン2023.03.2-547.pro5として を設定します。次のupdate-domainコマンドのSageMakerImageArn値は、RStudio2023.03.2-547.pro5バージョンをデフォルトとして指定します。これは、ドメインRegionが存在する と一致するARN必要があります。使用可能なすべての のリストについてはARNs、「」を参照してくださいバージョニング。

    ARN ドメインを更新するアクセス許可を提供するドメインの実行ロールを渡します。

    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. 既存のドメインに新しい RStudioServerPro アプリケーションを作成します。

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

これで RStudioServerPro アプリケーションがバージョン 2023.03.2-547.pro5 に更新されました。RSessionGateway アプリケーションを再起動できます。

既存のバージョンにダウングレードする

既存のRStudioアプリケーションのバージョンを 2022.02.2-485.pro2バージョンに手動でダウングレードできます。

既存のバージョンにダウングレードするには

  1. 既存のドメインに関連付けられている RStudioServerPro アプリケーションを削除します。ドメイン ID を検索する方法の詳細については、「ドメインの表示」を参照してください。

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

  2. update-domain コマンドRegionの一部として、 2022.02.2-485.pro2 ARN に対応する を渡します。使用可能なすべての のリストについてはARNs、「」を参照してくださいバージョニング。また、ARNドメインを更新するアクセス許可を提供するドメインの実行ロールを渡す必要があります。

    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. 既存のドメインに新しい RStudioServerPro アプリケーションを作成します。RStudio バージョンのデフォルトは です2022.02.2-485.pro2。

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

これで RStudioServerPro アプリケーションがバージョン 2022.02.2-485.pro2 にダウングレードされました。

BYOI イメージの変更

でBYOIイメージを使用しRStudio、RStudioServerProバージョンを に更新する場合は2023.03.2-547.pro5、カスタムイメージを2023.03.2-547.pro5アップグレードしてリリースを使用し、既存の を再デプロイする必要がありますRSessions。バージョンを使用してドメインRSessionの に互換性のないイメージをロードしようとすると2023.03.2-547.pro5、受信したパラメータを解析できないため、 はRSession失敗します。失敗を防ぐには、既存の RStudioServerPro アプリケーションにデプロイされているカスタムイメージをすべて更新します。

RSW_VERSION の は、 の RStudioで使用されているPosit Workbenchバージョンと一致するDockerfile必要があります SageMaker。Posit Workbench の現在のバージョンは検証することができます。これを行うには、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
注記

次の警告が表示された場合、 RSW_VERSIONと の RStudioで使用されているバージョンの間には、Posit Workbenchバージョンが一致しません SageMaker。この警告にもかかわらず、バージョン 2023.03.2-547.pro5と 2023.03.2-454.pro2は互換性のあるイメージです。

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.