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

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

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

このガイドでは、RStudio on 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 アプリケーションの現在のバージョンと一致します。

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

  • 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 値は、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 on で使用される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.