RStudio のバージョンをアップグレードする - Amazon SageMaker

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

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

重要

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

AWS Amazon の マネージドポリシー SageMaker SageMaker リソースを作成する権限を付与するものには、リソースの作成時にタグを追加する権限が既に含まれています。

このガイドでは、RStudio 2023.03.2-547.pro5 のバージョンアップデートに関する情報を提供します。 SageMaker2024 年 2 月 27 日から、RStudio をサポートする新しいドメインがバージョンとともに作成されます。Posit Workbench 2023.03.2-547.pro5これは RStudioServerPro アプリケーションとデフォルトの RSessionGateway アプリケーションに適用されます。

以下のセクションでは、リリースに関する情報を提供します。2023.03.2-547.pro5

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

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

  • ジョブランチャーで起動され、すぐには使用できない RSession に参加すると断続的に発生する RSserver のクラッシュが修正されました。

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

  • RTools 4.3 のサポートの追加

  • R 4.3 のサポートの追加

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

  • セッション管理の向上

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

注記

次の警告が表示される場合は、RSessionと on で使用されているバージョンとの間にバージョンが一致していません。Posit Workbench RStudio SageMakerこの問題を解決するには、ドメインの RStudio バージョンを更新してください。RStudio バージョンの更新については、を参照してください。新しいバージョンにアップグレードするこの警告にもかかわらず、2023.03.2-547.pro52023.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 アプリケーションの現在のバージョンと一致します。

次の表に、 AWS リージョンリージョンに対する両方のバージョンのイメージ ARN を示します。これらの ARN は 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.pro22023.03.2-547.pro5Posit Workbenchドメインを更新してデフォルトバージョンとして設定します。次の update-domain コマンドの SageMakerImageArn 値は、RStudio の 2023.03.2-547.pro5 バージョンをデフォルトとして指定しています。この ARN は、ドメインが存在する Region と一致している必要があります。すべての使用可能な ARN のリストについては、「バージョニング」を参照してください。

    ドメインを更新するアクセス権限を提供するドメインの実行ロール 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. Region の対応する 2022.02.2-485.pro2 ARN を update-domain コマンドの一部として渡します。すべての使用可能な ARN のリストについては、「バージョニング」を参照してください。ドメインを更新するアクセス権限を提供するドメインの実行ロール 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 イメージへ変更する

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

のはRSW_VERSION、RStudio Dockerfile Posit Workbench 以降で使用されているバージョンと一致している必要があります。 SageMakerPosit 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と on Posit Workbench RStudio で使用されているバージョンとの間にバージョンが一致していません。 SageMakerこの警告にもかかわらず、2023.03.2-547.pro52023.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.