本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # RStudio 版本控制 **重要** 允许 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 创建亚马逊 SageMaker资源的自定义 IAM 策略还必须授予向这些资源添加标签的权限。之所以需要为资源添加标签的权限，是因为 Studio 和 Studio Classic 会自动为创建的任何资源添加标签。如果 IAM 策略允许 Studio 和 Studio Classic 创建资源但不允许标记，则在尝试创建资源时可能会出现 AccessDenied “” 错误。有关更多信息，请参阅 [提供标记 A SageMaker I 资源的权限](security_iam_id-based-policy-examples.md#grant-tagging-permissions)。 [AWS 亚马逊 A SageMaker I 的托管策略](security-iam-awsmanpol.md)授予创建 SageMaker 资源的权限已经包括在创建这些资源时添加标签的权限。 本指南提供有关 A SageMaker I `2025.05.1+513.pro3` 版本更 RStudio 新的信息。从 2025 年 10 月 31 日起，将使用Posit Workbench版本创建 RStudio 支持的新域名`2025.05.1+513.pro3`。这适用于 `RStudioServerPro` 应用程序和默认的 `RSessionGateway` 应用程序。 以下各节提供有关该`2025.05.1+513.pro3`版本的信息。 ## 最新版本更新 最新 RStudio 版本是`2025.05.1+513.pro3`。 + 支持的 R 版本： + 4.5.1 + 4.4.3 + 4.4.0 + 4.3.3 + 4.2.3 + 4.2.1 + 4.1.3 + 4.0.2 有关此版本中更改的更多信息，请参阅[https://docs.posit.co/ide/news/](https://docs.posit.co/ide/news/)。 **注意** 为确保兼容性，我们建议使用 RSessions 与当前Posit Workbench版本匹配的前缀。 如果您看到以下警告，则说明与 SageMaker AI RStudio 上使用的Posit Workbench版本之间存在版本不匹配。`RSession`要解决此问题，请更新域的 RStudio版本。有关更新 RStudio 版本的信息，请参阅[升级到新版本](rstudio-version-upgrade.md)。 ``` Session version 2024.04.2+764.pro1 does not match server version 2025.05.1+513.pro3 - this is an unsupported configuration, and you may experience unexpected issues as a result. ``` ## 版本控制 SageMaker AI 目前Posit Workbench支持两个版本。 + 最新版本：`2025.05.1+513.pro3` 弃用日期：2026 年 12 月 5 日 + 之前的版本：`2024.04.2+764.pro1` 弃用日期：2026 年 4 月 30 日 **注意** 虽然您可以在 2026 年 4 月 30 日`2024.04.2+764.pro1`之前继续使用旧版本创建新域名，方法是在使用 CLI 创建域时明确固定该版本，但我们强烈建议客户开始在所有域中使用该版本。`2025.05`POSIT 已停止为其提供漏洞修复。`2024.04.2+764.pro1` 版本`2023.03.2-547.pro5`和`2022.02.2-485.pro2`已过时，不再受支持。我们建议更新到最新版本。 SageMaker AI 选择的默认Posit Workbench版本取决于域的创建日期。 + 对于 2025 年 10 月 31 日之后创建的域名，版本`2025.05.1+513.pro3`为默认选定版本。 + 对于 2024 年 9 月 4 日之后和 2025 年 10 月 31 日之前创建的域名，版本`2024.04.2+764.pro1`为默认选定版本。您可以通过将最新版本 (`2025.05.1+513.pro3`) 设置为域的默认版本，将域更新到此最新版本。有关更多信息，请参阅 [升级到新版本](rstudio-version-upgrade.md)。 **注意** 默认 `RSessionGateway` 应用程序版本与 `RStudioServerPro` 应用程序的当前版本相匹配。 下表列出了两个版本中每个版本的图像 ARNs AWS 区域。 ARNs 它们作为`update-domain`命令的一部分传递，用于设置所需版本。 | Region | `2024.04.2+764.pro1` 映像 ARN | `2025.05.1+513.pro3` 映像 ARN | | --- | --- | --- | | us-east-1 | arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2025.05-sagemaker-1.0 | | us-east-2 | arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2025.05-sagemaker-1.0 | | us-west-1 | arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2025.05-sagemaker-1.0 | | us-west-2 | arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2025.05-sagemaker-1.0 | | af-south-1 | arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2025.05-sagemaker-1.0 | | ap-east-1 | arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2025.05-sagemaker-1.0 | | ap-south-1 | arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2025.05-sagemaker-1.0 | | ap-northeast-2 | arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2025.05-sagemaker-1.0 | | ap-southeast-1 | arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2025.05-sagemaker-1.0 | | ap-southeast-2 | arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2025.05-sagemaker-1.0 | | ap-northeast-1 | arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2025.05-sagemaker-1.0 | | ca-central-1 | arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2025.05-sagemaker-1.0 | | eu-central-1 | arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2025.05-sagemaker-1.0 | | eu-west-1 | arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2025.05-sagemaker-1.0 | | eu-west-2 | arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2025.05-sagemaker-1.0 | | eu-west-3 | arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2025.05-sagemaker-1.0 | | eu-north-1 | arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2025.05-sagemaker-1.0 | | eu-south-1 | arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2025.05-sagemaker-1.0 | | sa-east-1 | arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2025.05-sagemaker-1.0 | ### 对 BYOI 映像的更改 如果您将 BYOI 映像与一起使用 RStudio 并将`RStudioServerPro`版本更新为`2025.05.1+513.pro3`，则必须升级您的自定义映像才能使用该`2025.05.1+513.pro3`版本并重新部署现有镜像。 RSessions如果您尝试使用该`2025.05.1+513.pro3`版本在某个域中加载不兼容 RSession 的图像， RSession 则会失败，因为它无法解析收到的参数。为防止失败，请更新现有 `RStudioServerPro` 应用程序中所有已部署的自定义映像。 `RSW_VERSION`中的Dockerfile必须与 SageMaker AI RStudio 上使用的Posit Workbench版本一致。您可以在 Posit Workbench 中验证当前版本。为此，请使用位于 Posit Workbench 启动器页面左下角的版本名称。 ``` ARG RSW_VERSION=2025.05.1+513.pro3 ENV RSTUDIO_FORCE_NON_ZERO_EXIT_CODE="1" ARG RSW_NAME=rstudio-workbench ARG OS_CODE_NAME=jammy 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 ``` # 升级到新版本 使用 `2024.04.2+764.pro1` 版本的现有域可以通过两种方式之一升级到 `2025.05.1+513.pro3` 版本： + 在 RStudio 启用状态下 AWS CLI 从中创建新域。 + 更新现有域以使用 `2025.05.1+513.pro3` 版本。 以下过程说明如何删除现有域的 RStudio 应用程序，将默认版本设置为`2025.05.1+513.pro3`，然后创建 RStudio 应用程序。 1. 删除 `RStudioServerPro` 应用程序以及与您的现有域关联的所有 `RSessionGateway` 应用程序。有关如何查找域 ID 的信息，请参阅[查看领域](domain-view.md)。有关删除应用程序的更多信息，请参阅[关掉 RStudio](rstudio-shutdown.md)。 ``` aws sagemaker delete-app \ --region region \     --domain-id domainId \     --user-profile-name domain-shared \     --app-type RStudioServerPro \     --app-name default ``` 1. 如果您的域名使用的是 RStudio 版本`2024.04.2+764.pro1`，请更新域名以设置`2025.05.1+513.pro3`为默认Posit Workbench版本。以下`update-domain`命令中的`SageMakerImageArn`值将 RStudio`2025.05.1+513.pro3`版本指定为默认版本。此 ARN 必须与您的域所在的 Region 相匹配。有关所有可用内容的列表 ARNs，请参阅[版本控制](rstudio-version.md#rstudio-version-new)。 传递域的执行角色 ARN，以提供更新域的权限。 ``` aws sagemaker update-domain \ --region region \ --domain-id domainId \ --domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2025.05.1+513.pro3-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}" ``` 1. 在现有域中创建新的 `RStudioServerPro` 应用程序。 ``` aws sagemaker create-app \ --region region     --domain-id domainId \     --user-profile-name domain-shared \     --app-type RStudioServerPro \     --app-name default ``` 您的 `RStudioServerPro` 应用程序现已更新至版本 `2025.05.1+513.pro3`。现在，您可以重新发布 `RSessionGateway` 应用程序。 # 降级到以前的版本 您可以手动将现有 RStudio 应用程序的版本降级到该`2024.04.2+764.pro1`版本。 **降级到先前版本** 1. 删除与您的现有域关联的 `RStudioServerPro` 应用程序。有关如何查找域 ID 的信息，请参阅[查看领域](domain-view.md)。 ``` aws sagemaker delete-app \     --domain-id domainId \     --user-profile-name domain-shared \     --app-type RStudioServerPro \     --app-name default ``` 1. 在 `update-domain` 命令中传递您的 Region 相应的 `2024.04.2+764.pro1` ARN。有关所有可用内容的列表 ARNs，请参阅[版本控制](rstudio-version.md#rstudio-version-new)。您还必须传递域的执行角色 ARN，以提供更新域的权限。 ``` aws sagemaker update-domain \ --region region \ --domain-id domainId \ --domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2024.04.2+764.pro1-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}" ``` 1. 在现有域中创建新的 `RStudioServerPro` 应用程序。 RStudio 版本默认为`2024.04.2+764.pro1`。 ``` aws sagemaker create-app \     --domain-id domainId \     --user-profile-name domain-shared \     --app-type RStudioServerPro \     --app-name default ``` 您的 `RStudioServerPro` 应用程序现已降级至版本 `2024.04.2+764.pro1`。