升级 RStudio 版本 - Amazon SageMaker
最新版本更新版本控制升级到新版本降级到现有版本对 BYOI 映像的更改
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

升级 RStudio 版本

重要

允许 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 创建亚马逊 SageMaker资源的自定义 IAM 策略还必须授予向这些资源添加标签的权限。需要向资源添加标签的权限，因为 Studio 和 Studio Classic 会自动标记他们创建的任何资源。如果 IAM 策略允许 Studio 和 Studio Classic 创建资源但不允许标记，则在尝试创建资源时可能会出现 AccessDenied “” 错误。有关更多信息，请参阅 提供为资源添加标签 SageMaker的权限。

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 崩溃的问题，该RSession是通过任务启动器启动的，但无法立即使用。

最新的 RStudio 版本是 2023.03.2-454.pro2。此版本包含以下更改：

  • 添加了 RTools 4.3 支持

  • 增加了对 R 4.3 的支持

  • 已将 Quarto 升级到 1.2.335

  • 改进了会话管理

有关此版本中更改的更多信息，请参阅https://docs.posit.co/ide/news/。

注意

如果您看到以下警告，则表示版本与 RStudio on SageMaker 中使用的Posit Workbench版本不匹配。RSession要解决此问题，请更新该域的 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支持两个版本 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 应用程序的当前版本相匹配。

下表列出了各个 Amazon Web Services 区域的两个版本的映像 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可以通过以下两种方式之一升级到2023.03.2-547.pro5版本：

  • 在启用 RStudio 的情况下从中创建一个新域。 Amazon 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，请更新该域名以设置2023.03.2-547.pro5为默认Posit 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. 在 update-domain 命令中传递您的 Region 相应的 2022.02.2-485.pro2 ARN。有关所有可用的 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 版本并重新部署现有的 RSession。如果在使用 2023.03.2-547.pro5 版本的域的 RSession 中，您尝试加载不兼容的映像，则 RSession 会失败，因为它无法解析收到的参数。为防止失败，请更新现有 RStudioServerPro 应用程序中所有已部署的自定义映像。

RSW_VERSION中的Dockerfile必须与 rStudio 上 SageMaker使用的Posit Workbench版本一致。您可以在 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
注意

如果您看到以下警告，则表示版本与 RStudio on SageMaker 中使用的Posit Workbench版本不匹配。RSW_VERSION尽管有此警告，但版本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.